SERP APIPOST /v1/serp

Search results, as JSON.

The SERP API runs a search on Google, Bing or DuckDuckGo from the country you choose and returns organic results, ads, featured snippets and related searches as structured JSON.

What it does

Google, Bing and DuckDuckGo results as structured JSON.

  • Three engines, one shape

    Set engine to google, bing or duckduckgo. Every answer has the same fields; sections an engine does not have are empty.

  • Every part of the page

    Organic results with sitelinks, ads by placement, the featured snippet, the answer box, People also ask and related searches.

  • Country, language and device

    Search from an exit in the country you pick, in the interface language you want, as desktop or mobile.

  • Honest parse status

    parse_status says whether everything was read (complete), some of it (partial, with warnings) or nothing (failed).

  • Consent pages and captchas handled

    Consent screens, captchas and JavaScript checks are detected and retried on another tier or IP, like any other block.

  • Sync, async or webhook

    Wait for the answer, or send async: true with a webhook_url and get a signed job.finished event.

Example

One HTTP call

POST an engine and a query. Positions continue across pages, so page 2 with 10 results per page starts at 11.

Official SDKs are coming soon. Until then, any HTTP client works.

SERP API docs
curl https://api.siftzo.com/v1/serp \
  -H "X-API-Key: $SIFTZO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"engine": "google", "q": "web scraping api", "country": "us", "language": "en"}'

Reference

Key parameters

enginegoogle | bing | duckduckgorequired
The search engine.
qstringrequired
The search, 1–512 characters.
countryISO 3166-1 alpha-2
Exit country, also passed to the engine as its country.
languagestring
Interface language, for example en or pt-br.
devicedesktop | mobiledefault desktop
Mobile searches as Chrome on Android when fetched over HTTP.
pageintegerdefault 1
1–10. DuckDuckGo has page 1 only.
asyncbooleandefault false
Return a job ID at once. Add webhook_url for a signed callback.
include_htmlbooleandefault false
Add the raw HTML of the results page.

Every parameter and response field is in the SERP API docs.

Credits

What it costs

SERP API credits
RequestCredits
SERP request (any engine, any tier)10
Failed request (blocked, timeout, proxy error)0

A search costs the same whichever engine answers and whichever tier fetched it.

See plans

Questions

Does a search cost more when a browser is needed?

No. A SERP request has one price for every engine and tier.

What if the page cannot be parsed?

You get parse_status: "failed" with warnings that say why. A page that was fetched without a block is billed even if it cannot be parsed; a blocked search costs nothing.

Can I get more than the first page?

Yes, page goes up to 10 on Google and Bing. DuckDuckGo needs a token from the previous page, so only page 1 is available there.

Can I search as a mobile user?

device: "mobile" sends the search as Chrome on Android when the page is fetched over HTTP. When a browser is needed, the search runs as desktop.

Try the SERP API for free

Create an account, copy your key and send a request. No card needed for the Free plan.