DataForSEO Content Analysis Phrase Trends
From 28.8 credits/call
ae_dataforseo_content_analysis_phrase_trends
Track how often a keyword is cited in online content over time using DataForSEO. Analyze mention trends by day, week, or month within a specific date range.
From 28.8 credits/call
Pricing
From 28.8 credits/call
| Condition | Charge |
|---|---|
| Base processing fee per call | 28.8 credits |
| Per record | 0.1 credits |
Charges depend on the actual returned results.
The starting price is the base query fee; returned records add the listed charges.
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>target keyword</em><br><strong>required field</strong><br>UTF-8 encoding<br>the keywords will be converted to a lowercase format;<br><strong>Note</strong>: to match an exact phrase instead of a stand-alone keyword, use double quotes and backslashes; <br>example: <br><code>"keyword": "\"tesla palo alto\""</code><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 | No | <em>starting date of the time range</em><br><strong>required field</strong><br>date format: <code>"yyyy-mm-dd"</code><br>example:<br><code>"2019-01-15"</code> | — |
tasks[].page_type | array | null | No | No parameter description. | — |
tasks[].date_group | string | null | No | No parameter description. | — |
tasks[].rank_scale | string | null | No | No parameter description. | — |
tasks[].search_mode | string | null | No | No parameter description. | — |
tasks[].keyword_fields | object | null | No | No parameter description. | — |
tasks[].internal_list_limit | integer | null | No | No parameter description. | — |
tasks[].initial_dataset_filters | array | 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_content_analysis_phrase_trends' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"tasks": [
{
"date_from": "2026-10-23",
"date_group": "day",
"date_to": "2026-10-24",
"internal_list_limit": 1,
"keyword": "OpenAI"
}
]
}
}'Response exampleresponse.json
{
"cost": 0.024072,
"status_code": 20000,
"status_message": "Ok.",
"tasks": [
{
"cost": 0.024072,
"data": {
"api": "content_analysis",
"date_from": "2026-10-23",
"date_group": "day",
"date_to": "2026-10-24",
"function": "phrase_trends",
"internal_list_limit": 1
},
"id": "10261118-2802-0467-0000-46578b7d8e62",
"path": [
"v3"
],
"result": [
{
"connotation_types": {
"negative": 22228,
"neutral": 7059,
"positive": 17207
},
"countries": {
"AI": 8333
},
"date": "2026-10-23",
"languages": {
"en": 27103
},
"page_categories": [
{}
],
"type": "content_analysis_trends"
}
],
"result_count": 2
}
],
"tasks_count": 1,
"tasks_error": 0
}This example shows part of the response. Copied content is valid JSON.


