Skip to content
Gridlode
Docs · Reference

Google Maps Places Search

GET /v1/places/google-maps2 credits / placecache 43200 min

Businesses and places from a Google Maps search, by query plus city ("dentists", "Austin, TX") or by exact coordinates and zoom: name, place ID, CID, categories, rating, review count, phone, website, full address with components, coordinates, opening hours, business status, attributes and thumbnail, up to 120 places per query. Collected exactly as a signed-out visitor sees Google Maps: we never log in or use accounts. Google's signed-out "limited view" hides some fields (price level, popular times, menus); those come back as null, never estimated, and every response includes a coverage report. Billed per place returned; blocked or failed requests are free.

Query parameters

q
string · required
What to search for, e.g. 'dentists' or 'coffee'.
location
string
Free-text place to search in, e.g. 'Austin, TX'. Appended to the query.
Default: null
ll
string
Exact map viewport as '@lat,lng,zoomz', e.g. '@30.2672,-97.7431,13z'.
Default: null
hl
string
Interface language, e.g. en, de, es.
Default: "en"
gl
string
Two-letter country code to search from.
Default: "us"
limit
integer
Maximum places to return (1-120).
Default: 20
skip_closed
boolean
Leave out temporarily and permanently closed places.
Default: false
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?q=coffee&location=Austin%2C%20TX&limit=20" \
  -H "Authorization: Bearer $GRIDLODE_KEY"

    Try it without code on the Google Maps Places Search API page.