Google maps place

Identify it any way you have it, place_id (ChIJ…), feature_id (0x…:0x…), cid (the decimal), a Google Maps url of any shape, or a free-text query ("Katz's Delicatessen New York"). All but query resolve in a single request, and the response echoes every identifier back so you can key on whichever your system uses.

On top of everything the search shape returns, a place adds whatever Google holds for it: the editorial description, review topics with mention counts and sentiment split, review snippets, the full attribute panel including "from the business", popular times by hour, typical visit duration, the menu with prices, popular dishes, reservation and ordering links, the owner, plus codes, nearby parking, "people also search for", and the photo set with full-resolution URLs.

Which of those actually arrive varies by place and by response: Google serves this surface in two payload tiers and the cheaper one omits review_count, price and several sections. Absent fields are omitted rather than filled with zeros, and meta.review_counts_complete tells you which tier answered. require_review_counts retries for the full one, worth it for a single place only when the count matters, since one place gets no benefit from the retry the way a 200-row listing does.

The example response below is real output from this endpoint, not an illustration. Long lists and long strings are shortened to keep the page readable, and each place that happens is marked. This example took 2.4s.

Authorization

ApiKeyAuth

X-API-Key<token>

Your API key. Sent on every request.

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

cid?string

Google customer id, the decimal form of the feature id's second half, e.g. 749179180580048584

country?string

ISO-2 country. Sets gl and runs the request from that country.

Default"us"

feature_id?string

Google feature id, e.g. 0x3bcb91302c3f36d7:0xa659e7ed3978ec8

language?string

Google hl, the language the place comes back in

Default"en"

latitude?number

Optional hint for which of several same-named places is meant

longitude?number

Optional hint for which of several same-named places is meant

max_tier_attempts?integer

How many attempts require_review_counts may spend

Default6

place_id?string

Google place id, e.g. ChIJ1zY_LDCRyzsRyI6X036eZQo

query?string

Free-text name or address to resolve. Costs one extra lookup.

require_review_counts?boolean

Retry on fresh request origin until Google serves the tier carrying review_count. Roughly one attempt in five lands it.

Defaultfalse

url?string

Any Google Maps URL for the place; every identifier it carries is read out of it

Response Body

`application/json`

curl -X POST "https://example.com/v1/scrapers/google-maps-place-v4" \  -H "Content-Type: application/json" \  -d '{    "place_id": "ChIJ241qFchbwokRROiFMk2canc"  }'

{  "request_id": "req_8f2c1d94e7b0",  "success": true,  "status": {    "code": "OK",    "message": "Scrape completed.",    "retryable": false  },  "data": {    "meta": {      "elapsed_seconds": 1.658,      "review_counts_complete": false,      "upstream_calls": 1    },    "place": {      "address": "BROOKLYN PERK Coffee, 605 Flatbush Ave, Brooklyn, NY 11225",      "address_lines": [        "605 Flatbush Ave",        "Brooklyn, NY 11225"      ],      "attributes": {        "available": {          "accessibility": [            "Wheelchair accessible entrance"          ]        },        "groups": [          {            "attributes": [              {                "available": true,                "id": "/geo/type/establishment_poi/has_wheelchair_accessible_entrance",                "label": "Wheelchair accessible entrance",                "sentence": "Has wheelchair accessible entrance"              },              {                "available": false,                "id": "/geo/type/establishment_poi/has_wheelchair_accessible_parking",                "is_negative": true,                "label": "Wheelchair accessible parking lot",                "sentence": "No wheelchair accessible parking lot"              }            ],            "id": "accessibility",            "label": "Accessibility"          }        ]      },      "categories": [        "Coffee shop"      ],      "category": "Coffee shop",      "cid": "8604861893418805316",      "components": {        "city": "Brooklyn",        "country_code": "US",        "neighborhood": "Prospect Lefferts Gardens",        "postal_code": "11225",        "route": "605 Flatbush Ave",        "state": "New York",        "street": "605 Flatbush Ave"      },      "country_code": "US",      "feature_id": "0x89c25bc8156a8ddb:0x776a9c4d3285e844",      "geo_entities": [        {          "confidence": 0.75,          "name": "Americas"        },        {          "confidence": 0.75,          "name": "Brooklyn Community School District 17"        },        "… 13 more items in the full response"      ],      "google_maps_url": "https://www.google.com/maps/place/?q=place_id:ChIJ241qFchbwokRROiFMk2canc",      "google_type": "SearchResult.TYPE_COFFEE",      "hours": {        "closes_at": {          "hour": 16,          "minute": 30        },        "open_now": true,        "status": "Open",        "status_text": "Open · Closes 5:30 PM",        "weekly": [          {            "date": "2026-08-23",            "day": "Sunday",            "day_of_week": 7,            "periods": [              {                "closes": {                  "hour": 17,                  "minute": 30                },                "opens": {                  "hour": 8,                  "minute": 0                },                "text": "8 AM–5:30 PM"              }            ]          }        ]      },      "is_claimed": true,      "kg_id": "/g/11h280xq3r",      "language": {        "primary": "en"      },      "location": {        "lat": 40.658600899999996,        "lng": -73.9603257      },      "name": "BROOKLYN PERK Coffee",      "owner": {        "id": "116883037736195969811",        "name": "BROOKLYN PERK Coffee (Owner)",        "photo": "https://lh3.googleusercontent.com/-2Y_EMNkhT5k/AAAAAAAAAAI/AAAAAAAAAAA/zCOuferZ2RA/s44-p-k-no-ns-nd/photo.jpg"      },      "phone": {        "digits": "+19179669331",        "display": "(917) 966-9331",        "international": "+1 917-966-9331",        "national": "(917) 966-9331",        "tel": "tel:+19179669331"      },      "photo_count": 243,      "photos": [        {          "captured_date": "2024-10-31",          "height": 768,          "id": "ftr3OYQU3uLdOY0RAv6Tew",          "kind": "Street View",          "location": {            "lat": 40.658539242039424,            "lng": -73.9605087856917          },          "thumbnail_height": 120,          "thumbnail_url": "https://streetviewpixels-pa.googleapis.com/v1/thumbnail?panoid=ftr3OYQU3uLdOY0RAv6Tew&cb_client=search.gws-prod.gps&w=211&h=120&yaw=66.06193&pitch=0&thumbfov=100",          "thumbnail_width": 211,          "title": "BROOKLYN PERK Coffee",          "url": "https://streetviewpixels-pa.googleapis.com/v1/thumbnail?panoid=ftr3OYQU3uLdOY0RAv6Tew&cb_client=search.gws-prod.gps&w=211&h=120&yaw=66.06193&pitch=0&thumbfov=100",          "video_key": "J0R0OIM6U8o",          "width": 1024        },        {          "captured_date": "2021-03-10",          "height": 2205,          "id": "CIHM0ogKEICAgIC67PTCYQ",          "kind": "Photo",          "location": {            "lat": 40.6585876,            "lng": -73.96051419999999          },          "thumbnail_height": 86,          "thumbnail_url": "https://lh3.googleusercontent.com/gps-cs-s/AHRPTWlxjPvohLnYpcTR7pC3oz9lhX1YWID8nXagWVllm9cKUP8iAQ2qYXyFf7NrbjNBDj63N-pnfWQFCLPH835B0fKrQRXVi05ZN17A7s2IXxUZw8QDBKrzWyU4n7nY8wfqgNnAYw6x=w152-h86-k-no",          "thumbnail_width": 86,          "url": "https://lh3.googleusercontent.com/gps-cs-s/AHRPTWlxjPvohLnYpcTR7pC3oz9lhX1YWID8nXagWVllm9cKUP8iAQ2qYXyFf7NrbjNBDj63N-pnfWQFCLPH835B0fKrQRXVi05ZN17A7s2IXxUZw8QDBKrzWyU4n7nY8wfqgNnAYw6x=s0",          "video_key": "dlALBCznbSA",          "width": 3918        }      ],      "place_id": "ChIJ241qFchbwokRROiFMk2canc",      "plus_code": {        "compound_code": "M25Q+CV Brooklyn, New York",        "global_code": "87G8M25Q+CV"      },      "posting_enabled": false,      "rating": 4.7,      "region": "Brooklyn, NY",      "search_context": "ChtDaElKMjQxcUZjaGJ3b2tSUk9pRk1rMmNhbmOSAQtjb2ZmZWVfc2hvcOABAA",      "street_address": "605 Flatbush Ave, Brooklyn, NY 11225",      "timezone": "America/New_York",      "vicinity": "Prospect Lefferts Gardens",      "website": {        "domain": "brooklynperkcoffee.com",        "url": "https://www.brooklynperkcoffee.com/"      }    },    "success": true  },  "error": null,  "meta": {    "client_id": "client_abc123",    "scraper": "google-maps-place-v4",    "billable": true,    "duration_ms": 1797  }}

Authorization

Request Body

Response Body

200application/json

404application/json

429application/json

500application/json

`application/json`

`application/json`

`application/json`

`application/json`