Google Trends API — Interest Over Time, Regions & Related

Google Trends for hundreds of keywords and up to 20 countries in one run: interest over time with a ready-made trend summary, interest by region, and top and rising related queries and topics. Web search, News, YouTube, Images and Google Shopping. No browser, no blocked requests, no CAPTCHAs.

$6 per 1,000 queries. A query is one keyword (or up to 5 compared keywords) in one place and time range, with all the extras you ask for. Comparing 5 keywords at once is one query, so it works out at $1.20 per 1,000 keywords. Keywords with too little data, and queries that fail or are not ready in time, are free. No subscription, and platform usage is included. (Plus a tiny $0.00005 start fee per run.)

What you get

• Interest over time on Google's 0-100 scale, point by point, as in the Google Trends chart.
• A summary you can sort by: average, latest value, peak and peak date, and the change from the first quarter of the period to the last, with rising, falling or flat. The last point Google marks as incomplete is kept but left out of the summary.
• Compare mode: up to 5 keywords on one shared scale, like the compare view on the Google Trends site.
• Interest by region (states or countries) and related queries and topics, top and rising, at no extra cost.
• Many places in one run: worldwide plus up to 20 countries.
• Any period: past hour to 2004 to now, or your own dates.
• Bring keywords from anywhere: paste them, link a CSV, or point to a Keyword Research dataset.

Typical uses

• Spot rising topics before you write: rising related queries for your main keywords.
• Seasonality: five years of weekly interest to plan campaigns.
• Brand vs. brand: compare mode for you and four competitors in ten markets.
• Where to launch: interest by region for a product category.

Input

{
  "keywords": ["chatgpt", "claude", "gemini"],
  "mode": "compare",
  "countries": ["worldwide", "US", "DE"],
  "timeRange": "past_12_months",
  "includeRegions": true
}

Field	Meaning
keywords	Search terms, up to 100 characters. Symbols Google Trends refuses (- + ! : * ( ) and the like) become spaces, with a note.
mode	separate (default): each keyword on its own scale. compare: groups of up to 5 on one scale.
countries	Up to 20: codes, names, or worldwide. Default worldwide.
timeRange	past_hour, past_4_hours, past_day, past_7_days, past_30_days, past_90_days, past_12_months (default), past_5_years, all.
dateFrom, dateTo	Your own period instead, as 2024-01-31.
searchType	web (default), news, youtube, images, froogle (Google Shopping).
includeRegions	Add interest by region rows.
includeRelated	Add related queries and topics (separate mode).
maxWaitMinutes	How long to wait for queued queries. Default 60.
keywordsUrl, datasetId, keywordField	Other ways to pass keywords.

Output

interest, one per keyword and place:

{
  "type": "interest",
  "keyword": "claude",
  "comparedWith": [],
  "country": "US",
  "searchType": "web",
  "period": "past_12_months",
  "average": 54.7,
  "latest": 65,
  "peakDate": "2026-05-24",
  "changePct": 223.5,
  "trendDirection": "rising",
  "points": ["… one { date, value } per point, oldest first"],
  "status": "ok",
  "charged": true
}

A real row from a run on 17 October 2026 (chatgpt, claude and gemini, worldwide and United States: six queries, $0.036). In compare mode, comparedWith lists the other keywords on the same scale.

region: keyword, region, regionId, value (0-100). related_query: list (top or rising), query, value. related_topic: list, topic, topicType, topicId, value.

country is Worldwide for worldwide queries. Rows that cost nothing: no_data, invalid_keyword, input_error, note (a keyword was cleaned), spending_limit, free_plan_limit, not_ready, throttled and provider_error.

What it costs

Run	Price
100 keywords, worldwide	$0.60
100 keywords in 10 countries	$6.00
1,000 keywords compared in groups of 5, worldwide	$1.20
20 keywords with regions and related, 5 countries	$0.60

How long it takes

Queries go through a queue: most finish within a few minutes, some take longer at busy times. The run collects them as they finish and stops waiting after maxWaitMinutes; anything not ready by then is listed and not charged.

Apify free plan

Every query costs us real money at the data source, and free-plan runs earn nothing. So on the Apify free plan this Actor gives 3 queries a day. The rest comes back as uncharged free_plan_limit rows. Any paid Apify plan has no such limits.

Good to know

• Google Trends values are relative: 100 is the peak interest for that keyword (or group) in that place and period. Values from separate queries are not on the same scale; use compare mode for that.
• Data comes from a licensed data provider. This Actor is not affiliated with, endorsed by or sponsored by Google; "Google" and "Google Trends" are trademarks of Google LLC.
• A run that is moved to another server continues where it stopped, collecting the queries it already queued. Nothing is charged twice.
• Pricing: one trends-query charge per delivered query, plus $0.00005 when a run starts.
• Questions or a missing feature: open an issue on the Actor page.

Next steps

• Search volume behind the trend: Keyword Search Volume gives Google Ads monthly searches for the same keywords.
• More keywords around a rising topic: Keyword Research.
• Who ranks for it: Google SERP Rank Tracker.

More from this developer

• Keyword Research: keyword ideas, suggestions and related keywords with volume, difficulty and search intent, $2 per 1,000 keywords.
• Competitor Keywords: every Google keyword a domain or page ranks for, and its organic competitors, $2 per 1,000 rows.
• Domain SEO Overview: organic keywords, estimated traffic and top-10 rankings for thousands of domains, $5 per 1,000 domains.
• Google SERP Rank Tracker: Google positions for your keywords by country and device, with AI Overview checks, $2 per 1,000 result pages.
• Keyword Search Volume: Google Ads search volume, CPC and up to 48 months of trend for a keyword list, $2 per 1,000 keywords.
• Sitemap Extractor: every URL a website lists in its sitemaps, with lastmod, images and hreflang, $0.25 per 1,000 URLs.
• Broken Link Checker: crawl a site and find broken links and images, with the pages they are on.
• Tech Stack Detector: which CMS, ecommerce platform, analytics and hosting a website uses, $1.50 per 1,000 websites.
• Website Screenshot + Change Detection: screenshots of many URLs on desktop and mobile, with visual change detection between runs.
• Dataset Merge & Dedup Datasets: merge, dedupe and filter the results of several runs into one dataset.