Skip to content
Gridlode
Docs · Reference

Google Maps Rank Grid

GET /v1/places/google-maps/rank-grid2 credits / pointcache 60 min

A geo-grid local rank tracker: give a keyword, your business (place ID or name) and a centre point, and we run the keyword as a Google Maps search centred on every point of a 3x3, 5x5 or 7x7 grid (default 1 km apart) and report where your business ranks among the first 20 results at each point, with the top 3 competitors (name, place ID, rating, review count) per point and a summary: average rank where found, share of points in the top 3, found count, best and worst rank. Collected exactly as a signed-out visitor sees Google Maps; we never log in. Billed per grid point that returned a result page; blocked or timed-out points come back with rank null and are free.

Query parameters

keyword
string · required
What customers search for, e.g. 'dentist' or 'mexican restaurant'.
place_id
string
The business to track: Google place ID (ChIJ...) or feature id (0x...:0x...). Most precise.
Default: null
name
string
The business to track by name, used when place_id is not given. Matches any result whose name contains it (case and accents ignored); use place_id for chains.
Default: null
lat
number · required
Latitude of the grid centre, e.g. 30.2672.
lng
number · required
Longitude of the grid centre, e.g. -97.7431.
grid_size
integer
Points per side: 3 (9 points), 5 (25) or 7 (49). Billed per grid point.
Default: 5
Allowed: 3, 5, 7
spacing_km
number
Distance between neighbouring points in km.
Default: 1
zoom
integer
Map zoom used for each search (13 is about a neighbourhood-wide view).
Default: 13
hl
string
Interface language, e.g. en, de, es.
Default: "en"
gl
string
Two-letter country code to search from.
Default: "us"
max_age
integer
Accept a cached answer up to this many seconds old, billed at 50%.

Response data fields

    Example

    curl "https://api.gridlode.com/v1/places/google-maps/rank-grid?keyword=barbecue&name=Franklin%20Barbecue&lat=30.2701&lng=-97.7313&grid_size=3&spacing_km=1" \
  -H "Authorization: Bearer $GRIDLODE_KEY"

    Try it without code on the Google Maps Rank Grid API page.