
One call returns historical Google search results for a keyword on a specific date, showing organic results, product listings, and other SERP features. Each item in the answer is a search result (organic link, product, or feature) with its ranking position and traffic estimate. The sample shows 114 results from one search.
2 live routes on DataForSEO, from $0.00012 per call. Every route below answered our last live test on 2026-10-06; the gateway re-tests them daily.
The upstream price you are metered at, cheapest first. A route without a published price says so.
| Provider | Endpoint | Price |
|---|---|---|
Historical Google results for a keywordCHEAPESTPOST dataforseo_labs/google/historical_serps/live | $0.00012$0.12 / 1k calls | |
Web pages that mention a keywordPOST content_analysis/search/live | $0.02436$24.36 / 1k calls |
From a real call to the cheapest route: DataForSEO.
tasks[].result[].keywordKeyword searchedtasks[].result[].datetimeDate and time of the SERP snapshottasks[].result[].items[].items[].urlURL of the ranking resulttasks[].result[].items[].items[].titleTitle of the resulttasks[].result[].items[].items[].rank_absoluteAbsolute ranking positiontasks[].result[].items[].items[].etvEstimated traffic value for this resulttasks[].result[].items[].items[].typeType of result (organic, popular_products, etc.)tasks[].result[].se_results_countTotal results shown for the keywordHTTP with your key in x-api-key, or the call_endpoint tool of our MCP server.
| Parameter | Type | Notes | |
|---|---|---|---|
| keyword | str · body | JSON body field | e.g. "pokemon cards" |
| date_from | str · body | JSON body field | e.g. "2026-06-01" |
| language_code | str · body | JSON body field | e.g. "en" |
| location_code | int · body | JSON body field | e.g. 2840 |
curl -X POST "https://fetchapi.co/api/gw/dataforseo/dataforseo_labs/google/historical_serps/live" \
-H "x-api-key: YOUR_KEY" -H "content-type: application/json" \
-d '[{"keyword": "pokemon cards", "date_from": "2026-06-01", "language_code": "en", "location_code": 2840}]'call_endpoint("dataforseo.dataforseo_labs_google_historical_serps", {}, [{"keyword": "pokemon cards", "date_from": "2026-06-01", "language_code": "en", "location_code": 2840}]){
"cost": 0.00012,
"time": "0.1551 sec.",
"tasks": [
{
"id": "10040440-2697-0408-0000-789e92049fcc",
"cost": 0.00012,
"data": {
"api": "dataforseo_labs",
"keyword": "pokemon cards",
"se_type": "google",
"function": "historical_serps",
"date_from": "2026-06-01",
"language_code": "en",
"location_code": 2840
},
"path": [
"v3",
"dataforseo_labs",
"… 2 more"
],
"time": "0.1442 sec.",
"result": [
{
"items": [
{
"type": "…",
"items": "…",
"spell": "…",
"keyword": "…",
"se_type": "…",
"datetime": "…",
"check_url": "…",
"se_domain": "…",
"item_types": "…",
"items_count": "…",
"language_code": "…",
"location_code": "…",
"se_results_count": "…"
}
],
"keyword": "pokemon cards",
"se_type": "google",
"items_count": 1,
"total_count": 1,
"language_code": "en",
"location_code": 2840
}
],
"status_code": 20000,
"result_count": 1,
"status_message": "Ok."
}
],
"version": "0.1.20260917",
"status_code": 20000,
"tasks_count": 1,
"tasks_error": 0,
"status_message": "Ok."
}| Parameter | Type | Notes | |
|---|---|---|---|
| limit | int · body | JSON body field | e.g. 10 |
| keyword | str · body | JSON body field | e.g. "pokemon cards" |
curl -X POST "https://fetchapi.co/api/gw/dataforseo/content_analysis/search/live" \
-H "x-api-key: YOUR_KEY" -H "content-type: application/json" \
-d '[{"limit": 10, "keyword": "pokemon cards"}]'call_endpoint("dataforseo.content_analysis_search", {}, [{"limit": 10, "keyword": "pokemon cards"}])Call it over HTTP or from any MCP client. Each key has a rate limit and a monthly cap; calls are metered at the upstream price.