category_codeinteger · optionalGoogle Trends category code; omit for all categories.
minimum: 0
Google Trends
DataForSEO
Compare relative keyword interest over time or by region, and find related queries and topics.
- Capability
- Keyword demand research
- Current price
- $0.0154/request
- Availability
- Ready to run
What this API does
Get one Google Trends report per request: timeline, regional interest, related queries or related topics. Compare up to five keywords for one flat request price; related reports require exactly one keyword. Choose Google web, News, Images, Shopping or YouTube and a recent time window. Omit location_name for worldwide results. Interest scores are relative (0–100), not absolute search volumes. Zero/null may mean insufficient data, and missing_data marks incomplete periods. A completed sparse report is charged at the ordinary request price; failed requests are uncharged. The response explicitly identifies reports with no usable data. Shared Google Trends capacity can cause upstream limits; typical requests may take tens of seconds. For related topics, prefer web, News or YouTube. Google can omit related topics for Image Search and Shopping even for common keywords; choose related_queries for those searches instead.
Agents select this operation with tool ID dataforseo.google-trends, then check its current inputs and price before a run.
Inputs and outputs
Input
keywordsarray · requiredDistinct keywords without commas. Related-query/topic reports require exactly one.
minItems: 1 · maxItems: 5
language_namestring · optionalValue supplied for language name.
minLength: 1 · maxLength: 100
location_namestring · optionalFull region name such as United Kingdom or United States. Omit for worldwide.
minLength: 1 · maxLength: 200
report_typestring · optionalValue supplied for report type.
enum: timeline, regions, related_queries, related_topics
search_typestring · optionalValue supplied for search type.
enum: web, news, images, shopping, youtube
time_rangestring · optionalValue supplied for time range.
enum: past_hour, past_4_hours, past_day, past_7_days, past_30_days, past_90_days, past_12_months, past_5_years
Output
category_codenumberReturned category code value.
data_availablebooleanReturned data available value.
interpretationstringReturned interpretation value.
itemsarrayReturned items value.
items_countnumberReturned items count value.
keywordsarrayReturned keywords value.
language_namestringReturned language name value.
location_namestringReturned location name value.
report_typestringReturned report type value.
search_typestringReturned search type value.
sourcestringReturned source value.
time_rangestringReturned time range value.
Example request and output
Inspect returns this reviewed example, its estimated cost and the current input schema. Run calculates the estimate for your actual input.
Request
{
"tool_id": "dataforseo.google-trends",
"input": {
"keywords": [
"coffee",
"tea"
],
"time_range": "past_7_days",
"report_type": "timeline",
"search_type": "web",
"location_name": "United Kingdom"
}
}Output
{
"items": [
{
"data": [
{
"values": [
67,
33
],
"timestamp": 1788782400,
"missing_data": false
},
{
"values": [
63,
33
],
"timestamp": 1788786000,
"missing_data": false
},
{
"values": [
60,
34
],
"timestamp": 1788789600,
"missing_data": false
},
{
"values": [
56,
34
],
"timestamp": 1788793200,
"missing_data": false
},
{
"values": [
54,
36
],
"timestamp": 1788796800,
"missing_data": false
},
{
"values": [
53,
34
],
"timestamp": 1788800400,
"missing_data": false
},
{
"values": [
52,
35
],
"timestamp": 1788804000,
"missing_data": false
},
{
"values": [
55,
40
],
"timestamp": 1788807600,
"missing_data": false
},
{
"values": [
53,
42
],
"timestamp": 1788811200,
"missing_data": false
},
{
"values": [
53,
40
],
"timestamp": 1788814800,
"missing_data": false
},
{
"values": [
58,
38
],
"timestamp": 1788818400,
"missing_data": false
},
{
"values": [
57,
35
],
"timestamp": 1788822000,
"missing_data": false
},
{
"values": [
62,
33
],
"timestamp": 1788825600,
"missing_data": false
},
{
"values": [
65,
34
],
"timestamp": 1788829200,
"missing_data": false
},
{
"values": [
61,
36
],
"timestamp": 1788832800,
"missing_data": false
},
{
"values": [
73,
29
],
"timestamp": 1788836400,
"missing_data": false
},
{
"values": [
76,
35
],
"timestamp": 1788840000,
"missing_data": false
},
{
"values": [
73,
32
],
"timestamp": 1788843600,
"missing_data": false
},
{
"values": [
72,
33
],
"timestamp": 1788847200,
"missing_data": false
},
{
"values": [
77,
35
],
"timestamp": 1788850800,
"missing_data": false
},
{
"values": [
75,
33
],
"timestamp": 1788854400,
"missing_data": false
},
{
"values": [
71,
34
],
"timestamp": 1788858000,
"missing_data": false
},
{
"values": [
74,
35
],
"timestamp": 1788861600,
"missing_data": false
},
{
"values": [
70,
34
],
"timestamp": 1788865200,
"missing_data": false
},
{
"values": [
65,
34
],
"timestamp": 1788868800,
"missing_data": false
},
{
"values": [
58,
35
],
"timestamp": 1788872400,
"missing_data": false
},
{
"values": [
58,
35
],
"timestamp": 1788876000,
"missing_data": false
},
{
"values": [
52,
33
],
"timestamp": 1788879600,
"missing_data": false
},
{
"values": [
50,
33
],
"timestamp": 1788883200,
"missing_data": false
},
{
"values": [
47,
34
],
"timestamp": 1788886800,
"missing_data": false
},
{
"values": [
46,
34
],
"timestamp": 1788890400,
"missing_data": false
},
{
"values": [
49,
36
],
"timestamp": 1788894000,
"missing_data": false
},
{
"values": [
48,
36
],
"timestamp": 1788897600,
"missing_data": false
},
{
"values": [
48,
34
],
"timestamp": 1788901200,
"missing_data": false
},
{
"values": [
55,
34
],
"timestamp": 1788904800,
"missing_data": false
},
{
"values": [
49,
36
],
"timestamp": 1788908400,
"missing_data": false
},
{
"values": [
52,
30
],
"timestamp": 1788912000,
"missing_data": false
},
{
"values": [
61,
31
],
"timestamp": 1788915600,
"missing_data": false
},
{
"values": [
68,
33
],
"timestamp": 1788919200,
"missing_data": false
},
{
"values": [
74,
36
],
"timestamp": 1788922800,
"missing_data": false
},
{
"values": [
71,
36
],
"timestamp": 1788926400,
"missing_data": false
},
{
"values": [
70,
34
],
"timestamp": 1788930000,
"missing_data": false
},
{
"values": [
68,
33
],
"timestamp": 1788933600,
"missing_data": false
},
{
"values": [
73,
35
],
"timestamp": 1788937200,
"missing_data": false
},
{
"values": [
71,
35
],
"timestamp": 1788940800,
"missing_data": false
},
{
"values": [
72,
33
],
"timestamp": 1788944400,
"missing_data": false
},
{
"values": [
65,
34
],
"timestamp": 1788948000,
"missing_data": false
},
{
"values": [
62,
36
],
"timestamp": 1788951600,
"missing_data": false
},
{
"values": [
61,
35
],
"timestamp": 1788955200,
"missing_data": false
},
{
"values": [
54,
35
],
"timestamp": 1788958800,
"missing_data": false
},
{
"values": [
51,
34
],
"timestamp": 1788962400,
"missing_data": false
},
{
"values": [
52,
35
],
"timestamp": 1788966000,
"missing_data": false
},
{
"values": [
50,
34
],
"timestamp": 1788969600,
"missing_data": false
},
{
"values": [
47,
34
],
"timestamp": 1788973200,
"missing_data": false
},
{
"values": [
45,
34
],
"timestamp": 1788976800,
"missing_data": false
},
{
"values": [
42,
37
],
"timestamp": 1788980400,
"missing_data": false
},
{
"values": [
46,
37
],
"timestamp": 1788984000,
"missing_data": false
},
{
"values": [
47,
36
],
"timestamp": 1788987600,
"missing_data": false
},
{
"values": [
48,
34
],
"timestamp": 1788991200,
"missing_data": false
},
{
"values": [
51,
31
],
"timestamp": 1788994800,
"missing_data": false
},
{
"values": [
51,
31
],
"timestamp": 1788998400,
"missing_data": false
},
{
"values": [
52,
29
],
"timestamp": 1789002000,
"missing_data": false
},
{
"values": [
57,
32
],
"timestamp": 1789005600,
"missing_data": false
},
{
"values": [
60,
33
],
"timestamp": 1789009200,
"missing_data": false
},
{
"values": [
66,
32
],
"timestamp": 1789012800,
"missing_data": false
},
{
"values": [
76,
35
],
"timestamp": 1789016400,
"missing_data": false
},
{
"values": [
73,
33
],
"timestamp": 1789020000,
"missing_data": false
},
{
"values": [
72,
35
],
"timestamp": 1789023600,
"missing_data": false
},
{
"values": [
71,
34
],
"timestamp": 1789027200,
"missing_data": false
},
{
"values": [
69,
35
],
"timestamp": 1789030800,
"missing_data": false
},
{
"values": [
67,
35
],
"timestamp": 1789034400,
"missing_data": false
},
{
"values": [
66,
34
],
"timestamp": 1789038000,
"missing_data": false
},
{
"values": [
63,
34
],
"timestamp": 1789041600,
"missing_data": false
},
{
"values": [
59,
34
],
"timestamp": 1789045200,
"missing_data": false
},
{
"values": [
52,
33
],
"timestamp": 1789048800,
"missing_data": false
},
{
"values": [
47,
36
],
"timestamp": 1789052400,
"missing_data": false
},
{
"values": [
48,
36
],
"timestamp": 1789056000,
"missing_data": false
},
{
"values": [
48,
36
],
"timestamp": 1789059600,
"missing_data": false
},
{
"values": [
47,
36
],
"timestamp": 1789063200,
"missing_data": false
},
{
"values": [
48,
35
],
"timestamp": 1789066800,
"missing_data": false
},
{
"values": [
52,
40
],
"timestamp": 1789070400,
"missing_data": false
},
{
"values": [
50,
40
],
"timestamp": 1789074000,
"missing_data": false
},
{
"values": [
53,
38
],
"timestamp": 1789077600,
"missing_data": false
},
{
"values": [
52,
34
],
"timestamp": 1789081200,
"missing_data": false
},
{
"values": [
61,
36
],
"timestamp": 1789084800,
"missing_data": false
},
{
"values": [
65,
35
],
"timestamp": 1789088400,
"missing_data": false
},
{
"values": [
64,
34
],
"timestamp": 1789092000,
"missing_data": false
},
{
"values": [
72,
41
],
"timestamp": 1789095600,
"missing_data": false
},
{
"values": [
75,
35
],
"timestamp": 1789099200,
"missing_data": false
},
{
"values": [
73,
33
],
"timestamp": 1789102800,
"missing_data": false
},
{
"values": [
76,
34
],
"timestamp": 1789106400,
"missing_data": false
},
{
"values": [
76,
34
],
"timestamp": 1789110000,
"missing_data": false
},
{
"values": [
73,
35
],
"timestamp": 1789113600,
"missing_data": false
},
{
"values": [
70,
36
],
"timestamp": 1789117200,
"missing_data": false
},
{
"values": [
64,
34
],
"timestamp": 1789120800,
"missing_data": false
},
{
"values": [
65,
37
],
"timestamp": 1789124400,
"missing_data": false
},
{
"values": [
59,
34
],
"timestamp": 1789128000,
"missing_data": false
},
{
"values": [
57,
33
],
"timestamp": 1789131600,
"missing_data": false
},
{
"values": [
52,
36
],
"timestamp": 1789135200,
"missing_data": false
},
{
"values": [
49,
35
],
"timestamp": 1789138800,
"missing_data": false
},
{
"values": [
46,
34
],
"timestamp": 1789142400,
"missing_data": false
},
{
"values": [
46,
34
],
"timestamp": 1789146000,
"missing_data": false
},
{
"values": [
43,
39
],
"timestamp": 1789149600,
"missing_data": false
},
{
"values": [
48,
37
],
"timestamp": 1789153200,
"missing_data": false
},
{
"values": [
48,
37
],
"timestamp": 1789156800,
"missing_data": false
},
{
"values": [
50,
37
],
"timestamp": 1789160400,
"missing_data": false
},
{
"values": [
49,
32
],
"timestamp": 1789164000,
"missing_data": false
},
{
"values": [
44,
32
],
"timestamp": 1789167600,
"missing_data": false
},
{
"values": [
46,
33
],
"timestamp": 1789171200,
"missing_data": false
},
{
"values": [
52,
32
],
"timestamp": 1789174800,
"missing_data": false
},
{
"values": [
54,
39
],
"timestamp": 1789178400,
"missing_data": false
},
{
"values": [
68,
43
],
"timestamp": 1789182000,
"missing_data": false
},
{
"values": [
69,
40
],
"timestamp": 1789185600,
"missing_data": false
},
{
"values": [
78,
33
],
"timestamp": 1789189200,
"missing_data": false
},
{
"values": [
90,
39
],
"timestamp": 1789192800,
"missing_data": false
},
{
"values": [
95,
43
],
"timestamp": 1789196400,
"missing_data": false
},
{
"values": [
94,
43
],
"timestamp": 1789200000,
"missing_data": false
},
{
"values": [
91,
43
],
"timestamp": 1789203600,
"missing_data": false
},
{
"values": [
84,
41
],
"timestamp": 1789207200,
"missing_data": false
},
{
"values": [
79,
42
],
"timestamp": 1789210800,
"missing_data": false
},
{
"values": [
73,
42
],
"timestamp": 1789214400,
"missing_data": false
},
{
"values": [
67,
43
],
"timestamp": 1789218000,
"missing_data": false
},
{
"values": [
62,
38
],
"timestamp": 1789221600,
"missing_data": false
},
{
"values": [
60,
40
],
"timestamp": 1789225200,
"missing_data": false
},
{
"values": [
54,
37
],
"timestamp": 1789228800,
"missing_data": false
},
{
"values": [
53,
39
],
"timestamp": 1789232400,
"missing_data": false
},
{
"values": [
50,
39
],
"timestamp": 1789236000,
"missing_data": false
},
{
"values": [
47,
37
],
"timestamp": 1789239600,
"missing_data": false
},
{
"values": [
46,
36
],
"timestamp": 1789243200,
"missing_data": false
},
{
"values": [
45,
35
],
"timestamp": 1789246800,
"missing_data": false
},
{
"values": [
47,
32
],
"timestamp": 1789250400,
"missing_data": false
},
{
"values": [
41,
29
],
"timestamp": 1789254000,
"missing_data": false
},
{
"values": [
44,
30
],
"timestamp": 1789257600,
"missing_data": false
},
{
"values": [
43,
30
],
"timestamp": 1789261200,
"missing_data": false
},
{
"values": [
47,
31
],
"timestamp": 1789264800,
"missing_data": false
},
{
"values": [
47,
30
],
"timestamp": 1789268400,
"missing_data": false
},
{
"values": [
59,
32
],
"timestamp": 1789272000,
"missing_data": false
},
{
"values": [
72,
31
],
"timestamp": 1789275600,
"missing_data": false
},
{
"values": [
87,
37
],
"timestamp": 1789279200,
"missing_data": false
},
{
"values": [
99,
44
],
"timestamp": 1789282800,
"missing_data": false
},
{
"values": [
100,
44
],
"timestamp": 1789286400,
"missing_data": false
},
{
"values": [
97,
42
],
"timestamp": 1789290000,
"missing_data": false
},
{
"values": [
89,
43
],
"timestamp": 1789293600,
"missing_data": false
},
{
"values": [
81,
42
],
"timestamp": 1789297200,
"missing_data": false
},
{
"values": [
73,
42
],
"timestamp": 1789300800,
"missing_data": false
},
{
"values": [
72,
43
],
"timestamp": 1789304400,
"missing_data": false
},
{
"values": [
65,
39
],
"timestamp": 1789308000,
"missing_data": false
},
{
"values": [
57,
36
],
"timestamp": 1789311600,
"missing_data": false
},
{
"values": [
53,
37
],
"timestamp": 1789315200,
"missing_data": false
},
{
"values": [
47,
37
],
"timestamp": 1789318800,
"missing_data": false
},
{
"values": [
49,
35
],
"timestamp": 1789322400,
"missing_data": false
},
{
"values": [
50,
39
],
"timestamp": 1789326000,
"missing_data": false
},
{
"values": [
54,
37
],
"timestamp": 1789329600,
"missing_data": false
},
{
"values": [
49,
36
],
"timestamp": 1789333200,
"missing_data": false
},
{
"values": [
53,
31
],
"timestamp": 1789336800,
"missing_data": false
},
{
"values": [
57,
34
],
"timestamp": 1789340400,
"missing_data": false
},
{
"values": [
54,
37
],
"timestamp": 1789344000,
"missing_data": false
},
{
"values": [
56,
32
],
"timestamp": 1789347600,
"missing_data": false
},
{
"values": [
59,
34
],
"timestamp": 1789351200,
"missing_data": false
},
{
"values": [
83,
32
],
"timestamp": 1789354800,
"missing_data": false
},
{
"values": [
60,
34
],
"timestamp": 1789358400,
"missing_data": false
},
{
"values": [
70,
33
],
"timestamp": 1789362000,
"missing_data": false
},
{
"values": [
68,
31
],
"timestamp": 1789365600,
"missing_data": false
},
{
"values": [
98,
32
],
"timestamp": 1789369200,
"missing_data": false
},
{
"values": [
71,
31
],
"timestamp": 1789372800,
"missing_data": false
},
{
"values": [
69,
34
],
"timestamp": 1789376400,
"missing_data": false
},
{
"values": [
70,
34
],
"timestamp": 1789380000,
"missing_data": false
},
{
"values": [
67,
34
],
"timestamp": 1789383600,
"missing_data": false
},
{
"values": [
61,
36
],
"timestamp": 1789387200,
"missing_data": true
}
],
"type": "google_trends_graph",
"title": null,
"averages": [
61,
35
],
"keywords": [
"coffee",
"tea"
]
}
],
"source": "google_trends",
"keywords": [
"coffee",
"tea"
],
"time_range": "past_7_days",
"items_count": 1,
"report_type": "timeline",
"search_type": "web",
"category_code": 0,
"language_name": "English",
"location_name": "United Kingdom",
"data_available": true,
"interpretation": "Interest scores are relative (0–100), not search volumes. Timeline timestamp is the bucket start in Unix seconds (UTC). Zero or null can mean insufficient data; missing_data marks incomplete periods. Related rising values represent growth and may say Breakout."
}Errors and limitations
invalid_input: The keyword list or report options are invalid.Use 1–5 distinct keywords without commas; related reports require exactly one keyword.rate_limited: The supplier's shared Google Trends capacity is temporarily limited.The wallet was not charged. Wait before making a new request.upstream_timeout: The Google Trends report did not complete within the time limit.The wallet was not charged. Check the existing Scrollport run before starting another request.
Use Google Trends with Scrollport
Use verified tools with pay-per-use pricing. Provider access is included. Tools that work in your own apps ask you to connect that account.
Connect your first agent to receive $1 trial credit.