SERP guide · suite vs raw
Semrush SERP API vs a Pure SERP API
Semrush's API is part of an SEO suite; a pure SERP API returns the live results page as JSON. They overlap less than the names suggest.
Baidu and Ecosia endpoints opening soon.
Published · Updated
Suite data vs raw results
What it returns
SEO-suite API (such as Semrush): Suite datasets; see Semrush's API docs
Pure SERP API (/v1/serp): The live results page as rows
Freshness
SEO-suite API (such as Semrush): As defined by the suite
Pure SERP API (/v1/serp): Fetched per request
Access
SEO-suite API (such as Semrush): Through the suite's own API access
Pure SERP API (/v1/serp): A SpideyData Bearer key
Not an adapter
/v1/serp does not proxy, resell or wrap Semrush. It returns no Semrush data and needs no Semrush subscription: every response comes from a results page fetched for your request.
When raw results are the better fit
- You need the page as it looks now for your own query list.
- You need several engines in one response shape.
- You want to store and score positions in your own database.
Launch status for this page
Check engine availability before choosing an endpoint. Google also supports News, Images and asynchronous tasks.
- GoogleGoogle is callable today with a Bearer API key.
- BingBing is callable today with a Bearer API key.
- YahooYahoo is callable today with a Bearer API key.
- DuckDuckGoDuckDuckGo is callable today with a Bearer API key.
- BaiduBaidu endpoints opening soon: until they open, requests return 503 service_unavailable and are not charged.
- EcosiaEcosia 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
Does /v1/serp include Semrush data?
No. It returns live results pages only.
Do I need a Semrush account?
No. A SpideyData API key is all /v1/serp needs.
Which engines does /v1/serp return?
Organic from Google, Bing, Yahoo, DuckDuckGo, Baidu and Ecosia, plus Google News and Google Images.
Which engines are open now?
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.
Want the raw page?
Rows straight from the results page, for the queries you choose.
Baidu and Ecosia endpoints opening soon.