Google Trends Scraper

Give search terms and get Google Trends data back as flat rows: one summary row per term, then a row per time point, region, and related query. Set the geo, timeframe, category, and search property, or compare up to 5 terms on one chart. Mamba Labs pays the platform and proxy costs; you pay per term that returns data.

Features

• One summary row per term. term_report holds the average, latest, and peak interest, the peak date, the recent change, the top region, and the top and rising queries, so a Clay column or a CSV has one row per term to work from.
• Flat detail rows. trend_point, region, and related rows share one fixed layout, so nothing is nested and no column disappears between row types. Filter on row_type.
• Compare up to 5 terms on one scale. With compare on, terms chart together in groups of 5, the way the Trends page does it.
• Regions, metro areas, and cities. Countries worldwide, regions inside a country, and US metro areas or cities when you ask for them.
• Web, news, images, YouTube, and shopping search.
• Each row says what its number means. value_meaning separates relative interest from a share between compared terms and from a rising percent. is_partial marks a period still running.
• One price per term, like the Store leaders. Not one price per data point, so a 53 point chart does not cost 53 times as much.
• You pay for data only. A term with no data, and a term Google refused after every retry, is one free row that says so.
• Cost guards. A maximum charge per run, and the actor stops 90 seconds before the run's timeout and delivers what it has.

How the data is read

The actor calls the same JSON endpoints the Google Trends page calls, through the Apify proxy, with no browser. No Google account, no login, no key, and no other developer's actor. A refused request retries on a new address with a new session, then on residential addresses, with a limit on every wait, so a run does not hang on Google.

Input

Field	Type	Default	What it does
terms	array		Search terms, up to 200 per run. A Google topic ID such as /m/0j6n6s8 also works.
geo	string	``	Empty for worldwide, or a Google geo code such as US, DE, or US-CA.
timeframe	string	today 12-m	now 1-H, now 4-H, now 1-d, now 7-d, today 1-m, today 3-m, today 12-m, today 5-y, all, or two dates as YYYY-MM-DD YYYY-MM-DD.
category	string	0	Google Trends category number. 0 is all categories. The number is in the cat= part of a Trends URL.
property	string	web	Which Google search to read: web, news, images, youtube, or shopping.
compare	string	false	true: terms are charted together in groups of 5, on one shared scale. false: each term gets its own chart. Each term is charged either way.
outputs	array		Any of interest_over_time, interest_by_region, related_queries, related_topics. Default is the first three. See Limitations for related_topics.
region_resolution	string	auto	auto: countries worldwide, regions inside a country. DMA is US metro areas. CITY needs a geo. COUNTRY needs an empty geo.
max_charge_usd	string		Optional. The run stops before a charge that would pass this amount. Summary rows are always returned.
proxy_mode	string	auto	auto (default): requests go through the Apify proxy pool, and a request the pool cannot get through is retried on residential addresses. residential: every request uses residential addresses. A reliability setting only; it does not change what you pay.

Give at least one term. compare and the other text fields take the values shown as text, which is what Clay sends.

Output

Field	Type	What it holds
row_type	string	One of: term_report, trend_point, region, related, extra_rows_receipt, run_summary. run_summary is the one free row written when the input is refused.
term	string	The search term this row belongs to.
compared_with	array	In compare mode, the other terms on the same chart. Values on these rows are on one shared scale.
geo	string	The geo code you set. Empty means worldwide.
timeframe	string	The timeframe you set.
category	integer	The Google Trends category number. 0 is all categories.
property	string	web, news, images, youtube, or shopping.
explore_url	string	The same chart on trends.google.com.
average_interest	integer	term_report: average of the points, 0 to 100 on the chart scale.
latest_interest	integer	term_report: value of the last complete period.
peak_interest	integer	term_report: highest value on the chart.
peak_date	string	term_report: start of the period with the highest value.
recent_change_pct	number	term_report: average of the last 4 complete periods against the 4 before, or fewer on a short chart.
points_returned	integer	term_report: time points on the chart.
regions_returned	integer	term_report: regions with data.
top_region	string	term_report: region with the highest value.
related_queries_returned	integer	term_report: top and rising queries returned.
top_related_query	string	term_report: the first query on the top list.
top_rising_query	string	term_report: the first query on the rising list.
related_topics_returned	integer	term_report: top and rising topics returned. See Limitations.
date	string	trend_point: start of the period, UTC.
date_label	string	trend_point: the period as Google labels it.
is_partial	boolean	trend_point: true when the period is still running, so the value can change.
region_code	string	region: Google code for the region, such as US-WY or SG. Empty on city rows.
region_name	string	region: name of the region, metro area, or city.
latitude	number	region: city rows only.
longitude	number	region: city rows only.
related_kind	string	related: query or topic.
related_list	string	related: top (most searched) or rising (biggest increase).
related_term	string	related: the query or topic title.
topic_id	string	related: Google topic ID on a topic row. You can use it as a search term.
topic_type	string	related: Google topic type on a topic row.
related_url	string	related: this query or topic on trends.google.com.
value	integer	trend_point, region, related: the number Google gives. value_meaning says what it measures. Empty when Google has no data for the point.
formatted_value	string	The number as Google shows it: <1 means under 1, and Breakout means a rise too large for Google to state as a percent.
value_meaning	string	What value measures. Values are relative to this chart: they are not search counts.
row_status	string	ok, or why this row carries no data: no_results, no_change, partial, blocked, or error.
error_reason	string	Why the row is not ok. A refused input reads input_invalid: followed by what to fix.
billable_events_json	string	What this row was billed as, for example {"term-report":1}. {} means free.
scraped_at	string	When the row was written, UTC.

Reading the numbers

Google Trends values are relative, not search counts. On an interest chart, 100 is the peak of that chart, and values from two separate charts are not comparable: to compare terms, use compare. <1 in formatted_value means under 1, and value is then 0. A point with no data has an empty value. On a related row in the rising list, value is a percent increase, and Breakout means a rise too large for Google to state. On a region row in compare mode, value is that term's share among the compared terms in that region.

Google samples its data, so two runs of the same chart can differ by a few points.

Pricing

Pay per event. You pay for each term that returns data and for the run start. A term's price includes its summary row and up to 170 detail rows, which covers a 12 month chart with regions and related queries. A longer chart, such as 5 years, or city level regions, adds one extra-rows event per further 100 rows, each shown as a free extra_rows_receipt row. To avoid it, ask for fewer outputs. Summary rows for a term with no data, a term Google refused, a term with a refused part, and a refused input are free.

Event	Free plan	Bronze	Silver	Gold
term-report, one search term with data, summary row plus up to 170 detail rows	$0.0065	$0.006175	$0.00585	$0.005525
extra-rows, each further 100 detail rows on one term past the first 170	$0.0035	$0.003325	$0.00315	$0.002975
apify-actor-start, once per run (one per GB of memory; the default 256 MB is one)	$0.002	$0.002	$0.002	$0.002

Per 1,000 rows of term-report: $6.50 on the free plan, $5.52 on Gold.

Free plan cap: 1.50 USD of evaluation a month, about 231 rows. Any paid Apify plan removes the cap, and it resets on the 1st. The run stops before a charge that passes your maximum charge per run in Apify or your max_charge_usd input.

Mamba Labs pays the platform costs of your run, Apify proxy traffic included.

Usage examples

Apify Console or API.

{
  "terms": ["coffee", "matcha"],
  "geo": "US",
  "timeframe": "today 12-m",
  "outputs": ["interest_over_time", "related_queries"]
}

Compare terms by US metro area.

{
  "terms": ["coffee", "tea"],
  "geo": "US",
  "compare": "true",
  "region_resolution": "DMA"
}

Read the rows with GET https://api.apify.com/v2/datasets/{datasetId}/items.

Clay. Number and on or off inputs are text fields, which is what Clay sends. A list input takes a JSON list, so put the column inside a one item list. Use the term_report row for one row per term.

MCP. The Mamba Labs MCP server @mambalabsdev/mcp-google-trends-scraper exposes this actor to Claude and other MCP clients.

Error handling

Case	What you get
Missing or unreadable input	One free row, row_type run_summary, error_reason starting input_invalid: with what to fix. The run ends successfully and charges nothing but the run start
No data for a term	One free term_report row, row_status no_results
Google refuses every attempt for a term	One free term_report row, row_status blocked. Run that term again
One part of a term is refused, for example its regions	A free term_report row, row_status partial, with the parts that were read
Google rejects the settings	One free term_report row, row_status error
The run is close to its timeout	The actor stops starting new work 90 seconds before the timeout and delivers what it has

Limitations

• Related topics: Google answers an empty list to automated clients, on every address tested when this actor was built. related_topics stays available, costs nothing extra, and the row says when none came back. Related queries are not affected.
• Google offers related topics per term only outside compare mode.
• Values are relative and sampled, as described above. They are not search volumes.
• Trending Searches, the daily list of what is trending, is not read by this actor. It reads terms you give.
• A metro level (DMA) outside the US returns no region rows: the term is still delivered with its other rows, and regions_returned is 0.
• A very rare term can return a chart with a single point. That is Google's data, and the term is charged as a term with data.
• Interest by city and metro is what Google returns for the chart: often about 200 rows, many without data, which are left out.

Mamba Labs actor suite

Actor	Actor ID
Account Hiring Watch	gRAZA5WBi1r6L0gy7
Agent Accessibility Auditor	anxbRv0lKrpQ1pnua
Agent to Brokerage Resolver	ePRRGLxOGyaVHO4dI
AI Answer Visibility Tracker	RJZvzKniYK4nswcMg
AI Tooling Detector	EwkHhmqiuJgRoVEbE
API Deprecation and Breaking Change Monitor	pHsbS3xXUK8Jqutz5
App Store and Google Play Review Monitor	MaCMEhGrbchxQZ92G
B2B Reddit Conversation Monitor	SoDryzzsjmY3SsiyG
Bluesky Brand Presence Mapper	eLpxzP4IuXznlFVND
Brand Sponsor Finder	PPgK6xrgOmvL7Nrys
Bulk WHOIS and RDAP Domain Age Lookup	MTrkG5FLU6SjqLdJY
Career Change Signal Engine	vX2Yga1a6wGaXaP14
Company Careers Page Jobs, 17 ATS Boards	izP0rfIgf5YaRZfIh
Company Change Event Feed	oX44rS0fkEJ3rXLWe
Company Discovery List Builder	jch0HdaZnpbMqlcGS
Company Firmographic Enricher	YlUtLWjfPpqykmB8g
Company Funding Record	OFS4Mt1gyYNtGfUbE
Company Headcount Estimator	aHC4GROnNt6kfZe5r
Company Identity Resolver	lr8fTRAmZCBZmuwwh
Company Role Email, Phone and Address Finder	4mMncKaJykiq94grz
Company Social Presence Mapper	4k6CCemkgBDz18m2h
Competitor Price, Stock, and Changelog Monitor	yxdgCbUQ4PYQWwRNU
Contact Classifier	0lGSeYJmniXhGANnO
Contractor License Search, CA, TX, WA, OR, LA	WBYK3CPI2kdeq4bP1
CRM Contact Job Change Checker	L8UbEmMJC1XYPSZOb
Domain Deliverability Checker	0tVgxI7A6o9jMlxmc
Domain to LinkedIn URL Resolver	3HtnSaqPHOg1Qg5gx
Ecommerce Platform Profiler	5G2NeYjBbQTjaTn9L
Ecommerce Store Discovery	PeHu4sLyFvQHXUUrX
Email List Verifier, Bring Your Own Key	CzVJ4NlaCKk80xpgE
Event Presence Index	WLhMy8fMDgsxdYxv5
Expert Witness Finder, US and Australia	LIpwlgfE3LaQBaXd4
Funding and Press Signal Scanner	FS13X6dhQVgX3XOM6
GDPR Cookie Banner and Consent Checker	TrKyOS0KBoGC35nbr
GitHub Organization Signal Scanner	ahF8RRpv5mzPao5CN
Google Ads Transparency Center Scraper by Domain	1eOwxhBVxzvOXAm4s
GTM Hiring Signal Scraper	D7O1SA2EqwHGsGr1P
GTM Signals Aggregator	xKdRfnfFNkdMpFuNs
ICP Fit Scorer	W161DT8W4kW55dMFh
Influencer Change Monitor	d2VVgahNL6UmcLkhg
Influencer Lead List Builder	KnmByszcv135yM30G
Influencer Profile Scraper	EqEnklDVMIcB1V499
Influencer Search Across TikTok, Instagram and YouTube	tpkedmloIIWtXx6sg
Influencer Talent Agency Lookup	zCuX4Mgyg6JvXgGzd
Instagram Facebook Brand Presence Mapper	HXh65I0JBjPsunbY8
Integration and Marketplace Presence Mapper	V0guNuvM85Q61f2gj
Job Board Keyword Signal Scanner	4DvqpvhMR74NLcDDY
Job Posting Monitor	QCfICD9kOPiOdj5iI
Journalist and Media List Builder	mAfizsZC8qRoR0ecS
Launch Directory List Builder	cRq3bmvEZxZtioQ7U
Lead File Import Checker	RwlGVXTf46LqZdUgt
Legal Entity Resolver	KHFyPCDIx7CyqULYm
Link in Bio Scraper and Newsletter Detector	OorucdheTIgu7RFzK
LinkedIn Company Page Mapper	zOPm6A9JEhUGcIdFW
LinkedIn Jobs Feed	SH6N0d8cz46BhCC8B
LinkedIn Post Tracker	oiGLNPuaf5BRaz9K5
Local Business Lead Builder	qMN97aoHhsAS5bznV
Local Rank and Map Pack Tracker	gv0kyHGDIg8XscclB
Lookalike Companies from Seed Domains	e2O426WBAbLLQL4Z2
Manufacturer and Supplier Finder	Qcsdmd0lUfPzVkonh
Meta Ad Library Ads by Company, Graph API	J1GWlSXfSGU3u8Wng
Mobile Phone Waterfall	6OOgPktf7RIa5XCOP
New Hire Finder	cKuc38p4nYHNF3IW8
Newly Registered Companies, UK, Norway, Finland, France	g2WfZhWvCtc57g2Jo
News and Media Mention Monitor	gol1PPUKrsIk4QLBd
Newsletter Sponsor Tracker	qSwpqxD1TiPZpLQHv
Open Tender and RFP Finder	kPTGz6t6TFoUUyfaO
Outbound Stack Detector	v43UJC8r7qW7cBSTG
Page Finder and Extractor	TpurgcOZbVnknlaiC
Partner and Member Directory Extractor	ZX0XJPPUvnFJxeC1a
People Finder & Email Verifier	LEgloG7tWgQl4o6TD
Person LinkedIn URL Resolver	ssuyPV8LnEsL8qbnb
Person Social Footprint Mapper	jfQXa2zW9FHCJot9K
Personal Email to Company Resolver	AefT5Ye6YNPFQwJBf
Pinterest Brand Presence Mapper	d1HvjZfKhgvWsoEwn
Podcast Guest and Host Finder	o2MGSvgbSLeeXOsIo
Product Hunt Daily Launches with Maker Domains	O4VX63drWK9Y9x641
Prospect Engine	q9rT6v64nUJdPexOQ
Public Feature Board and Roadmap Monitor	rcHF5gj5r2Vqnry35
Publishing Frequency Tracker	TbLwaUUATdYb6wp4N
Recent Funding Rounds Feed	KueVp9MOz7iOoAgDp
Reddit Brand Presence Mapper	pKQZmDaT70SEb54bZ
Reddit Search and Thread Scraper	4Gsth5cP2Xt9V2xDN
Reporting Window Finder	uINxR7a1IW8qUTRUX
Sequencer Event Poller	S6s8Rjd61tGdrMRk4
Sequencer Lead Push	0Jv27VeWM5tSZQs9x
Shopify App Store and Chrome Web Store Listings	gaY0BzkLyN77mD3wI
Substack Newsletter and Posts Scraper	UEFsdwiPLmPNVy9xd
Team Page People Extractor	j8a9zX0k4mNbvDbWK
Tech Stack Signal Detector	qyd7nNyqFPelQViBx
Threads Posts by Keyword, Exact Match	2OT8K8RiEEWtaj2MW
TikTok Brand Presence Mapper	fco8FvoJcSafbeyd1
Trustpilot Reputation Enricher	3lIqfCt61j4hqE1xz
US and UK Contract Award Winners by Company	zhEtllASykOcx9hJ8
VC and Accelerator Portfolio List Builder	chH8hrfuoqqolW06m
Website Accessibility Checker, WCAG 2.2 AA	P3jBj3FRghKEhX52z
Website Phrase and Business Model Classifier	CBuZ9k7sRwBeiKiCS
Website Traffic Rank Estimator	GnOFUzlNVIoXgeJjH
Work Email Waterfall	OT6xqTFThC0Rjf7Zj
Workplace Program Detector	Li6pPDhqbdzFz3h7G
X Brand Presence Mapper	oLOgadhHUkNAyDA3w
YouTube Channel from Company Domain	6hSpD3kd2s2IQ4VSs

Built by Mamba Labs.