Google Trends Scraper API 💎

---

🔥 Why Switch to This Actor?

The most-used Google Trends actor on Apify has a 71.8% success rate — meaning nearly 1 in 3 runs fails. Ours runs at 100%, and if Google does return an error, you're only charged $0.0025 for the error record, not for a full failed run.

Feature	This Actor	Most Competitors
All 5 trend endpoints in one	✅	❌ Need separate actors
Success rate	✅ ~100%	⚠️ 71–97%
Price per result	✅ $0.0025	⚠️ $0.001–$0.025
Hidden compute/proxy fees	✅ None — included	⚠️ Common
Rate limit (429) handling	✅ Native exponential backoff	❌ Often crashes
Normalized flat JSON output	✅ CSV/Excel/Pandas-ready	⚠️ Varies
Keyword comparison (up to 5)	✅	⚠️ Often 1 at a time

---

📡 5 Intelligence Endpoints in One Actor

Set scrape_type to choose your data source. No switching actors, no extra cost.

1. 🔥 trending_now — Real-Time Pulse

What is the internet searching for right now? Updated hourly with volume estimates, traffic growth percentages, topic categories, and related news articles.

Best for: News aggregators, viral content creators, reactive social media teams.

{
  "keyword": "yankees vs mets",
  "volume": 100000,
  "volume_growth_pct": 1000,
  "topic_names": ["Sports"],
  "trend_keywords": ["yankees vs mets", "mets game today"],
  "started_timestamp": "2026-05-15T22:20:00+00:00",
  "is_trend_finished": false,
  "geo": "US"
}

2. 📈 interest_over_time — Historical Timeline (2004–Today)

Track normalized search interest (0–100) for up to 5 keywords simultaneously across any time range — from the last hour to the full history since 2004.

Best for: Seasonal demand forecasting, brand monitoring, trend correlation analysis.

{
  "keyword": "Web scraping",
  "value": 35,
  "date": "2025-05-11T00:00:00",
  "isPartial": false
}

3. 🗺️ interest_by_region — Geographic Demand Map

See exactly where interest in your keyword is highest. Break down by Country, Region (State), DMA, or City.

Best for: Local SEO targeting, PPC geo-bidding, regional product launches.

4. 🔍 related_queries — Long-Tail Keyword Discovery

Extract the exact search queries Google groups with your keyword. Flags "Rising" (breakout) vs "Top" (established) queries — the fastest way to find what competitors haven't targeted yet.

Best for: SEO content planning, keyword gap analysis, PPC expansion.

5. 🏷️ related_topics — Knowledge Graph Entity Extraction

Google's own entity groupings for your keyword. Reveals how Google understands your topic — invaluable for semantic SEO and brand positioning.

---

💰 Pricing — Fully Predictable, Zero Surprises

$2.50 per 1,000 results ($0.0025/result). Proxy rotation and compute are included. You only pay for data you receive.

Use Case	Results	Cost
Verify output quality	10 items	$0.025
Starter / test run	100 items	$0.25
Full historical analysis	1,000 items	$2.50
Monthly trending dashboard	~3,000/month	~$7.50/month

Zero-risk failure policy: If Google returns an error, you're billed $0.0025 for the error record — not for the entire run.

---

🎯 Use Cases

📦 E-commerce & Dropshipping

Identify what's trending before it saturates. Run trending_now daily across multiple countries. Cross-reference with interest_over_time to separate short spikes from sustained demand. Find products going viral on TikTok before they show up on Amazon.

✍️ SEO & Content Marketing

Use related_queries to discover long-tail keywords with rising search volume that your competitors haven't written about yet. Use interest_over_time to time content publishing to peak seasonal demand.

💸 Quantitative Finance & Trading

Correlate interest_over_time spikes for ticker symbols or company names with price action. Research has shown search volume predicts price volatility for retail-driven assets.

📊 Market Research & Brand Intelligence

Track brand awareness over time vs competitors using interest_over_time with up to 5 keywords. Use interest_by_region to find underserved markets and geographic strongholds.

🤖 Automated Dashboards & Pipelines

Schedule this actor daily or weekly. Export to CSV/Excel, or pipe directly to Pandas DataFrames — the output is flat, normalized JSON with consistent field names across all 5 endpoints.

from apify_client import ApifyClient

client = ApifyClient("YOUR_API_TOKEN")

run = client.actor("scraperpro/google-trends-ppe").call(run_input={
    "scrape_type": "interest_over_time",
    "keywords": ["ChatGPT", "Claude", "Gemini"],
    "predefined_timeframe": "today 12-m",
    "common_geo": "US",
    "max_events": 500
})

for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(f"{item['keyword']}: {item['value']} on {item['date']}")

---

⚙️ Input Parameters

Parameter	Type	Description
scrape_type	string	Required. One of: trending_now, interest_over_time, interest_by_region, related_queries, related_topics
keywords	array	Up to 5 keywords. Required for all types except trending_now
predefined_timeframe	string	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
common_geo	string	Country code (e.g. US, GB, DE) or leave empty for worldwide
geo_resolution	string	COUNTRY, REGION, CITY, or DMA (for interest_by_region)
gprop	string	Data source: "" (Web), images, news, froogle (Shopping), youtube
max_events	int	Cap on results returned. Default: 100. Lower to 10 for a free test

---

❓ FAQ

Q: How is this different from the official Apify Google Trends scraper? A: The official actor has a 71.8% success rate — nearly 1 in 3 runs fails. Ours handles 429 rate limits with exponential backoff and residential proxy rotation natively, hitting ~100% success. We also offer all 5 endpoints in one actor vs needing multiple.

Q: Can I compare multiple keywords at once? A: Yes — up to 5 keywords simultaneously in interest_over_time and interest_by_region. Each keyword gets its own row in the output, making it easy to analyze side-by-side.

Q: What happens if Google blocks the request? A: The actor applies invisible exponential backoff automatically. If it still can't get data after retries, it pushes a clean error record to your dataset and charges only $0.0025 — your run doesn't crash.

Q: Is there a free test? A: Set max_events to 10 for a test run that costs ~$0.025 and returns real data instantly.

Q: Can I schedule this to run daily? A: Yes. Use Apify's built-in scheduler to run on any cron schedule. The flat JSON output integrates cleanly with Google Sheets, BigQuery, or any data pipeline.

---

Keywords: Google Trends API, Google Trends scraper, trending searches API, interest over time scraper, related queries extractor, Google Trends data extraction, real-time trends API, trending now scraper, keyword trend tracker, SEO trend analysis, Google Trends Python, Google Trends historical data, regional interest data, breakout keywords, rising queries Google Trends