Google historical SERPs

This endpoint will provide you with Google SERPs collected within the specified time frame. Needs keyword. Served by DataForSEO.

Inputs

1 required

Keyword: Keyword required field you can specify up to 700 characters in the keyword field; all %## will be decoded (plus…Required · keyword
Date from: Starting date of the time range optional field if you don't specify this field, the API will return all SERPs…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…Optional · date_to
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: Unique location identifier required field if you don't specify location_name Note: it is required to specify either…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: Unique language identifier required field if you don't specify language_name Note: it is required to specify either…Optional · language_code
Tag: User-defined task identifier optional field the character limit is 255 you can use this parameter to identify the task…Optional · tag

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

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

Competitor domains & rankings