Skip to main content
GET
/
gbp-insights
curl "https://app.neariq.io/api/v1/gbp-insights?days=30" \
  -H "X-NearIQ-Key: niq_your_key_here"
Returns synced Google Business Profile performance metrics for the API key owner’s active business. Use an API key with the competitors:read scope.
​
X-NearIQ-Key
string
required
Your API key from Settings > API Keys
​
days
number
default:"30"
Number of days to look back. Minimum 7, maximum 90.
curl "https://app.neariq.io/api/v1/gbp-insights?days=30" \
  -H "X-NearIQ-Key: niq_your_key_here"

{
  "connected": true,
  "businessId": "8a18b4f8-7b6a-4b5d-a4cc-0adcbcfcc8e7",
  "locationTitle": "NearIQ Demo Fitness",
  "locationName": "locations/123456789",
  "lastFetchedAt": "2026-04-29T18:00:00.000Z",
  "days": 30,
  "totals": {
    "BUSINESS_IMPRESSIONS_MOBILE_SEARCH": 1200,
    "BUSINESS_DIRECTION_REQUESTS": 83,
    "CALL_CLICKS": 19,
    "WEBSITE_CLICKS": 42
  },
  "series": {
    "WEBSITE_CLICKS": [
      { "date": "2026-04-01", "value": 3 }
    ]
  },
  "keywords": [
    { "keyword": "gym near me", "impressions": 120, "date": "2026-03-01" }
  ],
  "insights": []
}

​
Metrics

NearIQ refreshes connected location metrics daily. Metrics can include Search and Maps impressions, direction requests, call clicks, website clicks, and message conversations. Search keywords are returned separately in keywords. If connected is false, the user has not connected a Google Business Profile for the active business yet. Accounts below Growth receive 403. API keys without competitors:read receive 403 requiredScope.