Google Trends Explore API: Interest Over Time and by Region

Get Google Trends data for a list of keywords in one run: the interest over time series, its average, and interest by country or region. Filter by country, time range, category and Google property (Web, YouTube, News, Images, Shopping). You pay per keyword that returns data. Residential proxies are included in the price.

What you get for each keyword

• Interest over time: a 0 to 100 series, daily, weekly or monthly depending on the time range, hourly for the "past hour" to "past 7 days" ranges, with a flag on the last, still incomplete, period.
• Average interest over the period: the mean of all complete periods, zero periods included (null when there is no data).
• Interest by region: countries when the search is worldwide, states or regions when you set a country.

Use cases

• Check seasonality before planning content, ads or stock (Black Friday, Halloween, summer products).
• Compare demand for product ideas, niches or brands across countries and regions.
• Track how interest in a topic moves week after week, with the Apify scheduler.
• Feed a dashboard or a spreadsheet with trend curves for a list of keywords.

Input

Field	Description	Default
keywords	Search terms, one result per term, up to 500 per run	required
timeframe	Past hour, 4 hours, day, 7 days, 30 days, 90 days, 12 months, 5 years, since 2004, or custom	today 12-m
customTimeframe	With a custom range: YYYY-MM-DD YYYY-MM-DD, from 2004 onward
geo	Country (US, FR) or region (US-CA) code, empty for worldwide	worldwide
category	Google Trends category id (0 = all)	0
property	web, youtube, news, images or froogle (Google Shopping)	web
maxConcurrency	Keywords fetched in parallel (1 to 10)	5

Example:

{ "keywords": ["halloween costumes", "christmas gifts"], "timeframe": "today 5-y", "geo": "US" }

Output

One item per keyword. Real output for "web scraping", worldwide, past 90 days (lists shortened here; the full item has 93 days and 55 countries):

{
  "keyword": "web scraping",
  "geo": "",
  "timeframe": "today 3-m",
  "category": 0,
  "property": "web",
  "scrapedAt": "2026-10-05T05:20:41.000Z",
  "error": null,
  "averageInterest": 27.4,
  "interestOverTime": [
    {
      "date": "2026-07-05",
      "value": 36,
      "isPartial": false
    },
    {
      "date": "2026-07-06",
      "value": 32,
      "isPartial": false
    },
    {
      "date": "2026-10-05",
      "value": 13,
      "isPartial": true
    }
  ],
  "interestByRegion": [
    {
      "geoCode": "SH",
      "geoName": "St. Helena",
      "value": 100
    },
    {
      "geoCode": "CN",
      "geoName": "China",
      "value": 30
    },
    {
      "geoCode": "SG",
      "geoName": "Singapore",
      "value": 29
    }
  ],
  "noData": false
}

Values are relative: 100 is the peak of the period for this keyword and place. Dates are days (2026-07-05) for ranges of 30 days or more and UTC timestamps for the shorter ranges.

Pricing

Pay per event: one keyword event per keyword that returns data. These items are free:

• keywords with too little search volume (noData: true, zeros and no region);
• keywords that fail (an error message and empty data), including the keyword Google refused.

The run uses one residential proxy session from start to end. If Google starts limiting requests (HTTP 429 or 403, a redirect to its "unusual traffic" page, or a page without data), the run stops asking for keywords: items already saved stay in the dataset, and the remaining keywords are not tried and not charged. The log then says "Google is limiting requests: run again later with fewer keywords". Large batches can stop early this way.

The run stops as soon as your maximum charge per run is reached. Proxy traffic is included: there is nothing else to pay for the residential proxies this Actor uses.

Tips

• One keyword per item: Google scales each keyword on its own 0 to 100 range, so values are not comparable across items. Compare the shape of the curves or the average interest rather than raw points.
• Use the past 90 days range or shorter for daily points; longer ranges return weekly or monthly points.
• If a run stops early because Google is limiting requests, run the remaining keywords later, in smaller batches or with a lower maxConcurrency.
• If the platform restarts a run, keywords already saved are skipped.
• On short ranges (past hour to past 7 days), a keyword searched only once or twice shows a single spike at 100 and is charged as data.

FAQ

Is there an official Google Trends API? Google runs an alpha API open on application only. This Actor reads the public Google Trends explore data.

Does it return related queries or related topics? Not in this version. Google returns unreliable related queries and empty related topics to automated requests, so they are left out rather than sold.

Does it collect personal data? No. Google Trends only publishes aggregated and anonymized search interest.

Do I need a Google account or an API key? No. Proxies are included and you only need your Apify account.

Related Actors

Other Actors in the same toolbox, with the same pay-per-result model:

• Tech Stack Detector: Detect which websites run the technologies you track.
• Career Site Jobs Scraper: Compare search interest with real job postings.
• EU TED Tenders Scraper: Compare search interest with public tenders in the same sector.
• French Company Search: List French companies in the sectors that show rising interest.