Skip to main content
POST /v1/data/ahrefs/serp-overview/run Pricing: $0.03 per ranked result ($26.00 per 1,000).

Request

Send the inputs under params. Only the keys below are accepted; any other key returns 422 invalid_params.
string[]
required
Search keywords to look up in the stored SERP snapshot.
string
default:"us"
Country whose Google results to read, e.g. United States. Defaults to United States.249 allowed values, for example af (Afghanistan), al (Albania), dz (Algeria), as (American Samoa), ad (Andorra), ao (Angola), ai (Anguilla), aq (Antarctica), ag (Antigua and Barbuda), ar (Argentina). Fetch the full list with GET /v1/data/ahrefs/serp-overview?expand=options.
date
A historic date to retrieve an older SERP snapshot instead of the latest one.
integer
default:"10"
How many ranked results to return in total. Defaults to 10; use 0 for all.Max 100.

Example

Response fields

Each row in data is one ranked result, keyed by these fields.

Example response

Abridged: long text and lists are shortened.
For the live Google results page use google/search; for links pointing at a domain use web/backlinks.