category_codeinteger · optionalGoogle Trends category code; omit for all categories.
minimum: 0
Back to Check keyword search volume
Google Trends
DataForSEO
Compare relative keyword interest over time or by region, and find related queries and topics.
Use this tool with your AI agent
- Copy the prompt
- Paste it into your agent
- Tell it what you need
Read https://scrollport.com/start. Use my existing Scrollport connection, or help me connect if needed. Help me use Google Trends (tool ID: dataforseo.google-trends). Ask me for the details you need, then show me the result.
- Already connected
- Your agent can use that connection.
- New user
- Your agent will guide you through setup, sign-in and authorisation.
Provider access is included.
Connect your first agent to receive $1 trial credit.
- Current price
- $0.0154/request
- Availability
- Ready to run
Tool details
About this tool
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.
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.