Skip to content
Serpwire
TR

Endpoints · 05/13

Maps

Google Maps results around a viewport, with opening hours and ids.

EndpointPOSThttps://serp-api.ozymoz.com/maps
Credits per call3

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
locationFree-text location to search from, e.g. “Istanbul, Turkey”.
llMap viewport as @latitude,longitude,zoomz — e.g. @41.0256,28.9744,15z.

Example request

curl -X POST 'https://serp-api.ozymoz.com/maps' \
  -H 'X-API-KEY: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "q": "bookstores",
    "ll": "@41.0256,28.9744,15z",
    "gl": "tr",
    "hl": "en"
  }'

Example response

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

response.json
{
  "searchParameters": {
    "type": "maps",
    "engine": "google",
    "q": "bookstores",
    "ll": "@41.0256,28.9744,15z",
    "gl": "tr",
    "hl": "en"
  },
  "ll": "@41.0256,28.9744,15z",
  "places": [
    {
      "position": 1,
      "title": "Example Books",
      "address": "İstiklal Cd. No:1, Beyoğlu, İstanbul",
      "latitude": 41.0336,
      "longitude": 28.9775,
      "rating": 4.6,
      "ratingCount": 912,
      "type": "Book store",
      "types": [
        "Book store",
        "Cafe"
      ],
      "openingHours": {
        "Monday": "10 AM–10 PM"
      },
      "cid": "1234567890123456789",
      "fid": "0x14cab9e0b7a6f0b5:0x112210f2bbf8b915"
    }
  ],
  "credits": 3
}

Good to know

The ll viewport decides which places appear: zoom in for a neighbourhood, out for a city.

Errors · Batch requests · Rate limits