Google Maps API
Search businesses and places by keyword and area, get address, phone, website, hours, rating and attributes of a place, and page through its reviews with owner responses.
Overview and use cases on the Google Maps API page; response format, pagination and errors are the same for every API (conventions).
- Search places /v1/maps/places/search
- Get place details /v1/maps/places/{place_id}
- List place reviews /v1/maps/places/{place_id}/reviews
- Resolve a Maps URL or ID /v1/maps/places/resolve
Search places
GET
/v1/maps/places/search3 credits / callPlaces matching a query, optionally around a point, up to 20 per call.
| Parameter | In | Type | Default | Description |
|---|---|---|---|---|
| q* | query | string | — | What to search, e.g. dentist in Berlin |
| language | query | string | en | Result language (en, it, pt-BR...) |
| region | query | string | us | Two-letter country code to bias results |
| lat | query | number (-90–90) | — | Latitude of the search centre (with lng) |
| lng | query | number (-180–180) | — | Longitude of the search centre (with lat) |
| radius_km | query | number (0.1–100) | — | Radius around lat/lng in km |
| limit | query | integer (1–20) | 20 | Places per page (max 20) |
| cursor | query | string | — | pagination.next_cursor of the previous page |
curl "https://api.scrapecrate.com/v1/maps/places/search?q=pizzeria%20in%20Milan" \
-H "X-API-Key: YOUR_API_KEY"{
"data": [
{
"id": "ChIJ2eUgeAK6j4ARbn5u_wAGqWA",
"name": "Pizzeria Da Mario",
"primary_category": "Pizza restaurant",
"categories": [
"Pizza restaurant",
"Italian restaurant"
],
"address": {
"formatted": "Via Roma 1, 20121 Milano MI, Italy",
"city": "Milano",
"country_code": "IT"
},
"location": {
"lat": 45.4642,
"lng": 9.19
},
"rating": 4.6,
"review_count": 1284,
"phone": "+39 02 1234567",
"website": "https://example.com",
"status": "operational"
}
],
"pagination": {
"next_cursor": "eyJwIjoyfQ",
"has_more": true
},
"meta": {
"request_id": "req_8f2c1a9b0d3e4f5a6b7c",
"credits_used": 3,
"credits_remaining": 9999
}
}Get place details
GET
/v1/maps/places/{place_id}3 credits / callFull details of a place by place ID, CID or feature ID.
| Parameter | In | Type | Default | Description |
|---|---|---|---|---|
| place_id* | path | string | — | Place ID, CID or feature ID (use /places/resolve for URLs) |
| language | query | string | en | Result language |
| region | query | string | us | Two-letter country code |
curl "https://api.scrapecrate.com/v1/maps/places/ChIJ2eUgeAK6j4ARbn5u_wAGqWA" \
-H "X-API-Key: YOUR_API_KEY"{
"data": {
"id": "ChIJ2eUgeAK6j4ARbn5u_wAGqWA",
"cid": "12345678901234567890",
"name": "Pizzeria Da Mario",
"primary_category": "Pizza restaurant",
"address": {
"formatted": "Via Roma 1, 20121 Milano MI, Italy",
"street": "Via Roma 1",
"postal_code": "20121",
"city": "Milano",
"country_code": "IT"
},
"location": {
"lat": 45.4642,
"lng": 9.19
},
"rating": 4.6,
"review_count": 1284,
"phone": "+39 02 1234567",
"website": "https://example.com",
"timezone": "Europe/Rome",
"opening_hours": {
"weekly": [
{
"day": "monday",
"open": "12:00",
"close": "23:00"
}
]
},
"attributes": {
"Service options": [
"Dine-in",
"Takeaway"
]
},
"photos": [
{
"url": "https://example.com/photo.jpg",
"width": 1024,
"height": 768
}
]
},
"meta": {
"request_id": "req_8f2c1a9b0d3e4f5a6b7c",
"credits_used": 3,
"credits_remaining": 9999
}
}List place reviews
GET
/v1/maps/places/{place_id}/reviews3 credits / callReviews of a place with rating, text, translation, date and owner response.
| Parameter | In | Type | Default | Description |
|---|---|---|---|---|
| place_id* | path | string | — | Place ID, CID or feature ID |
| sort | query | relevant | newest | highest | lowest | relevant | Review order |
| language | query | string | en | Language of translations |
| limit | query | integer (1–20) | 20 | Reviews per page (max 20, one page of the source) |
| cursor | query | string | — | pagination.next_cursor of the previous page |
curl "https://api.scrapecrate.com/v1/maps/places/ChIJ2eUgeAK6j4ARbn5u_wAGqWA/reviews" \
-H "X-API-Key: YOUR_API_KEY"{
"data": [
{
"id": "ChZDSUhNMG9nS0VJQ0FnSUNz",
"rating": 5,
"published_at": "2026-10-02T19:12:00Z",
"language": "it",
"text": "Pizza ottima, servizio veloce.",
"translated_text": "Great pizza, fast service.",
"author": {
"id": "a_5f2c9e",
"review_count": 31,
"is_local_guide": true
},
"owner_response": {
"text": "Grazie!",
"published_at": "2026-10-03T08:00:00Z"
}
}
],
"pagination": {
"next_cursor": "eyJwIjoyfQ",
"has_more": true
},
"meta": {
"request_id": "req_8f2c1a9b0d3e4f5a6b7c",
"credits_used": 3,
"credits_remaining": 9999
}
}Resolve a Maps URL or ID
GET
/v1/maps/places/resolve3 credits / callTurn any Google Maps URL, short link, CID or feature ID into the place IDs.
| Parameter | In | Type | Default | Description |
|---|---|---|---|---|
| input* | query | string | — | A Maps URL, short link, CID or feature ID |
curl "https://api.scrapecrate.com/v1/maps/places/resolve?input=https%3A%2F%2Fmaps.app.goo.gl%2Fabc123" \
-H "X-API-Key: YOUR_API_KEY"{
"data": {
"place_id": "ChIJ2eUgeAK6j4ARbn5u_wAGqWA",
"cid": "12345678901234567890",
"feature_id": "0x4786c6aec34636a1:0xab7f4e27101a2e13",
"google_maps_url": "https://www.google.com/maps?cid=12345678901234567890"
},
"meta": {
"request_id": "req_8f2c1a9b0d3e4f5a6b7c",
"credits_used": 3,
"credits_remaining": 9999
}
}