POST /places

Google Places API

The BestSERP Google Places API returns the local businesses Google lists for a query such as "coffee shop in Hanoi" as JSON: name, address, category, rating and review count, price level, opening status, coordinates, place ID and CID. It reads Google's public results, so you need no Google Cloud project or Places API key.

Last updated:

Key takeaways

  • /places returns places with title, address, category, rating, ratingCount and more.
  • Target any country with gl and any language with hl; city-level location is not supported yet.
  • 1 credit per page of results ($0.50 per 1,000 after 3,000 free); failed searches are refunded.
  • POST a JSON body or GET with the same parameters; the key goes in the X-API-KEY header.

Try the Google Places API

Pick a suggested query to see a saved response, or type your own for a live search (3 free per day).

Loading the live demo

Send a request

POST a JSON body to https://api.bestserp.com/places with your key in the X-API-KEY header. Replace YOUR_API_KEY and run.
curl -X POST 'https://api.bestserp.com/places' \
  -H 'X-API-KEY: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"q":"coffee shop hanoi"}'

Parameters

ParameterTypeDefaultDescription
qrequiredstringSearch query (1–256 characters).
glstringusCountry, 2-letter code (us, gb, vn, de…). The search runs from an IP in that country when one is free, else from another one (see ipCountry).
hlstringenInterface language (en, vi, de…).
pagesinteger1Result pages or scroll loads to fetch, 1–5. Each costs 1 credit.
includeThumbnailsbooleanfalseInclude inline base64 thumbnails (~20 KB each).
noCachebooleanfalseSkip the 1-hour result cache (5 minutes for news).
asyncbooleanfalseAnswer 202 immediately with a requestId to poll.
timeoutnumber60Seconds to wait before answering 202 (1–120).
autocorrectbooleanAccepted for compatibility; no effect.

Response fields

Results are in places. Empty fields are left out.

places[]

FieldMeaning
positionRank of the place, from 1.
titleBusiness or place name.
addressAddress as shown.
categoryType of place as shown, e.g. Coffee shop.
ratingAverage rating out of 5.
ratingCountNumber of reviews.
priceLevelPrice range as shown, e.g. $$.
hoursOpening status as shown, e.g. Open · Closes 10 PM.
snippetShort description or review excerpt, when shown.
latitudeLatitude in decimal degrees.
longitudeLongitude in decimal degrees.
placeIdGoogle place ID.
cidGoogle Maps customer ID (CID).
linkLink shown for the place in the listing, when there is one.
thumbnailUrlThumbnail as an inline data: URI, only with includeThumbnails: true (about 20 KB each).

Every response

FieldMeaning
searchParametersYour request after validation, with defaults filled in (q, gl, hl, type, page or pages...).
requestIdID of this request. Poll GET /requests/{requestId} for async requests and for final links.
creditsCredits charged for this request (refunded automatically if it fails).
cachedtrue when the answer came from the recent-result cache (1 hour, 5 minutes for news).
linksPendingtrue while Google redirect links are being replaced by final URLs; poll the request to get them.
unresolvedLinksLinks that are still Google redirects: they work, but are not the final URL.
durationMsTime the search took, in milliseconds.
ipCountryCountry of the IP the search ran from (same code as gl). Another country than gl when no IP there was free: the search runs anyway instead of waiting. Missing when unknown.

Sample response

A trimmed response for "coffee shop hanoi". Your results reflect Google at the time of the request.
{
  "searchParameters": {
    "q": "coffee shop hanoi",
    "gl": "us",
    "hl": "en",
    "type": "places",
    "pages": 1,
    "engine": "google"
  },
  "places": [
    {
      "position": 1,
      "title": "Lantern Coffee Roasters",
      "address": "12 Hang Bac, Hoan Kiem, Hanoi",
      "category": "Coffee shop",
      "rating": 4.7,
      "ratingCount": 2140,
      "priceLevel": "$",
      "hours": "Open · Closes 10 PM",
      "latitude": 21.0341,
      "longitude": 105.8519,
      "placeId": "ChIJlanternCoffee01",
      "cid": "4893217750012345678"
    },
    {
      "position": 2,
      "title": "The Note Cafe",
      "address": "64 Luong Van Can, Hoan Kiem, Hanoi",
      "category": "Cafe",
      "rating": 4.5,
      "ratingCount": 3890,
      "priceLevel": "$",
      "hours": "Open · Closes 11 PM",
      "latitude": 21.0322,
      "longitude": 105.8511,
      "placeId": "ChIJnoteCafeHanoi02",
      "cid": "1185342209876543210"
    },
    {
      "position": 3,
      "title": "Cong Corner",
      "address": "152 Trieu Viet Vuong, Hai Ba Trung, Hanoi",
      "category": "Coffee shop",
      "rating": 4.4,
      "ratingCount": 980,
      "priceLevel": "$",
      "hours": "Closed · Opens 7 AM",
      "latitude": 21.0145,
      "longitude": 105.8497,
      "placeId": "ChIJcongCorner00003",
      "cid": "7734001122334455667"
    }
  ],
  "requestId": "5b0c8a52-3f0e-4d55-9a2a-0f3a8e2d1c11",
  "credits": 1,
  "cached": false,
  "linksPending": false,
  "unresolvedLinks": 0,
  "durationMs": 2280
}

What you can build

  • Local SEO

    Check which businesses Google shows for local queries, and in what order.

  • Lead lists

    Build lists of businesses by category and city, with ratings and addresses.

  • Location research

    Compare competitors' ratings and review counts in an area.

Current limits

What this API does not do yet, so you can decide before you build on it.
  • Returns the listing for the query, not each place's detail page: no phone numbers, review text or photo galleries.
  • Put the city in the query ("pizza new york"): the search area follows the query and gl, coordinates or a radius are not supported.
  • Photos are returned only as an optional thumbnail with includeThumbnails: true.
  • Targeting is by country (gl) and interface language (hl). City-level location is not supported yet: a request with location is refused with an explicit error.
  • Results are what a desktop browser sees. There is no mobile SERP option yet.
  • 60 searches per minute per account by default; ask on Telegram for more.

Pricing: 1 credit per page of results, 3,000 free credits, then $0.50 per 1,000. See pricing

Frequently asked questions

Is this the official Google Places API?
No. It returns the businesses Google shows in its public search results, so you do not need a Google Cloud account; the fields and limits are those described on this page.
How do I search a city?
Include the place in the query, for example "dentist berlin", and set gl to the country. Coordinates and radius are not supported yet.
Does it return phone numbers or websites?
Not phone numbers. link holds the link shown for the place, when the listing has one.
What are placeId and cid?
Google's identifiers for the place: use them to deduplicate places across searches or to open the place on Google Maps.

Start with 3,000 free searches

No credit card. Sign in with Google, create a key, send your first request.