Google Trends Scraper

Scrapes Google Trends for any keyword. Extracts the full set of trends-vertical fields: interest-over-time / interest-by-region, related queries / topics / articles, value, percentage, rank, delta, growth rate, breakout flag, suggestions, time range, geo, category, and more.

What this Actor collects

The Actor converts Google Trends responses into clean records for interest over time, regional interest, related queries, topics, and articles, including values, ranks, changes, breakout flags, time range, geography, category, and retrieval provenance.

• Uses the input limits and filters below to control the crawl.
• Stores source-backed fields defined by the 43-field dataset schema.
• Omits optional fields when the source does not expose a value instead of writing nulls or fabricated placeholders.

Use cases

• Trend monitoring
• Demand and seasonality research
• Topic comparison

Input

Provide input in JSON. Fields marked required must be supplied. The Default / example column shows a schema default when one exists; otherwise it shows a documented prefill or fixture value.

Field	Type	Required	Default / example	Description
query	string	Yes	"artificial intelligence"	The search term or topic to look up on Google Trends.
geo	string	No	"US"	Two-letter country code to filter results by region. Leave empty for worldwide.
timeRange	string	No	"today 12-m"	The time range for the trends data.
category	integer	No	0	Google Trends category ID. 0 means all categories.
maxItems	integer	No	50	Maximum number of interest-over-time data points to return.
proxyConfiguration	object	No	{"useApifyProxy":true,"apifyProxyGroups":["RESIDENTIAL"]}	Proxy settings for the scraper. Use Apify Proxy or custom proxies.

Example input

{
  "query": "artificial intelligence",
  "maxItems": 50,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "GOOGLE_SERP"
    ],
    "countryCode": "US"
  },
  "geo": "US",
  "timeRange": "today 12-m",
  "category": 0
}

Output

The default dataset contains one item per extracted trend data point or related item. The fields present depend on whether the record represents time-series interest, regional interest, a related query, topic, or article.

Field	Type	Description
position	integer	Position
term	string	Term
value	number	Value
percentage	string	Percentage
delta	string	Delta
growthRate	string	Growth Rate
isBreakout	boolean	Is Breakout
scrapedAt	string	Scraped At
type	string	Type
title	string	Title
url	string	URL
link	string	Link
source	string	Source
query	string	Query
searchQuery	string	Search Query
resultType	string	Result Type

Example dataset item

This compact example is taken from local Actor storage. Long text and nested collections are shortened for documentation only.

{
  "position": 1,
  "scrapedAt": "2026-07-23T11:52:42.291Z",
  "type": "relatedSearch",
  "title": "AI Mode",
  "query": "AI Mode",
  "searchQuery": "artificial intelligence",
  "resultType": "relatedSearch",
  "geo": "US",
  "timeRange": "today 12-m",
  "searchUrl": "http://www.google.com/search?q=artificial+intelligence+trends&gl=us&hl=en",
  "country": "US",
  "language": "en"
}

Related Actors

• Google About This Result Scraper
• Google AI Overview Scraper
• Google Autocomplete Scraper