Google

Google Maps Geo-Grid

Track where a business ranks in Google Maps local results across a grid of points around a location - the classic local-SEO geo-grid rank tracker. Give a search term and a target business (by Place ID and/or name) and get its rank at every grid point plus an aggregate summary: average, best, worst rank and coverage. Billed per grid point: an N x N grid costs N^2 credits, and any point that returns no data is free.

POST/api/v2/google/maps/geo-grid

Authorizations

Authorizationstringheaderrequired

Bearer authentication header of the form Bearer <token>, where <token> is your Scavio API key (e.g. Bearer sk_live_your_key).

Body

application/json

querystringrequired

The search term to measure the business's local ranking for.

Example: coffee shop

target_place_idstring

Place ID of the business to track (exact match, preferred). Provide this and/or target_name.

Example: ChIJo20fEQpZwokRW7sSJjFierw

target_namestring

Business name to track (case-insensitive substring match). Used when no target_place_id is given. Provide this and/or target_place_id.

Example: Buddies Coffee

centerobjectrequired

Geographic center of the grid, as { lat, lng }. center.lat is -90 to 90, center.lng is -180 to 180.

Example: {"lat": 40.7128, "lng": -74.006}

grid_sizenumberdefault:5

Grid dimension N for an N x N lattice of points - one of 3, 5 or 7. This is the price-bearing parameter: the call costs N^2 credits.

3 — 9 points, 9 credits.
5 — 25 points, 25 credits. The default.
7 — 49 points, 49 credits.

radius_kmnumberdefault:2

Half-extent of the grid from the center, in kilometers.

Example: 2

zoomnumberdefault:13

Map zoom level applied at every grid point (1 to 21).

Example: 13

Request

from scavio import ScavioClient

client = ScavioClient(api_key="sk_live_your_key")
results = client.google.maps_geo_grid(
    query="coffee shop",
    target_name="starbucks",
    center={"lat": 40.7128, "lng": -74.006},
    grid_size=3,
)
print(results["data"]["summary"])

Response

"query": "coffee shop",

"grid_size": 3,

"radius_km": 2,

"response_time": 14991,

"credits_used": 9,

"credits_remaining": 4549

}

from scavio import ScavioClient client = ScavioClient(api_key="sk_live_your_key") results = client.google.maps_geo_grid( query="coffee shop", target_name="starbucks", center={"lat": 40.7128, "lng": -74.006}, grid_size=3, ) print(results["data"]["summary"])