Geogrid Rank Scan

Map local pack rankings across a geographic grid centered on a location. Returns a rank matrix showing where a business ranks from each grid point, plus an Average Grid Rank (AGR) score. Supports 5x5, 7x7, and 9x9 grids.

POST/v1/geogrid/scan

Cost: 5 credits (5x5), 10 credits (7x7), 18 credits (9x9)

Rate Limit: Varies by plan

Response: ~8-20 seconds depending on grid size

Parameters

Parameter	Type	Required	Description
business	string	Yes	Business name to track
location	string	Yes	Center point — city/state or lat,lng (e.g. "Brooklyn, NY")
keyword	string	Yes	Search keyword (e.g. "pizza")
grid_size	string	No	"5x5", "7x7", or "9x9". Default: "5x5"
radius_miles	number	No	Radius in miles. Default: 3

Example Request

curl -X POST https://api.localseodata.com/v1/geogrid/scan \
  -H "Authorization: Bearer sk_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "business": "Joe'\''s Pizza",
    "location": "Brooklyn, NY",
    "keyword": "pizza",
    "grid_size": "5x5",
    "radius_miles": 3
  }'

Example Response

JSON

{
  "status": "success",
  "credits_used": 5,
  "data": {
    "business": "Joe's Pizza",
    "keyword": "pizza",
    "grid_size": "5x5",
    "radius_miles": 3,
    "center": { "lat": 40.6892, "lng": -73.9857 },
    "average_grid_rank": 3.2,
    "grid": [
      [
        { "lat": 40.710, "lng": -74.006, "rank": 4 },
        { "lat": 40.710, "lng": -73.996, "rank": 2 },
        { "lat": 40.710, "lng": -73.986, "rank": 1 },
        { "lat": 40.710, "lng": -73.976, "rank": 3 },
        { "lat": 40.710, "lng": -73.966, "rank": 5 }
      ],
      [
        { "lat": 40.700, "lng": -74.006, "rank": 3 },
        { "lat": 40.700, "lng": -73.996, "rank": 1 },
        { "lat": 40.700, "lng": -73.986, "rank": 1 },
        { "lat": 40.700, "lng": -73.976, "rank": 2 },
        { "lat": 40.700, "lng": -73.966, "rank": 4 }
      ]
    ],
    "vs_previous": null
  }
}

Response Fields

Field	Type	Description
average_grid_rank	float	Average rank across all grid points (lower is better)
grid	array[][]	2D array of grid points with lat, lng, and rank
grid_size	string	Grid dimensions ("5x5", "7x7", "9x9")
center	object	Center point lat/lng of the grid
vs_previous	object \| null	Delta vs previous scan if business_id is provided

Notes

5x5 = 25 points (5 credits), 7x7 = 49 points (10 credits), 9x9 = 81 points (18 credits).
Rank of 0 means the business was not found in the local pack at that grid point.
Combine with Claude via MCP for narrative interpretation of grid results.
Store results over time to track geographic ranking trends.