Skip to content
SpideyData
Get API key

SERP API

SERP API

Twelve SERP operations, one Bearer key

Google, Bing, Yahoo and DuckDuckGo: live · Baidu and Ecosia: opening soon · not GA

One /v1/serp surface for organic search results as JSON across six engines, Google News and Images, and poll-based Google tasks. This page answers three questions: which endpoint to call, sync or async, and how searches are metered.

Get API keySee display pricing

API keys work today for Google, Bing, Yahoo and DuckDuckGo organic. Baidu and Ecosia endpoints opening soon.

Minimal request · Google organic (live)
POST /v1/serp/google/organic
Authorization: Bearer <api_key>
Content-Type: application/json

{"q": "serp api"}

Omitted fields use the SerpGoogleOrganicRequest defaults: country=US, hl=en, device=desktop. Response shape: SERP JSON API.

Engines and launch status

Each engine's status comes from one launch configuration. Organic is available on every engine; News, Images and async tasks are Google only.

Google

Verticals: Organic, News, Images

Async tasks: Yes — /tasks + poll

Status: Live

Bing

Verticals: Organic

Async tasks: No

Status: Live

Yahoo

Verticals: Organic

Async tasks: No

Status: Live

DuckDuckGo

Verticals: Organic

Async tasks: No

Status: Live

Baidu

Verticals: Organic

Async tasks: No

Status: Opening soon

Ecosia

Verticals: Organic

Async tasks: No

Status: Opening soon

Endpoint decision tree

  1. Pick the engine. Bing, Yahoo, DuckDuckGo, Baidu and Ecosia each have one organic path, for example POST /v1/serp/bing/organic. Google has its own paths.
  2. On Google, pick the vertical. Organic, News or Images: POST /v1/serp/google/organic, /news or /images. Other engines are organic only.
  3. Need bulk on Google? Enqueue with POST /v1/serp/google/{vertical}/tasks (202 + task_id), then poll GET /v1/serp/tasks/{task_id}. There is no callback. Otherwise stay on the sync endpoint.

12-operation inventory

Every SERP operation in the public OpenAPI schema, with its launch status.

searchSerpGoogleOrganic

Method: POST

Path: /v1/serp/google/organic

Mode: Sync

Status: Live

searchSerpGoogleNews

Method: POST

Path: /v1/serp/google/news

Mode: Sync

Status: Live

searchSerpGoogleImages

Method: POST

Path: /v1/serp/google/images

Mode: Sync

Status: Opening soon

searchSerpBingOrganic

Method: POST

Path: /v1/serp/bing/organic

Mode: Sync

Status: Live

searchSerpYahooOrganic

Method: POST

Path: /v1/serp/yahoo/organic

Mode: Sync

Status: Live

searchSerpDuckDuckGoOrganic

Method: POST

Path: /v1/serp/duckduckgo/organic

Mode: Sync

Status: Live

searchSerpBaiduOrganic

Method: POST

Path: /v1/serp/baidu/organic

Mode: Sync

Status: Opening soon

searchSerpEcosiaOrganic

Method: POST

Path: /v1/serp/ecosia/organic

Mode: Sync

Status: Opening soon

createSerpGoogleOrganicTask

Method: POST

Path: /v1/serp/google/organic/tasks

Mode: Async enqueue

Status: Live

createSerpGoogleNewsTask

Method: POST

Path: /v1/serp/google/news/tasks

Mode: Async enqueue

Status: Live

createSerpGoogleImagesTask

Method: POST

Path: /v1/serp/google/images/tasks

Mode: Async enqueue

Status: Opening soon

getSerpTask

Method: GET

Path: /v1/serp/tasks/{task_id}

Mode: Async poll

Status: Live

Launch state

Each engine opens on its own schedule. Until an engine opens, every request to it returns 503 service_unavailable and is not charged.

  • Google is callable today with a Bearer API key.
  • Bing is callable today with a Bearer API key.
  • Yahoo is callable today with a Bearer API key.
  • DuckDuckGo is callable today with a Bearer API key.
  • Baidu endpoints opening soon: until they open, requests return 503 service_unavailable and are not charged.
  • Ecosia endpoints opening soon: until they open, requests return 503 service_unavailable and are not charged.

Engines, verticals and alternatives

By engine

By vertical & mode

Alternatives

Free SERP tools

Seven browser tools built on the same API, with a freemium allowance. Open now.

Guides

Credits & billing

SERP searches are charged per successful search at a display rate of 2 Credits per search; failed searches are not charged. Polling task status is free. The current rate is on Pricing. See Pricing.

What this is not

  • No webhooks or callbacks — async results are retrieved by polling GET /v1/serp/tasks/{task_id}.
  • No AI Overview (AIO) extraction and no answer-box guarantees.
  • No raw HTML or Markdown page output — responses are normalized JSON only.
  • Mobile results are not promised; device is a request hint on Google organic only.
  • No published SLA, uptime or success-rate figures, and not generally available (not GA).
  • Not the separate SEO API or Semrush SERP adapters — this is the /v1/serp/* surface only.

Frequently asked questions

Which search engines does the SERP API cover?

Organic results cover Google, Bing, Yahoo, DuckDuckGo, Baidu and Ecosia. News and Images verticals are Google only.

Is there an async mode?

Only for Google organic, news and images, via their /tasks endpoints. Results are retrieved by polling GET /v1/serp/tasks/{task_id}; there is no callback or webhook.

How is it billed?

Each successful search is charged at a display rate of 2 Credits per search; failed searches are not charged. Polling task status is free.

Can I call it today?

Partly. Google, Bing, Yahoo and DuckDuckGo organic are callable today with a Bearer API key. Baidu and Ecosia endpoints are opening soon; until they open, their requests return 503 service_unavailable and are not charged. Google images opening soon. The surface is not GA.

Start with one Bearer key

Create an API key in the console; the same Bearer key covers every SERP operation.

Get API keySee display pricingRead SERP API docs

API keys work today for Google, Bing, Yahoo and DuckDuckGo organic. Baidu and Ecosia endpoints opening soon.