Skip to content
SpideyData
Get API key

SERP guide · two meanings

Web Search API vs SERP API: Which Does Your App Need?

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

In 2026 “web search API” names two different products: search tools built for language models, and SERP APIs that return ranked results as JSON. Pick by what your code does with the response.

Get API keySee the SERP API overview →

Baidu and Ecosia endpoints opening soon.

Published · Updated

Two definitions side by side

Returns

LLM-oriented search tool: Context prepared for a model to read

SERP API (/v1/serp): Ranked rows: rank, title, url, snippet

Ranking

LLM-oriented search tool: Chosen by the tool

SERP API (/v1/serp): As shown on the engine's results page

Typical use

LLM-oriented search tool: Grounding an assistant's answer

SERP API (/v1/serp): Rank tracking, SEO checks, research datasets

You control

LLM-oriented search tool: The question

SERP API (/v1/serp): Engine, query, country (and hl for Google)

Calling /v1/serp from an agent tool

If your agent needs ranked results, a plain HTTP tool is enough. No SDK is required.

q

Engines: All

Rule: Required, 1–512 characters

country

Engines: All

Rule: 2–8 characters, default US

hl

Engines: Google, Ecosia

Rule: 2–16 characters, default en; other engines reject it

Tool definition sketch
{"name":"serp_search","method":"POST","url":"https://kieapi.com/v1/serp/bing/organic",
 "headers":{"Authorization":"Bearer <key>"},
 "body":{"q":"<string>","country":"<string>"}}

What /v1/serp is not

It does not summarize, rewrite or answer: it returns the results page as parsed rows. Your model reads those rows like any other tool output.

Launch status for this page

Check engine availability before choosing an endpoint. Google also supports News, Images and asynchronous tasks.

  • GoogleLiveGoogle is callable today with a Bearer API key.
  • BingLiveBing is callable today with a Bearer API key.
  • YahooLiveYahoo is callable today with a Bearer API key.
  • DuckDuckGoLiveDuckDuckGo is callable today with a Bearer API key.
  • BaiduOpening soonBaidu endpoints opening soon: until they open, requests return 503 service_unavailable and are not charged.
  • EcosiaOpening soonEcosia endpoints opening soon: until they open, requests return 503 service_unavailable and are not charged.

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.

Frequently asked questions

Is /v1/serp an LLM search tool?

No. It returns raw ranked results as JSON; it does not generate text.

Can an agent call it?

Yes, as an HTTP tool with a Bearer key and a JSON body of q and country (plus hl for Google).

Is there a free allowance?

No free API allowance; free browser tools are available.

Which engines can an agent call today?

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

Need ranked rows?

Give your app the results page as JSON, engine by engine.

Get API keySERP API overviewRead the SERP docs

Baidu and Ecosia endpoints opening soon.