DataForSEO Labs Google Historical Serps

From 0.2 credits/call
ae_dataforseo_labs_google_historical_serps

View historical Google search results, rankings, and featured snippets for a keyword over time using DataForSEO.

Search
From 0.2 credits/call

Pricing

From 0.2 credits/call
ConditionCharge
Each returned historical search snapshot0.2 credits

Charges depend on the number of historical search snapshots actually returned.

The starting price applies to one returned snapshot. No charge applies when no snapshots are returned.

Parameters

Optional parameters use the platform defaults when omitted.

ParameterTypeRequiredDescriptionDefault
tasksarrayYesNo parameter description.—
tasks[].tagstring | nullNoNo parameter description.—
tasks[].date_tostring | nullNoNo parameter description.—
tasks[].keywordstringNo<em>keyword</em><br><strong>required field</strong><br>you can specify <strong>up to 700 characters</strong> in the <code>keyword</code> field;<br>all %## will be decoded (plus character ‘+’ will be decoded to a space character);<br>if you need to use the “%” character for your <code>keyword</code>, please specify it as “%25”;<br>if you need to use the “+” character for your <code>keyword</code>, please specify it as “%2B”—
tasks[].date_fromstring | nullNoNo parameter description.—
tasks[].language_codestring | nullNoNo parameter description.—
tasks[].language_namestringNo<em>full name of the language</em><br><strong>required field if you don't specify</strong> <code>language_code</code><br><strong>Note:</strong> it is required to specify either <code>language_name</code> or <code>language_code</code><br>you can receive the list of available languages with their <code>language_name</code> parameters by making a separate request to the <br><code>https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages</code><br>example:<br><code class="long-string">English</code>—
tasks[].location_codeintegerNo<em>unique location identifier</em><br><strong>required field if you don't specify</strong> <code>location_name</code><br><strong>Note:</strong> it is required to specify either <code>location_name</code> or <code>location_code</code><br>you can receive the list of available locations with their <code>location_code</code> by making a separate request to <code>https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages</code><br>example:<br><code class="long-string">2840</code>—
tasks[].location_namestringNo<em>full name of the location</em><br><strong>required field if you don't specify</strong> <code>location_code</code><br><strong>Note:</strong> it is required to specify either <code>location_name</code> or <code>location_code</code><br>you can receive the list of available locations with their <code>location_name</code> by making a separate request to <code>https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages</code><br>example:<br><code class="long-string">United Kingdom</code>—

Invocation example

Copy the request and explore its response example.

POST/agent-api/v1/tool/executeX-Api-Key
Request coderequest.sh
curl --request POST \
  --url 'https://agentearth.ai/agent-api/v1/tool/execute?tool_name=ae_dataforseo_labs_google_historical_serps' \
  --header "X-Api-Key: $AGENTEARTH_API_KEY" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "params": {
    "tasks": [
      {
        "date_from": "2026-07-01",
        "keyword": "intelligent transportation system",
        "language_code": "en",
        "location_code": 2840
      }
    ]
  }
}'
Response exampleresponse.json
JSONPartial content
{
  "cost": 0,
  "status_code": 20000,
  "status_message": "Ok.",
  "tasks": [
    {
      "cost": 0,
      "data": {
        "api": "dataforseo_labs",
        "date_from": "2026-07-01",
        "function": "historical_serps",
        "keyword": "intelligent transportation system",
        "language_code": "en",
        "location_code": 2840
      },
      "id": "10281753-2802-0408-0000-14a449a23409",
      "path": [
        "v3"
      ],
      "result": [
        {
          "items": null,
          "items_count": 0,
          "keyword": "intelligent transportation system",
          "language_code": "en",
          "location_code": 2840,
          "se_type": "google"
        }
      ],
      "result_count": 1
    }
  ],
  "tasks_count": 1,
  "tasks_error": 0
}

This example shows part of the response. Copied content is valid JSON.