Skip to content
Serpwire
TR

Endpoints · 04/13

Places

The local pack: businesses with address, rating, coordinates and cid.

EndpointPOSThttps://serp-api.ozymoz.com/places
Credits per call1

Parameters

NameDescription
qrequiredThe search query.
glCountry to search from, as a two-letter code (us, tr, de…).Default: us
hlInterface language, as a language code (en, tr, de…).Default: en
numNumber of results per page.Default: 10
pageResults page, starting at 1.Default: 1
locationFree-text location to search from, e.g. “Istanbul, Turkey”.

Example request

curl -X POST 'https://serp-api.ozymoz.com/places' \
  -H 'X-API-KEY: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "q": "coffee roasters",
    "location": "Istanbul, Turkey",
    "gl": "tr",
    "hl": "en"
  }'

Example response

Illustrative values in the real shape. Top-level keys: places.

response.json
{
  "searchParameters": {
    "type": "places",
    "engine": "google",
    "q": "coffee roasters",
    "location": "Istanbul, Turkey",
    "gl": "tr",
    "hl": "en"
  },
  "places": [
    {
      "position": 1,
      "title": "Example Coffee Roasters",
      "address": "Kemankeş Karamustafa Paşa, Karaköy, İstanbul",
      "latitude": 41.0237,
      "longitude": 28.9771,
      "rating": 4.7,
      "ratingCount": 1834,
      "category": "Coffee shop",
      "website": "https://example-roasters.com",
      "cid": "2431845123845123845"
    }
  ],
  "credits": 1
}

Good to know

Some places have no website in Google's data; the field is then omitted.

Errors · Batch requests · Rate limits