Skip to main content
Two endpoints, one key. Both load Google Maps in a real browser, in English. Google gives logged-out visitors either a full or a limited view of Maps, and the API cannot pick which. The limited view leaves out review counts, the rating histogram, review topics, reviews, and most of the week’s hours. Those fields are then null or empty; everything else is the same. See the Google Maps API: overview, pricing, and free tier. GET /v1/google-maps/search · 1 request One call scrolls the Maps results list and returns every place it loaded, usually 20 to 70, repeats removed. There is no paging.
Response time: 9–15 s typical, 60 s limit. Browser with steps: Maps draws its results in the browser, which then scrolls the list until it stops growing. How to read this. One call returns the whole scrolled list, so there is no page or cursor, and next_cursor is always null. Each result includes position, title, place_id, data_id (the Maps feature id), cid, latitude, longitude, rating, reviews_count, category, price, address, open_state, phone, website, description, wheelchair_accessible, action_links[] (label, url: Book online, Order online, and the like), thumbnail, sponsored, and url.
  • address is the street line Maps shows on the card. Service-area businesses show none.
  • Trade searches (plumbers, HVAC) carry phone and website on each card. Storefront searches (cafés, restaurants, shops, dentists) show a photo instead, with no phone, website, or usually price; call Place for those.
  • reviews_count is null on cards Google drew in its limited view. One list can mix both.
  • sponsored places are Google ads. Their website is null because the card links through an ad redirect.

Place

GET /v1/google-maps/place · 1 request
Response time: 13–17 s typical, 60 s limit. Browser with steps: Maps draws the place in the browser, which then opens the week’s hours and the full review texts. How to read this. The body is place: An id Google Maps does not know is 404 not_found. Auth, plans, rate limits, and error codes: Authentication.