Google Trends
Pricing
from $2.00 / 1,000 keyword lookups
Google Trends for any keyword — interest over time, top and rising related searches, interest by region — and the top and rising searches of any of Google's 928 categories, in any country or region, over any time range.
recordType
Optional
"lookup" for a keyword lookup, "trend" for an entry of a category ranking.
platform
Optional
The platform the list is from: google.
list
Optional
The list: trending_now, explore_top or explore_rising.
listKey
Optional
The same for every row of one list as read at one time; matches an entry of the SUMMARY record's lists.
itemKey
Optional
The same for the same entry across runs, to follow it over time.
entityId
Optional
rank
Optional
Place in the list as Google gives it, 1 first.
term
Optional
The search, as Google shows it.
termLanguage
Optional
The language of the term when Google states it; otherwise null.
kind
Optional
What the term is: search.
category
Optional
The category the list was asked for; null when the list is not asked for by category.
categories
Optional
The categories Google files this entry under.
metrics
Optional
Numbers Google shows for the entry. A value Google does not show is null with its reason, never 0.
primaryMetric
Optional
startedAt
Optional
When the entry started trending, when Google says.
endedAt
Optional
When it stopped trending; null while it is active.
geo
Optional
The country the list is for (ISO 3166 code); empty for worldwide.
geoScope
Optional
geoRequested
Optional
window
Optional
How far back the list reaches: 1h, 4h, 24h, 48h, 7d, 30d, 90d, 12m.
observedAt
Optional
When the list was read.
url
Optional
The entry's Google Trends page.
extra
Optional
The same facts as text, for reading at a glance.
keyword
Optional
The keyword looked up, as given.
status
Optional
ok, or not_available when Google has no data for the lookup (its words in reason).
reason
Optional
points
Optional
Interest over time, 0 to 100 relative to the highest point of the window; the last point of a window that reaches now is partial.
regions
Optional
Where the keyword is searched most, 0 to 100 relative to the highest.
