Google Maps
Google Maps
Google Maps place search
GET /google-maps/v1/searchGoogle Maps business search, as the Maps list shows it, with every field of the place card. Each page is the next 20 results; limit up to 200 loads several pages in one call (billed per 20). Centre the search with lat/lng and zoom, or search an area: a bounding box (bbox or ne+sw) or a circle (radius with lat/lng). Filters: subtypes, verified, business_status. Each business carries business_id (= google_id, the 0x…:0x… feature id), place_id, google_mid, cid, name, phone_number (E.164), full_address with street_address, district, city, zipcode, state, country, latitude/longitude, timezone, rating, review_count, opening_status, working_hours, website, verified (claimed by its owner), owner_id/owner_name/owner_link, business_status (OPEN, CLOSED_TEMPORARILY, CLOSED), type and subtypes (categories), place_link, reviews_link, booking_link, reservations_link, order_link, menu_link, action_links, photos_sample, photo_count, summary, about_details, price_level, departments, next to the original fields. Pass next_page back as page; next_page is null on the last page (Maps lists end after about 10 pages). Filter by min_rating (places rated at least this) and open_now (places open at the time of the call); like the other filters, they apply to the places fetched for limit.
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 |
|---|---|---|
qrequired | string | Example: coffee near times square |
lat | number | Centre the search on this point (with lng), like the map viewport. |
lng | number | Longitude of the centre point. |
zoom | integer | With lat/lng, the map zoom 3-21 (default 14); lower is a wider area. |
page | integer | Page number. Pass `next_page` from the previous response; `next_page` is null on the last page. |
limit | integer | Places to return (default 20, max 200; each 20 is one more page). |
bbox | string | Search inside a bounding box: `south,west,north,east` (degrees). Results outside the box are dropped. |
ne | string | With `sw`, the box's north-east corner `lat,lng` (instead of bbox). |
sw | string | With `ne`, the box's south-west corner `lat,lng`. |
radius | integer | With lat/lng: only places within this many metres (10-100000); sets the zoom to fit. |
query | string | Same as `q`. |
subtypes | string | Keep only businesses with one of these categories (comma-separated, as in `subtypes`), e.g. `Plumber,Drainage service`. |
verified | boolean | true: only businesses claimed by their owner; false: only unclaimed ones. |
business_status | string | Keep only these statuses (comma-separated): OPEN, CLOSED_TEMPORARILY, CLOSED. |
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. |
language | string | Language (same as `hl`, default en). |
region | string | Country (same as `gl`, default us). |
min_rating | number | Only places rated at least this (1-5, e.g. 4.5). |
open_now | true | false | true: only places open now. |
Every endpoint also takes: fields、raw、fresh、output、records
{
"cached": false,
"credits_used": 1,
"next_page": 2,
"page": 1,
"places": [
{
"address": "Shop no. GF-67,68, 91,92, The Coffee Concept bhopal, Raj Business Park-01, JK Rd, behind Zudio, Narela Shankri, Minal Residency, Bhopal, Mad…",
"address_detail": [
[
[
7,
[
[
"The Coffee Concept bhopal"
],
[
"Shop no. GF-67,68, 91,92, Raj Business Park-01"
],
"… 3 more"
]
],
[
2,
[
[
"Shop no. GF-67,68, 91,92, The Coffee Concept bhopal, Raj Business Park-01, JK Rd, behind Zudio, Narela Shankri, Minal Residency, Bhopal, Mad…"
]
]
],
"… 2 more"
],
[
"Narela Shankri, Minal Residency",
"Shop no. GF-67,68, 91,92, Raj Business Park-01, JK Rd, behind Zudio",
"… 5 more"
]
],
"address_parts": [
"Shop no. GF-67,68, 91,92, Raj Business Park-01",
"JK Rd, behind Zudio, Narela Shankri, Minal Residency",
"… 2 more"
],
"categories": [
"Cafe"
],
"category": "Cafe",
"cid": "1628451887200234767",
"city": "Bhopal",
"country_code": "IN",
"description": null,
"feature_id": "0x397c69f47ca6ef9f:0x16996c5d0e626d0f",
"full_address": "Shop no. GF-67,68, 91,92, Raj Business Park-01, JK Rd, behind Zudio, Narela Shankri, Minal Residency, Bhopal, Madhya Pradesh 462023, India",
"hours": {
"Friday": [
"10:30 AM–11:30 PM"
],
"Monday": [
"10:30 AM–11:30 PM"
],
"Saturday": [
"10:30 AM–11:30 PM"
],
"Sunday": [
"10:30 AM–11:30 PM"
],
"Thursday": [
"10:30 AM–11:30 PM"
],
"Tuesday": [
"10:30 AM–11:30 PM"
],
"Wednesday": [
"10:30 AM–11:30 PM"
]
},
"kgmid": "/g/11z7qp743y",
"latitude": 23.2700646,
"longitude": 77.4582913,
"name": "The Coffee Concept bhopal",
"neighborhood": "Narela Shankri, Minal Residency",
"open_status": "Closed · Opens 10:30 AM",
"permanently_closed": null,
"phone": null,
"phone_international": null,
"phones": [],
"photos_count": 177,
"place_id": "ChIJn--mfPRpfDkRD21iDl1smRY",
"postal_code": "462023",
"price_level": null,
"review_count": 199,
"service_options": null,
"stars": 4.8,
"state": "Madhya Pradesh",
"street": "Shop no. GF-67,68, 91,92, Raj Business Park-01, JK Rd, behind Zudio",
"thumbnail": "https://lh4.googleusercontent.com/-5sVuULWtDnQ/AAAAAAAAAAI/AAAAAAAAAAA/lYQ3_WTHfJ8/s44-p-k-no-ns-nd/photo.jpg",
"timezone": "Asia/Calcutta",
"url": "https://www.google.com/maps/place/?q=place_id:ChIJn--mfPRpfDkRD21iDl1smRY",
"website": "https://thecoffeeconceptindia.com/",
"website_domain": "thecoffeeconceptindia.com"
},
{
"address": "TAN COFFEE | Bhopal, Madhya Pradesh, 67, E-2, Arera Colony, Bhopal, Madhya Pradesh 462016, India",
"address_detail": [
[
[
7,
[
[
"TAN COFFEE | Bhopal, Madhya Pradesh"
],
[
"67"
],
"… 3 more"
]
],
[
2,
[
[
"TAN COFFEE | Bhopal, Madhya Pradesh, 67, E-2, Arera Colony, Bhopal, Madhya Pradesh 462016, India"
]
]
],
"… 2 more"
],
[
"E-2, Arera Colony",
"67",
"… 5 more"
]
],
"address_parts": [
"67",
"E-2, Arera Colony",
"… 2 more"
],
"categories": [
"Coffee shop"
],
"category": "Coffee shop",
"cid": "3850141126588714860",
"city": "Bhopal",
"country_code": "IN",
"description": null,
"feature_id": "0x397c430098cc5863:0x356e72f4a9714f6c",
"full_address": "67, E-2, Arera Colony, Bhopal, Madhya Pradesh 462016, India",
"hours": {
"Friday": [
"8 AM–12 AM"
],
"Monday": [
"8 AM–12 AM"
],
"Saturday": [
"8 AM–12 AM"
],
"Sunday": [
"8 AM–12 AM"
],
"Thursday": [
"8 AM–12 AM"
],
"Tuesday": [
"8 AM–12 AM"
],
"Wednesday": [
"8 AM–12 AM"
]
},
"kgmid": "/g/11yvx4346w",
"latitude": 23.219569999999997,
"longitude": 77.43467,
"name": "TAN COFFEE | Bhopal, Madhya Pradesh",
"neighborhood": "E-2, Arera Colony",
"open_status": "Closed · Opens 8 AM",
"permanently_closed": null,
"phone": "+1 555 010 0000",
"phone_international": "+1 555 010 0000",
"phones": [
"+1 555 010 0000"
],
"photos_count": 442,
"place_id": "ChIJY1jMmABDfDkRbE9xqfRybjU",
"postal_code": "462016",
"price_level": null,
"review_count": 1127,
"service_options": {
"Accessibility": [
"Wheelchair accessible entrance",
"Wheelchair accessible parking lot",
"… 3 more"
]
},
"stars": 4.7,
"state": "Madhya Pradesh",
"street": "67",
"thumbnail": "https://lh4.googleusercontent.com/-_NE7SXbCAXQ/AAAAAAAAAAI/AAAAAAAAAAA/hNSJTwJAeCk/s44-p-k-no-ns-nd/photo.jpg",
"timezone": "Asia/Calcutta",
"url": "https://www.google.com/maps/place/?q=place_id:ChIJY1jMmABDfDkRbE9xqfRybjU",
"website": "https://tancoffeeindia.com/",
"website_domain": "tancoffeeindia.com"
},
"… 18 more"
],
"query": "coffee near bhopal"
} Response fields (68)
Field paths and types observed in the sample response; the live response is authoritative.
$ | object |
$.cached | boolean |
$.credits_used | integer |
$.next_page | integer |
$.page | integer |
$.places | array |
$.places[] | object | string |
$.places[].address | string |
$.places[].address_detail | array |
$.places[].address_detail[] | array |
$.places[].address_detail[][] | array | string |
$.places[].address_detail[][][] | array | integer |
$.places[].address_detail[][][][] | array | string |
$.places[].address_detail[][][][][] | string |
$.places[].address_parts | array |
$.places[].address_parts[] | string |
$.places[].categories | array |
$.places[].categories[] | string |
$.places[].category | string |
$.places[].cid | string |
$.places[].city | string |
$.places[].country_code | string |
$.places[].description | null |
$.places[].feature_id | string |
$.places[].full_address | string |
$.places[].hours | object |
$.places[].hours.Friday | array |
$.places[].hours.Friday[] | string |
$.places[].hours.Monday | array |
$.places[].hours.Monday[] | string |
$.places[].hours.Saturday | array |
$.places[].hours.Saturday[] | string |
$.places[].hours.Sunday | array |
$.places[].hours.Sunday[] | string |
$.places[].hours.Thursday | array |
$.places[].hours.Thursday[] | string |
$.places[].hours.Tuesday | array |
$.places[].hours.Tuesday[] | string |
$.places[].hours.Wednesday | array |
$.places[].hours.Wednesday[] | string |
$.places[].kgmid | string |
$.places[].latitude | number |
$.places[].longitude | number |
$.places[].name | string |
$.places[].neighborhood | string |
$.places[].open_status | string |
$.places[].permanently_closed | null |
$.places[].phone | null | string |
$.places[].phone_international | null | string |
$.places[].phones | array |
$.places[].phones[] | string |
$.places[].photos_count | integer |
$.places[].place_id | string |
$.places[].postal_code | string |
$.places[].price_level | null |
$.places[].review_count | integer |
$.places[].service_options | null | object |
$.places[].service_options.Accessibility | array |
$.places[].service_options.Accessibility[] | string |
$.places[].stars | number |
$.places[].state | string |
$.places[].street | string |
$.places[].thumbnail | string |
$.places[].timezone | string |
$.places[].url | string |
$.places[].website | string |
$.places[].website_domain | string |
$.query | string |