SERP API
Search Google, Ecosia, Bing, Yahoo, DuckDuckGo, and Baidu with SpideyData's SERP API. Google also accepts news, images, and async tasks that you poll by task id.
On this page
SERP API endpoints
12Find the task you need. Each endpoint includes its parameters, request example, and response reference.
Search Google and enqueue Google tasks
Run Google organic, news, or images searches, or create an async Google task and poll it from Async tasks.
Search Ecosia organic results
Run an Ecosia organic search and read normalized results.
Search Bing organic results
Run a Bing organic search and read normalized results.
Search Yahoo organic results
Run a Yahoo organic search and read normalized results.
Search DuckDuckGo organic results
Run a DuckDuckGo organic search and read normalized results.
Search Baidu organic results
Run a Baidu organic search and read normalized results.
Poll asynchronous SERP tasks
Read status and results for tasks created by the Google task endpoints. This is the poll step, not a search engine.
Quick start
Search Google organic, news, or images, or search Ecosia, Bing, Yahoo, DuckDuckGo, or Baidu. Only Google can enqueue tasks; poll GET /v1/serp/tasks/{task_id}. No callback delivery.
https://kieapi.comcurl -X POST "https://kieapi.com/v1/serp/google/organic" \
-H "Authorization: Bearer $SPIDER_API_KEY" \
-H 'Idempotency-Key: serp-example-01' \
-H "Content-Type: application/json" \
-d '{
"q": "example query",
"country": "US",
"hl": "en",
"device": "desktop"
}'Authentication
Team administrators manage API keys in Team Settings. Each key keeps its Team and billing scope when its creator leaves or switches Teams. Keys cannot manage members, billing or other keys. Public /v1 requests use Authorization: Bearer $SPIDER_API_KEY only; the Key's fixed Team is the payer. An optional X-Spider-Team-Id must match that Team or the request is denied. Creating, listing, rotating or revoking Keys through the product console (and other non-identity console business routes) requires X-Spider-Team-Id when the Team model is enabled; omitting it returns HTTP 409 team_context_required.
Response shape
Organic results for Google, Ecosia, Bing, Yahoo, DuckDuckGo, and Baidu. Google also returns news and images.
Google task endpoints return 202 and a task id. Poll GET /v1/serp/tasks/{task_id} until the job completes. Polling is not a search engine and does not add a charge.
Unavailable searches return an error and are not charged. Reuse the same Idempotency-Key after a lost response; check engine availability before retrying.