All tools
get-google-trendsstarterCompetitors & Domain Intelligence

Get Google Trends Tool

Get Google Trends explore data for up to 5 keywords. Returns popularity data over time from Google Trends for Google Search, News, Images, Shopping, or YouTube. Supports preset time ranges or custom date ranges, and can return trend graphs, geographic maps, related topics, or related queries.

Workflow guide: Reference & Utilities

Parameters

NameTypeRequiredDescription
keywordsarrayrequiredKeywords to explore (1-5). Use 1 keyword for topics/queries lists.
location_namestringoptionalLocation name (e.g. "United States", "United Kingdom"). Defaults to worldwide.
language_codestringoptionalTwo-letter ISO language code (e.g. "en", "es").
typestringoptionalGoogle Trends type: web, news, youtube, images, or froogle (Shopping). Defaults to web.
time_rangestringoptionalPreset time range: past_hour, past_4_hours, past_day, past_7_days, past_30_days, past_90_days, past_12_months, past_5_years. Ignored if date_from/date_to are set.
date_fromstringoptionalCustom start date in YYYY-MM-DD format. Minimum 2004-01-01 for web, 2008-01-01 for others.
date_tostringoptionalCustom end date in YYYY-MM-DD format. Defaults to today.
category_codeintegeroptionalGoogle Trends category code to filter results.
item_typesarrayoptionalTypes of data to return: google_trends_graph, google_trends_map, google_trends_topics_list, google_trends_queries_list. Defaults to graph only.

Plan access

Available on the starter tier and above. Live tools draw from your team's monthly credit budget at parity with upstream API cost (1 credit ≈ $0.001).

See plans