Google historical rank overview

This endpoint will provide you with historical data on rankings and traffic of the specified domain, such as domain ranking distribution in SERPs and estimated. Needs target. Served by DataForSEO.

Inputs

1 required

Target: Domain required field the domain name of the target website the domain should be specified without https:// and wwwRequired · target
Location name: Full name of the location required field if you don't specify location_code Note: it is required to specify either…Optional · location_name
Location code: Location code required field if you don't specify location_name Note: it is required to specify either location_name…Optional · location_code
Language name: Full name of the language required field if you don't specify language_code Note: it is required to specify either…Optional · language_name
Language code: Language code required field if you don't specify language_name Note: it is required to specify either language_name…Optional · language_code
Date from: Starting date of the time range optional field if you don't specify this field, the data will be provided for the…Optional · date_from
Date to: Ending date of the time range optional field if you don't specify this field, the today's date will be used by default…Optional · date_to
Correlate: Correlate data with previously obtained datasets optional field default value: true if you use this parameter, our…Optional · correlate
Ignore synonyms: Ignore highly similar keywords optional field if set to true, only data based on core keywords will be returned, data…Optional · ignore_synonyms
Tag: User-defined task identifier optional field the character limit is 255 you can use this parameter to identify the task…Optional · tag

Pricing

Price: Usage based, at the cost the provider reports for the call
Billing: Billed at the cost the provider reports for the call, never above $100. Your agent sees the maximum before running.
Price checked: 10 October 2026

Call

Your agent reads the schema and the price with inspect_tool before it runs the tool.

MCP call
cURL command
TypeScript
Tool ID

Alternatives

Competitor domains & rankings

Playbooks that use it

Traffic drop diagnosisWhen rankings fell, which pages and keywords lost, what changed on those pages, and what Google announced that week.

Connect your agent to 2,400+ tools for free

Get $5 free credit Get $5 free credit