Google Maps
Google Maps
Google Maps place details
GET /google-maps/v1/detailsEverything the place panel shows, for up to 20 businesses per call (business_id, comma-separated: business ids, place ids or CIDs): contact details, address parts, plus code, opening hours and open status, descriptions, rating with its 1-5 star histogram (reviews_per_rating), review topics, the About tab (accessibility, amenities, payments, parking…), popular times when Google has them, owner, verified status, business status, links (menu, order, reservations, booking), departments, labels, a photo sample and the first reviews. extract_share_link=true adds the short maps.app.goo.gl link; extract_emails_and_contacts=true adds the emails and social profiles found on the business website. Results are in businesses (and the first in place); ids that were not found are listed in errors. The older single-place ids (feature_id, cid, a Maps url, place_id with q) still work.
Every response includes credits_used: the credits this call cost.
Each call costs 1 credits; failed calls are free. Run it in the console playground to see a live result.
Parameters
| Name | Type | Description |
|---|---|---|
feature_id | string | The place's Google data id (`0x…:0x…`), from search results (`feature_id`) or a Maps URL (`!1s0x…`). Example: 0x8644ca6bc309e81b:0x1f1a903bbb66839 |
cid | string | The place's CID (the number in `?cid=` Maps links), instead of feature_id. |
url | string | A Google Maps place URL, instead of feature_id. |
place_id | string | Google place id (`ChI…`), alone (resolved through its Maps page) or with `q` (the place name and city). |
q | string | With place_id, or alone: the place name and city to look up. |
hl | string | Language (default en). |
gl | string | Country (default us). |
business_id | string | The business: its `business_id` (`0x…:0x…`), `place_id` (`ChI…`) or `cid`, up to 20, comma-separated (billed per business). Instead of feature_id. Example: 0x89c2598f7ff4aa09:0x313547e757cb8cea |
extract_emails_and_contacts | boolean | true: also read the business website (home page and its contact page) for `emails_and_contacts`: emails, phone numbers and Facebook, Instagram, LinkedIn, X, YouTube, TikTok, GitHub, Yelp, Pinterest, Snapchat, Threads and WhatsApp links. Costs extra credits per business. |
extract_share_link | boolean | true: add `share_link`, the place's short maps.app.goo.gl link. |
language | string | Language (same as `hl`, default en). |
region | string | Country (same as `gl`, default us). |
Every endpoint also takes: fields、raw、fresh、output、records
{
"cached": false,
"credits_used": 1,
"place": {
"address": "Nothing Before Coffee Cafe - Gulmohar, Bhopal, Door Sanchar Nagar, Gulmohar, G-2 12, near by Uco Bank, Gulmohar G3, Ishwar Nagar, Gulmohar C…",
"address_detail": [
[
[
7,
[
[
"Nothing Before Coffee Cafe - Gulmohar, Bhopal"
],
[
"Door Sanchar Nagar, Gulmohar"
],
"… 3 more"
]
],
[
2,
[
[
"Nothing Before Coffee Cafe - Gulmohar, Bhopal, Door Sanchar Nagar, Gulmohar, G-2 12, near by Uco Bank, Gulmohar G3, Ishwar Nagar, Gulmohar C…"
]
]
],
"… 2 more"
],
[
"Gulmohar G3, Ishwar Nagar, Gulmohar Colony",
"Door Sanchar Nagar, Gulmohar, G-2 12, near by Uco Bank",
"… 5 more"
],
"… 1 more"
],
"address_parts": [
"Door Sanchar Nagar, Gulmohar",
"G-2 12, near by Uco Bank, Gulmohar G3, Ishwar Nagar, Gulmohar Colony",
"… 2 more"
],
"categories": [
"Coffee shop",
"Bakery",
"… 8 more"
],
"category": "Coffee shop",
"cid": "16894172895220284888",
"city": "Bhopal",
"country_code": "IN",
"description": "Nothing Before Coffee (NBC) | Best Coffee Shop Near You\n\nSince 2017, Nothing Before Coffee (NBC) has been serving the finest coffee, cold br…",
"descriptions": [],
"feature_id": "0x397c4318fd9a8927:0xea7428bd31a33dd8",
"full_address": "Door Sanchar Nagar, Gulmohar, G-2 12, near by Uco Bank, Gulmohar G3, Ishwar Nagar, Gulmohar Colony, Bhopal, Madhya Pradesh 462039, India",
"hours": {
"Friday": [
"9 AM–11:30 PM"
],
"Monday": [
"9 AM–11:30 PM"
],
"Saturday": [
"9 AM–11:30 PM"
],
"Sunday": [
"9 AM–11:30 PM"
],
"Thursday": [
"9 AM–11:30 PM"
],
"Tuesday": [
"9 AM–11:30 PM"
],
"Wednesday": [
"9 AM–11:30 PM"
]
},
"kgmid": "/g/11t6rsyj9g",
"latitude": 23.1936723,
"longitude": 77.435479,
"name": "Nothing Before Coffee Cafe - Gulmohar, Bhopal",
"neighborhood": "Gulmohar G3, Ishwar Nagar, Gulmohar Colony",
"open_status": "Closed · Opens 9 AM",
"owner": {
"id": "104266168709715326564",
"name": "Nothing Before Coffee Cafe - Gulmohar, Bhopal (Owner)"
},
"permanently_closed": null,
"phone": "+1 555 010 0000",
"phone_international": "+1 555 010 0000",
"phones": [
"+1 555 010 0000"
],
"photos_count": 1106,
"place_id": "ChIJJ4ma_RhDfDkR2D2jMb0odOo",
"plus_code": "7JMV5CVP+F5",
"postal_code": "462039",
"price_level": null,
"rating_histogram": {
"1": 40,
"2": 5,
"3": 25,
"4": 116,
"5": 550
},
"review_count": 736,
"service_options": null,
"stars": 4.5,
"state": "Madhya Pradesh",
"street": "Door Sanchar Nagar, Gulmohar, G-2 12, near by Uco Bank",
"thumbnail": "https://lh6.googleusercontent.com/-ONRkv5dBM-Y/AAAAAAAAAAI/AAAAAAAAAAA/9PKJ6nyl7hE/s44-p-k-no-ns-nd/photo.jpg",
"timezone": "Asia/Calcutta",
"url": "https://www.google.com/maps/place/?q=place_id:ChIJJ4ma_RhDfDkR2D2jMb0odOo",
"website": "https://stores.nothingbeforecoffee.com/nothing-before-coffee-in-madhya-pradesh-bhopal-near-by-uco-bank-38245",
"website_domain": "stores.nothingbeforecoffee.com",
"…": "8 more fields"
}
} Response fields (74)
Field paths and types observed in the sample response; the live response is authoritative.
$ | object |
$.cached | boolean |
$.credits_used | integer |
$.place | object |
$.place.address | string |
$.place.address_detail | array |
$.place.address_detail[] | array | string |
$.place.address_detail[][] | array | string |
$.place.address_detail[][][] | array | integer |
$.place.address_detail[][][][] | array | string |
$.place.address_detail[][][][][] | string |
$.place.address_parts | array |
$.place.address_parts[] | string |
$.place.categories | array |
$.place.categories[] | string |
$.place.category | string |
$.place.cid | string |
$.place.city | string |
$.place.country_code | string |
$.place.description | string |
$.place.descriptions | array |
$.place.feature_id | string |
$.place.full_address | string |
$.place.hours | object |
$.place.hours.Friday | array |
$.place.hours.Friday[] | string |
$.place.hours.Monday | array |
$.place.hours.Monday[] | string |
$.place.hours.Saturday | array |
$.place.hours.Saturday[] | string |
$.place.hours.Sunday | array |
$.place.hours.Sunday[] | string |
$.place.hours.Thursday | array |
$.place.hours.Thursday[] | string |
$.place.hours.Tuesday | array |
$.place.hours.Tuesday[] | string |
$.place.hours.Wednesday | array |
$.place.hours.Wednesday[] | string |
$.place.kgmid | string |
$.place.latitude | number |
$.place.longitude | number |
$.place.name | string |
$.place.neighborhood | string |
$.place.open_status | string |
$.place.owner | object |
$.place.owner.id | string |
$.place.owner.name | string |
$.place.permanently_closed | null |
$.place.phone | string |
$.place.phone_international | string |
$.place.phones | array |
$.place.phones[] | string |
$.place.photos_count | integer |
$.place.place_id | string |
$.place.plus_code | string |
$.place.postal_code | string |
$.place.price_level | null |
$.place.rating_histogram | object |
$.place.rating_histogram.1 | integer |
$.place.rating_histogram.2 | integer |
$.place.rating_histogram.3 | integer |
$.place.rating_histogram.4 | integer |
$.place.rating_histogram.5 | integer |
$.place.review_count | integer |
$.place.service_options | null |
$.place.stars | number |
$.place.state | string |
$.place.street | string |
$.place.thumbnail | string |
$.place.timezone | string |
$.place.url | string |
$.place.website | string |
$.place.website_domain | string |
$.place.… | string |