API Reference

Base URL: https://gmb.sbgeeks.com/api/v1/

Authentication: Authorization: Bearer {your_api_key} — find your key in Dashboard → Settings → API.

GET /api/v1/businesses List all tracked businesses

Returns array of businesses with ID, name, location, GBP URL, and latest health score.

POST /api/v1/businesses Add a new business

Body: { "gbp_url": "...", "keywords": ["pizza near me"] }. Returns new business object.

POST /api/v1/scans Trigger a geo-grid scan

Body: { "business_id": 1, "keyword": "pizza near me", "grid_size": 7, "radius_miles": 0.5 }

GET /api/v1/rankings Fetch scan results

Query: ?business_id=1&keyword=pizza+near+me&limit=10. Returns grid array with lat/lng/rank per pin.

GET /api/v1/history Rank history for a keyword

Query: ?business_id=1&keyword=pizza+near+me&from=2025-01-01&to=2025-05-01

GET /api/v1/competitors List tracked competitors

Returns competitor profiles with their latest geo-grid ranks.

GET /api/v1/ai/insights Get AI recommendations

Returns prioritized action list with estimated rank impact per action.

GET /api/v1/subscription Subscription & credit status

Returns current plan, credits used, credits remaining, and billing cycle.

Webhooks

Configure a webhook URL in Dashboard → Settings → Webhooks. We'll POST a JSON payload to your URL when rank changes occur. Events: rank.changed, scan.completed, alert.triggered. All requests include an X-LocalRankPro-Signature header for verification.