Google Trends Scraper & API — pytrends Alternative
Pricing
from $2.00 / 1,000 data results
Google Trends scraper & API: bulk keyword lists to CSV, Excel or JSON — interest over time, by region, related queries and topics. 50 terms on one scale, daily data for years. A pytrends alternative, MCP-ready.
Input
inputUrlOrTerm
Optional
The search term line or Google Trends URL this row comes from.
Search term
searchTerm
Optional
Term(s) fetched; compared terms are joined with ", ".
Terms
terms
Optional
Terms fetched in this query.
Region
geo
Optional
Region code(s); empty string = Worldwide.
Time range
timeRange
Optional
Google time expression, e.g. today 12-m or 2024-01-01 2024-12-31.
Category
category
Optional
Google Trends category id (0 = all).
Search type
property
Optional
'' = Web, youtube, news, images, froogle (Shopping).
Status
status
Optional
ok, partial (some data types failed, see dataErrors), noData (Google has no data) or error.
Interest over time
interestOverTime_timelineData
Optional
Timeline points as returned by Google: time (epoch s), formattedTime, value[] (one per term, 0–100), hasData[], isPartial. With several samples each point also has spread[] (max − min across samples).
Averages
interestOverTime_averages
Optional
Average interest per term for the period.
Interest by subregion
interestBySubregion
Optional
States/provinces (or metro areas for a US state) of the region: geoCode, geoName, value[].
Interest by country
interestBy
Optional
Countries, for Worldwide queries.
Interest by city
interestByCity
Optional
Cities with data (best effort): geoName, coordinates, value[].
Interest by metro area
interestByMetro
Optional
US metro areas (DMA): geoCode, geoName, value[].
Metrics
metrics
Optional
average, peakValue, peakDate, latestValue, changePercent (last vs first quarter of the period), direction (rising/falling/stable), seasonality {peakMonth, lowMonth, strengthPercent} for periods of about 2+ years, hasDataRatio.
Per-term data
byTerm
Optional
For comparisons: each term with its metrics, regions, cities, metros, queries and topics.
Data errors
dataErrors
Optional
Data types that could not be fetched, with the reason. They are not billed.
Error
errorMessage
Optional
Why this row has no data.
Billed results
billedResults
Optional
Number of billed results in this row (term × data type with data).
Scraped at
scrapedAt
Optional
ISO timestamp of the run.
Term
term
Optional
The term of this row (a compared term in byTerm; the joined terms on a comparison row).
Data type
dataType
Optional
Flat format: interestOverTime, interestBySubregion, interestByCity, interestByMetro, relatedQueries, relatedTopics or error.
Date
date
Optional
Flat format: ISO date of a timeline point.
Value
value
Optional
Flat format: interest (0–100) or growth (%).
Summary
summaryText
Optional
One-sentence plain-text summary (average, peak, trend, seasonality, top rising queries without filler) — handy for AI agents, Slack and email.
Data breaks
dataBreaks
Optional
Dates where Google notes a change in its data collection (values before and after are not fully comparable).
Samples used
samplesUsed
Optional
Independent samples of the timeline combined into the per-point median (see input 'Samples per term').
Sampling spread
samplingSpread
Optional
Average max−min difference between the samples per point (0 = all samples agreed). Higher = Google's sampling noise is larger for this term.
Average
average
Optional
Average interest (0–100) over the period.
Peak
peakValue
Optional
Highest value in the period.
Peak date
peakDate
Optional
Date of the peak (ISO).
Latest value
latestValue
Optional
Last complete value.
Change %
changePercent
Optional
Mean of the last quarter of the period vs the first quarter, in percent.
Trend
direction
Optional
rising, falling or stable (within ±10%).
Seasonal peak month
seasonalPeakMonth
Optional
Month with the highest average interest; only for periods of about 2 years or more.
Regions
regions
Optional
Subregions of the region, or countries for Worldwide (same rows as interestBySubregion / interestBy).
