Search APIs
Loading…
← API Store
Search & SEO

Google Maps

Google Maps

Google Maps place search

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

Google 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

NameTypeDescription
qrequiredstring Example: coffee near times square
latnumberCentre the search on this point (with lng), like the map viewport.
lngnumberLongitude of the centre point.
zoomintegerWith lat/lng, the map zoom 3-21 (default 14); lower is a wider area.
pageintegerPage number. Pass `next_page` from the previous response; `next_page` is null on the last page.
limitintegerPlaces to return (default 20, max 200; each 20 is one more page).
bboxstringSearch inside a bounding box: `south,west,north,east` (degrees). Results outside the box are dropped.
nestringWith `sw`, the box's north-east corner `lat,lng` (instead of bbox).
swstringWith `ne`, the box's south-west corner `lat,lng`.
radiusintegerWith lat/lng: only places within this many metres (10-100000); sets the zoom to fit.
querystringSame as `q`.
subtypesstringKeep only businesses with one of these categories (comma-separated, as in `subtypes`), e.g. `Plumber,Drainage service`.
verifiedbooleantrue: only businesses claimed by their owner; false: only unclaimed ones.
business_statusstringKeep only these statuses (comma-separated): OPEN, CLOSED_TEMPORARILY, CLOSED.
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.
languagestringLanguage (same as `hl`, default en).
regionstringCountry (same as `gl`, default us).
min_ratingnumberOnly places rated at least this (1-5, e.g. 4.5).
open_nowtrue | falsetrue: 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
$.cachedboolean
$.credits_usedinteger
$.next_pageinteger
$.pageinteger
$.placesarray
$.places[]object | string
$.places[].addressstring
$.places[].address_detailarray
$.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_partsarray
$.places[].address_parts[]string
$.places[].categoriesarray
$.places[].categories[]string
$.places[].categorystring
$.places[].cidstring
$.places[].citystring
$.places[].country_codestring
$.places[].descriptionnull
$.places[].feature_idstring
$.places[].full_addressstring
$.places[].hoursobject
$.places[].hours.Fridayarray
$.places[].hours.Friday[]string
$.places[].hours.Mondayarray
$.places[].hours.Monday[]string
$.places[].hours.Saturdayarray
$.places[].hours.Saturday[]string
$.places[].hours.Sundayarray
$.places[].hours.Sunday[]string
$.places[].hours.Thursdayarray
$.places[].hours.Thursday[]string
$.places[].hours.Tuesdayarray
$.places[].hours.Tuesday[]string
$.places[].hours.Wednesdayarray
$.places[].hours.Wednesday[]string
$.places[].kgmidstring
$.places[].latitudenumber
$.places[].longitudenumber
$.places[].namestring
$.places[].neighborhoodstring
$.places[].open_statusstring
$.places[].permanently_closednull
$.places[].phonenull | string
$.places[].phone_internationalnull | string
$.places[].phonesarray
$.places[].phones[]string
$.places[].photos_countinteger
$.places[].place_idstring
$.places[].postal_codestring
$.places[].price_levelnull
$.places[].review_countinteger
$.places[].service_optionsnull | object
$.places[].service_options.Accessibilityarray
$.places[].service_options.Accessibility[]string
$.places[].starsnumber
$.places[].statestring
$.places[].streetstring
$.places[].thumbnailstring
$.places[].timezonestring
$.places[].urlstring
$.places[].websitestring
$.places[].website_domainstring
$.querystring