Google Trends Scraper

Scrape Google Trends data: real-time trending searches, search interest over time, related queries, related topics, and geographic interest data.

Fast, cheap, Cheerio-based — no browser overhead. At $0.005/result, this is 8x cheaper than existing Google Trends actors that charge $0.04/result.

Features

• Real-time trending searches — Get what's trending now in any country
• Keyword exploration — Analyze search interest for up to 5 keywords simultaneously
• Related queries — Rising and breakout related queries for any keyword
• Related topics — Discover topics related to your keywords
• Geographic data — See interest by country/region
• Search interest timeline — Track interest over custom time ranges
• Multi-country support — Filter by any country code

Input

Parameter	Type	Default	Description
mode	string	trending	trending for real-time trends, explore for keyword analysis
keywords	array	[]	Keywords to explore (up to 5). Only used in explore mode
geo	string	US	Country code (US, GB, DE, JP, etc.) or empty for worldwide
timeRange	string	7d	Time range: 1h, 4h, 1d, 7d, 30d, 90d, 12m, 5y
maxItems	integer	50	Maximum number of results to return

Output

Each result contains:

Field	Type	Description
keyword	string	The trending topic or search keyword
trend_value	string/null	Current trend interest or traffic value
change_percent	string/null	Percentage change in interest
related_queries	object	{ rising: [...], breakout: [...] } related queries
related_topics	array	Related topics with interest values
geographic_data	array	Top countries/regions with interest levels
search_interest_timeline	array	Interest values over the selected time range
timestamp	string	ISO timestamp of when data was scraped

Example Usage

Trending Mode

{
    "mode": "trending",
    "geo": "US",
    "maxItems": 20
}

Explore Mode

{
    "mode": "explore",
    "keywords": ["artificial intelligence", "machine learning"],
    "geo": "US",
    "timeRange": "12m",
    "maxItems": 10
}

Notes

• Google Trends does not have a public API — this actor scrapes the trends page directly
• Uses CheerioCrawler (HTTP-based) for maximum speed and minimal cost
• Google Trends may require JavaScript for some data — if results are limited, the actor includes a note in the output
• Rate limiting is applied to avoid overwhelming Google's servers

Cost

$0.005 per result — significantly cheaper than alternatives.

Changelog

v1.0

• Initial release
• Trending mode: real-time trending searches by country
• Explore mode: keyword analysis with related queries, topics, and geographic data
• Cheerio-based scraping for fast, cheap execution