DataForSEO Keyword Trends Explore
From 1.4 credits/call
ae_dataforseo_keyword_trends_explore
View keyword popularity trends from DataForSEO for Google Search, News, and Shopping.
From 1.4 credits/call
Pricing
From 1.4 credits/call
| Condition | Charge |
|---|---|
| Each call | 1.4 credits |
A fixed fee applies to each call.
The starting price applies to a single query.
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[].type | string | null | No | No parameter description. | — |
tasks[].date_to | string | null | No | No parameter description. | — |
tasks[].keywords | array | No | <em>keywords</em><br><strong>required field</strong><br>the maximum number of keywords you can specify: 5<p>learn more about rules and limitations of <code>keyword</code> and <code>keywords</code> fields in DataForSEO APIs in this <a href="https://dataforseo.com/help-center/rules-and-limitations-of-keyword-and-keywords-fields-in-dataforseo-apis" rel="noopener noreferrer" target="_blank">Help Center article</a> | — |
tasks[].date_from | string | null | No | No parameter description. | — |
tasks[].time_range | string | null | No | No parameter description. | — |
tasks[].location_code | integer | null | No | No parameter description. | — |
tasks[].location_name | string | null | No | No parameter description. | — |
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_keyword_trends_explore' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"tasks": [
{
"item_types": [
"google_trends_graph"
],
"keywords": [
"iced latte",
"coffee bar",
"espresso martini",
"dirty soda",
"cold foam"
],
"location_code": 2840,
"time_range": "past_12_months"
}
]
}
}'Response exampleresponse.json
{
"cost": 0.0012,
"status_code": 20000,
"status_message": "Ok.",
"tasks": [
{
"cost": 0.0012,
"data": {
"api": "keywords_data",
"function": "explore",
"keywords": [
"iced latte"
],
"location_code": 2840,
"se": "dataforseo_trends",
"time_range": "past_12_months"
},
"id": "11160200-2802-0570-0000-981beca5b3a1",
"path": [
"v3"
],
"result": [
{
"datetime": "2026-11-16 02:01:29 +00:00",
"items": [
{}
],
"items_count": 1,
"keywords": [
"iced latte"
],
"language_code": null,
"type": "trends"
}
],
"result_count": 1
}
],
"tasks_count": 1,
"tasks_error": 0
}This example shows part of the response. Copied content is valid JSON.



