Google Trends Scraper & API - Compare up to 500 Keywords
Pricing
from $3.00 / 1,000 keyword with data
Google Trends scraper and API for up to 500 keywords on one 0-100 scale, past Google's limit of 5. Interest over time, interest by region, top and rising related queries, change % and busiest month. Web, YouTube, News, Images or Shopping. For SEO and product research; no-data keywords are free.
Keyword
keyword
Optional
The search term, as you typed it (shortened to 100 characters plus ... on the invalid_input row of a keyword that is too long). Blank only on a run note row (bad settings or the cost limit).
Status
status
Optional
ok = data returned (charged). no_data = Google has too little data for this keyword with these settings; try a longer range, worldwide or no category (free). blocked = Google kept refusing the lookup or the proxy couldn't connect; run just those keywords again later (free). invalid_input = a bad keyword (e.g. over 100 characters) or bad settings; the note says what to fix (free). charge_limit_reached = the run hit its cost limit; the note lists the keywords not returned (free).
Average interest
average
Optional
Average 0-100 interest over the whole range, not counting the current week (or day, hour) that isn't over yet. With Compare on it is on the shared scale, so averages compare between rows.
Latest interest
latest
Optional
Interest at the newest finished point (week, day or hour), 0-100. On the shared scale with Compare on.
Latest date
latestDate
Optional
Date of the newest finished point. Weekly points are dated by the Sunday the week starts on.
Change %
changePct
Optional
How much interest went up or down, in percent, between the two periods named in changeBasis. Always from the keyword's own scale, so it is right for small keywords too. Blank when the earlier period had no searches.
Compared periods
changeBasis
Optional
The two periods changePct compares: the last 12 months vs the previous 12 for ranges of 2 years or more (custom dates too), otherwise the second half vs the first half.
Trend
trend
Optional
rising (changePct +10% or more), falling (-10% or less) or stable. Blank when the earlier period had no searches, so there is nothing to compare with.
Peak interest
peak
Optional
Interest at peakDate, 0-100. On the shared scale with Compare on, so only the busiest keyword reaches 100.
Peak date
peakDate
Optional
When interest was highest (first time, if it repeats), from the keyword's own scale. Same format as timeline dates: the first day of the peak week or month, or a UTC time for 24-hour and 7-day ranges.
Busiest month
seasonalPeakMonth
Optional
The month that was busiest in most full years. Needs 3 or more full years (Past 5 years or Since 2004). Two months that tie are both given, e.g. November/December. Blank when there's no clear yearly peak.
Estimated monthly searches
estimatedMonthlySearches
Optional
Only when you entered the monthly searches of your first keyword: this keyword's average of the last 12 months scaled from that number, rounded (e.g. 450,000 instead of 451,237). A rough estimate, not a Google count.
On one scale
comparedOnOneScale
Optional
true when Compare was on and the run had more than one keyword, so average, latest and peak compare between rows.
Compare quality
compareQuality
Optional
direct = in the same Google request as the busiest of your first 5 keywords. linked = brought onto the shared scale through a keyword both groups had, reliable. rough = that shared keyword was tiny in its group, so average, latest and peak can be off by more than 10%. own scale = Compare was off (or there was one keyword), so the numbers don't compare between rows.
Country code
country
Optional
Google's code for the place you chose (US, US-CA, US-CA-807). Blank for worldwide.
Country
countryName
Optional
The place in words.
Time range
timeRange
Optional
The time range in words.
Search type
searchType
Optional
web, youtube, news, images or shopping.
Category
category
Optional
The Google Trends category, or All categories.
Interest over time
timeline
Optional
Every point in the range, oldest first: {date, value, partial}. date is the first day of the day, week or month (YYYY-MM-DD), or a UTC time (YYYY-MM-DDTHH:MM:SSZ) for 24-hour and 7-day ranges; points come every 8 minutes, hour, day, week or month depending on the range. value is 0-100, on the shared scale when Compare is on. partial: true appears only on the newest point while that week, day or hour isn't over, so don't read a dip into it. Blank when Include the timeline is off.
Region level
regionLevel
Optional
What the regions list holds: country, state/province, metro or city. (The input value "region" comes back as state/province.)
Top regions
regions
Optional
Up to Regions per keyword places, highest first: {name, code, value}. Cities have lat and lng instead of a code. value is 0-100, the keyword's share of all searches in that place (100 = the highest share), not the number of searches, which is why a small state can top the list. Always the keyword's own scale, even with Compare on. Google's sample for automated requests can order places below the top one differently from its website.
Rising related searches
risingSearches
Optional
Related queries that grew fastest, fastest first: {query, growthPct, breakout}. growthPct is the growth in percent vs the period before; breakout = true when Google labels the growth Breakout (over 5,000%).
Top related searches
topSearches
Optional
The most common related queries, most common first: {query, value}. value is 0-100, 100 = the most searched related query.
Google Trends link
trendsUrl
Optional
The same view on trends.google.com, to check by eye. With Compare on it opens the keyword's group of up to 5, which Google scales to its own top, so for linked keywords compare the shape of the line, not the numbers. Google re-samples its data, so values can move by a few points between visits.
Note
note
Optional
Plain explanation when something needs one: why a keyword has no data, was refused, or is a rough comparison.
Checked at
checkedAt
Optional
When the data was collected, UTC.
