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.
From 0.2 credits/call
Pricing
From 0.2 credits/call
| Condition | Charge |
|---|---|
| Each returned historical search snapshot | 0.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.
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
tasks | array | Yes | No parameter description. | — |
tasks[].tag | string | null | No | No parameter description. | — |
tasks[].date_to | string | null | No | No parameter description. | — |
tasks[].keyword | string | No | <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_from | string | null | No | No parameter description. | — |
tasks[].language_code | string | null | No | No parameter description. | — |
tasks[].language_name | string | No | <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_code | integer | No | <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_name | string | No | <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-KeyRequest 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
{
"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.

