Search APIs
Loading…
← API Store
Search & SEO

Google Maps

Google Maps

Google Maps place details

GET /google-maps/v1/details
Test this endpoint

Everything 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

NameTypeDescription
feature_idstringThe place's Google data id (`0x…:0x…`), from search results (`feature_id`) or a Maps URL (`!1s0x…`). Example: 0x8644ca6bc309e81b:0x1f1a903bbb66839
cidstringThe place's CID (the number in `?cid=` Maps links), instead of feature_id.
urlstringA Google Maps place URL, instead of feature_id.
place_idstringGoogle place id (`ChI…`), alone (resolved through its Maps page) or with `q` (the place name and city).
qstringWith place_id, or alone: the place name and city to look up.
hlstringLanguage (default en).
glstringCountry (default us).
business_idstringThe 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_contactsbooleantrue: 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_linkbooleantrue: add `share_link`, the place's short maps.app.goo.gl link.
languagestringLanguage (same as `hl`, default en).
regionstringCountry (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
$.cachedboolean
$.credits_usedinteger
$.placeobject
$.place.addressstring
$.place.address_detailarray
$.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_partsarray
$.place.address_parts[]string
$.place.categoriesarray
$.place.categories[]string
$.place.categorystring
$.place.cidstring
$.place.citystring
$.place.country_codestring
$.place.descriptionstring
$.place.descriptionsarray
$.place.feature_idstring
$.place.full_addressstring
$.place.hoursobject
$.place.hours.Fridayarray
$.place.hours.Friday[]string
$.place.hours.Mondayarray
$.place.hours.Monday[]string
$.place.hours.Saturdayarray
$.place.hours.Saturday[]string
$.place.hours.Sundayarray
$.place.hours.Sunday[]string
$.place.hours.Thursdayarray
$.place.hours.Thursday[]string
$.place.hours.Tuesdayarray
$.place.hours.Tuesday[]string
$.place.hours.Wednesdayarray
$.place.hours.Wednesday[]string
$.place.kgmidstring
$.place.latitudenumber
$.place.longitudenumber
$.place.namestring
$.place.neighborhoodstring
$.place.open_statusstring
$.place.ownerobject
$.place.owner.idstring
$.place.owner.namestring
$.place.permanently_closednull
$.place.phonestring
$.place.phone_internationalstring
$.place.phonesarray
$.place.phones[]string
$.place.photos_countinteger
$.place.place_idstring
$.place.plus_codestring
$.place.postal_codestring
$.place.price_levelnull
$.place.rating_histogramobject
$.place.rating_histogram.1integer
$.place.rating_histogram.2integer
$.place.rating_histogram.3integer
$.place.rating_histogram.4integer
$.place.rating_histogram.5integer
$.place.review_countinteger
$.place.service_optionsnull
$.place.starsnumber
$.place.statestring
$.place.streetstring
$.place.thumbnailstring
$.place.timezonestring
$.place.urlstring
$.place.websitestring
$.place.website_domainstring
$.place.…string