Search interest over time
dataforseo/keywords_google_trends_explore_liveCompare relative search interest for up to five terms.
- call
- $0.15
- DataForSEO
- 3 min
Overview
Reports how search interest in a set of terms has moved over time, as a relative popularity index rather than absolute counts. Up to five terms can be compared in one call, returning a value at each interval in the chosen range with explicit markers where data is missing, plus averages across the period. A geographic breakdown shows which regions searched most for each term, and related topic and query lists reveal what people search alongside them. The trend can be drawn from web, news, video, image, or shopping search, which gives materially different pictures for the same term.
A time series of relative interest per term, with averages, and any regional, topic, or query blocks requested.
Input
These go in the input object of the run request.
| Field | Type | Required | Description |
|---|---|---|---|
| keywords | array | Yes | The terms to compare, up to five. |
| location_name | string | No | Which market to report on; omit for worldwide interest. |
| type | string | No | Which search property to draw the trend from. |
| time_range | string | No | A preset window, ignored when explicit dates are given. |
| date_from | string | No | Start of the range, as `YYYY-MM-DD`. |
| date_to | string | No | End of the range, as `YYYY-MM-DD`. |
| item_types | array | No | Which blocks to return: the graph, the map, topics, or queries. |
Requests up to 1 MB.
Example
A call that works, with your own key.
curl https://gateway.agentsky.dev/v1/run \
-H "authorization: Bearer $AGENTSKY_API_KEY" \
-H "content-type: application/json" \
-d '{"provider":"dataforseo","endpoint":"keywords_google_trends_explore_live","input":{"keywords":["rugby","cricket"],"location_name":"United States","time_range":"past_12_months","item_types":["google_trends_graph"]}}'Pricing
$0.15 per call on the default plan. That is the list price; when the provider reports what a call actually cost, you are billed that instead. Every run carries its price in the response.