Skip to content
Gridlode
LiveMaps and local businesses2 credits / point

Google Maps Rank Grid API

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.

GEThttps://api.gridlode.com/v1/places/google-maps/rank-grid

Parameters

NameTypeDescription
keywordrequiredstringWhat customers search for, e.g. 'dentist' or 'mexican restaurant'.
place_idstringThe business to track: Google place ID (ChIJ...) or feature id (0x...:0x...). Most precise.
Default: null
namestringThe 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
latrequirednumberLatitude of the grid centre, e.g. 30.2672.
lngrequirednumberLongitude of the grid centre, e.g. -97.7431.
grid_sizeintegerPoints per side: 3 (9 points), 5 (25) or 7 (49). Billed per grid point.
Default: 5
One of: 3, 5, 7
spacing_kmnumberDistance between neighbouring points in km.
Default: 1
zoomintegerMap zoom used for each search (13 is about a neighbourhood-wide view).
Default: 13
hlstringInterface language, e.g. en, de, es.
Default: "en"
glstringTwo-letter country code to search from.
Default: "us"
max_ageintegerAccept a cached answer up to this many seconds old, billed at 50%. Default 0 (always fresh).

Response fields

    Code

    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"
    2 credits per point
    One credit is $0.001 on the smallest pack, from $0.0003 on enterprise plans.
    Half price for cached data
    Cached for up to 1 h. Pass max_age to use it.
    Failed requests are free
    Blocks, timeouts and target errors never cost credits.

    Market reference: Local Falcon ~$5 per 1k scan points (starter plan credits); BrightLocal Local Search Grid on paid plans.

    Questions

    How much does the Google Maps Rank Grid API cost?

    2 credits per point. One credit costs $0.001 on the smallest pack and as little as $0.0003 on enterprise plans. Cached answers cost half and failed calls are free.

    Maps and local businesses
    All 8 in Maps and local businesses · 6 live
    Live

    Google Maps Places Search

    Businesses and places from a Google Maps search, by query plus city ("dentists", "Austin, TX") or by exact coordinates and zoom

    2 credits / placeDocs
    Soon

    Yellow Pages Business Search

    Businesses from a yellowpages.com search by category or keyword plus city, state or ZIP ("plumbers", "Austin, TX")

    2 credits / businessDocs
    Live

    BBB Business Search & Profiles

    Better Business Bureau (bbb.org) businesses in the US and Canada, searched by name or category plus city or ZIP, or one business profile by its BBB…

    2 credits / businessDocs
    Soon

    Angi Pro Search

    Home-service pros from Angi (angi.com) for a service and US ZIP code (or city and state, or any Angi directory URL)

    2 credits / businessDocs
    Live

    Bing Maps Places Search

    Local businesses from a Bing Maps search, by keyword plus city, ZIP or address ("plumbers", "Austin, TX") or around exact coordinates

    1 credit / businessTry freeDocs