Google Trends Scraper

Scrapes Google Trends data for a list of keywords. Outputs precise trend metrics — average interest, direction, peak, growth rate, volatility, and composite trend score — to the Apify dataset.

What it does

This Actor queries the Google Trends API for each keyword you provide, returning numerical metrics that go far beyond what the Google Trends UI shows. It calculates average interest over the configured timeframe, identifies trend direction (rising/falling/stable), computes growth rate percentages, and assigns a composite trend score. Configure country, timeframe, and request delays to stay within Google's rate limits.

Use cases

• SEO keyword research — find rising and declining search terms
• Product demand validation — verify interest before sourcing or launching
• Seasonal trend analysis — compare keyword popularity across time periods
• Content strategy planning — create content around currently growing topics
• Product scoring pipeline — feed trend scores into automated ranking systems

Input

Field	Type	Required	Default	Description
keywords	array	Yes	—	Keywords/product names to look up on Google Trends
geo	string	No	"GB"	ISO country code (e.g. GB, US, FR)
timeframe	string	No	"today 3-m"	Time range: now 1-H, now 4-H, now 1-d, now 7-d, today 1-m, today 3-m, today 12-m, today 5-y
delayBetweenRequests	integer	No	10000	Delay in ms between keyword lookups (min 2000). Increase if rate-limited
requestTimeout	integer	No	30000	Timeout in ms per API call (5000–120000)

Example input

{
  "keywords": ["trending products", "best sellers", "new arrivals"],
  "geo": "GB",
  "timeframe": "today 3-m"
}

Output

Each keyword produces one record in the Apify dataset.

Field	Type	Description
keyword	string	The search keyword
geo	string	Country code used
timeframe	string	Timeframe used
avg_interest	number	Average interest score over the period
trend_direction	string	"rising", "falling", or "stable"
peak_interest	number	Highest interest value in the period
current_interest	number	Most recent interest value
growth_rate	number	Growth rate percentage
volatility	number	Volatility index
trend_score	number	Composite trend score (0–100)
data_points	number	Number of data points in the series
extracted_at	string	ISO 8601 date-time of extraction

Example output

{
  "keyword": "trending products",
  "geo": "GB",
  "timeframe": "today 3-m",
  "avg_interest": 62,
  "trend_direction": "rising",
  "peak_interest": 100,
  "current_interest": 78,
  "growth_rate": 25.8,
  "volatility": 12.3,
  "trend_score": 74,
  "data_points": 90,
  "extracted_at": "2026-03-06T14:30:00.000Z"
}

How to run

On Apify Platform

1. Go to the Actor's page on Apify Console
2. Enter your keywords and configure country/timeframe
3. Click Start and wait for the run to finish
4. Download results from the Dataset tab in JSON, CSV, or Excel format

Locally

$apify run

Deploy to Apify

apify login
apify push

Built with

• Apify SDK — actor framework and dataset management
• google-trends-api — unofficial Google Trends API client