Google Trends API Scraper - Trending Searches & Keyword Trends
Pricing
from $2.70 / 1,000 keyword reports
Google Trends data as rows: interest over time, interest by region, and top & rising related queries. Compare up to 5 keywords per line across multiple countries, plus Trending Now with hundreds of trends per country (volume, start time, related searches). No browser, no login.
type
Required
interest_over_time, interest_by_region, related_query, trending_now or report_status.
searchTerms
Optional
The comparison group this row came from (null on Trending Now rows).
geo
Required
Two-letter country code, or "" for worldwide.
timeRange
Required
The time range asked for (e.g. "today 12-m", a custom "YYYY-MM-DD YYYY-MM-DD", or "past 24 hours" for Trending Now).
category
Required
Google Trends category id; 0 = all.
property
Required
Search type: "" (web), images, news, froogle, youtube.
scrapedAt
Required
UTC timestamp when the row was produced.
term
Optional
The keyword the row is about (null on Trending Now status rows).
date
Optional
interest_over_time: start of the period, ISO 8601 UTC.
timestamp
Optional
interest_over_time: start of the period, Unix seconds.
value
Optional
0–100 interest (over time / by region); related_query: Google's score (top) or percent growth (rising). Rising values other than Breakout do not match the Google Trends website: reliable only for ordering.
isPartial
Optional
interest_over_time: the latest period is still in progress.
geoCode
Optional
interest_by_region: region code, e.g. US-CA, or a country code when worldwide.
geoName
Optional
interest_by_region: region name.
rank
Optional
related_query: top or rising.
position
Optional
1-based position in Google's list (related_query, trending_now).
query
Optional
related_query: the related search.
formattedValue
Optional
Value as Google shows it. interest_over_time: "<1" marks a non-zero value that rounds to 0. related_query: "100", "+250%" or "Breakout"; rising percentages other than "Breakout" do not match the Google Trends website and are reliable only for ordering.
link
Optional
related_query: the Google Trends explore URL for the related search; null when Google gives none.
title
Optional
trending_now: the trending search.
traffic
Optional
trending_now: approximate searches (Google's bucket, e.g. 200000 for "200K+"); null when Google gives none.
increasePercent
Optional
trending_now: growth in search volume, percent; null when Google gives none.
startedAt
Optional
trending_now: when the trend started, ISO 8601 UTC.
endedAt
Optional
trending_now: when the trend ended; null while it is still active.
isActive
Optional
trending_now: still trending.
categories
Optional
trending_now: category names; a numeric id when the name is unknown.
articleIds
Optional
trending_now: Google's article ids attached to the trend.
trendsUrl
Optional
trending_now: Google Trends explore link for the trend (the 48-hour window opens a 7-day Explore window).
status
Optional
report_status: no_data, error, or partial (delivered and charged, but a requested part had no widget in Google's explore answer or was refused with HTTP 400/401).
message
Optional
report_status: why the report is empty or incomplete.
