Skip to content

Endpoints · 01/13

Search

Organic results, knowledge graph, People also ask and related searches.

EndpointPOSThttps://serp-api.ozymoz.com/search
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
tbsTime filter: qdr:h (hour), qdr:d (day), qdr:w (week), qdr:m (month), qdr:y (year).
locationFree-text location to search from, e.g. “Istanbul, Turkey”.
devicedesktop (default) or mobile — the light page: real links, mobile ranking, no People also ask.Default: desktop
resolveLinksResolve Google's /goto redirect links to the real URLs (desktop only).Default: true

Example request

curl -X POST 'https://serp-api.ozymoz.com/search' \
  -H 'X-API-KEY: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "q": "best espresso machine",
    "gl": "us",
    "hl": "en"
  }'

Example response

Illustrative values in the real shape. Top-level keys: organic, knowledgeGraph, peopleAlsoAsk, relatedSearches.

response.json
{
  "searchParameters": {
    "type": "search",
    "engine": "google",
    "q": "best espresso machine",
    "gl": "us",
    "hl": "en",
    "device": "desktop"
  },
  "organic": [
    {
      "title": "The 9 Best Espresso Machines of 2026, Tested",
      "link": "https://www.example-reviews.com/best-espresso-machines",
      "snippet": "We pulled more than 400 shots to find the espresso machines worth buying…",
      "date": "Sep 25, 2026",
      "position": 1
    },
    {
      "title": "Espresso machine buying guide",
      "link": "https://www.example-coffee.com/guides/espresso",
      "snippet": "Boiler, thermoblock or dual boiler? What matters for milk drinks…",
      "position": 2,
      "sitelinks": [
        {
          "title": "Grinders",
          "link": "https://www.example-coffee.com/grinders"
        }
      ]
    }
  ],
  "peopleAlsoAsk": [
    {
      "question": "Which espresso machine do baristas recommend?"
    }
  ],
  "relatedSearches": [
    {
      "query": "best espresso machine under 500"
    }
  ],
  "credits": 1
}

Good to know

device: mobile returns Google's light page — real links, mobile ranking, no peopleAlsoAsk. On desktop, resolveLinks (default true) turns Google's /goto redirects into real URLs; resolving never counts against anything.

Errors · Batch requests · Rate limits