| π Web Search | π₯ YouTube Search | ποΈ Google Shopping | πΌοΈ Image Search | π° News Search |
| :---: | :---: | :---: | :---: | :---: |
| Macro Intent | Creator & Video SEO | E-Commerce Buying | Visual Trends & Assets | Media & PR Spikes |
**π 1-Click Excel / CSV Ready** β’ **β‘ Sub-Second Pay-Per-Event API** β’ **π° From $0.30 / 1,000 Results** β’ **π‘οΈ Rotating Residential Proxies**
***
|
β‘ UnitBytes Β· Search Trends & Market Demand Intelligence Ecosystem
|
π½ Reddit Scraper & Search API
$0.50/1K β’ 5 Search Surfaces
Subreddits, posts, 5-tab search & nested comment trees
|
π 1688 & Alibaba Wholesale
Factory Sourcing & Arbitrage
Direct China factory prices, 1688 Global & Arbitrage, 1688 Image Search, Alibaba B2B, Taobao & Goofish
|
π FB Marketplace & Classifieds
Local Supply, Autos & Sellers
FB Seller Intel, Vehicles, Craigslist & OfferUp
|
|
πΊοΈ UnitBytes Β· Google Shopping, Travel, News, Jobs, Maps & Local Intelligence Ecosystem
|
ποΈ Google Shopping Scraper
From $2/1K β’ Live Retail Prices
Product prices, deals, multi-seller offers & direct store checkout URLs
|
βοΈ Google Flights & Hotels
From $2.50/1K β’ Airfares & OTAs
Google Flights fares/CO2 & Google Hotels Booking/Expedia parity
|
π° Google News & Jobs
From $1β$4/1K β’ PR, RAG & Hiring
Google News direct URLs/full text & Google Jobs salaries/ATS
|
β Google Maps Reviews Scraper
$0.25/1K β’ All 10K Reviews
Up to 10,000 reviews/place, keyword filter & ORM Takedown Tracker
|
π§ Google Maps Email & Leads
$0.50/1K β’ B2B Contacts
Verified business emails, Photos & Menus & Local Guides
|
π°π· Naver Place & Map Scraper
$0.50/1K β’ Korean Local Leads
Korean business leads, Naver Place Reviews & Menus (λ€μ΄λ² νλ μ΄μ€)
|
***
### β‘ 60-Second Quick Start: Get Trends in 3 Steps
1. **Pick Your Endpoint, Keywords, or Paste a URL**:
- Choose `interest_over_time`, `trending_now`, `interest_by_region`, `related_queries`, `related_topics`, or **`all`** (to extract all 4 keyword datasets in a single run!).
- Or simply paste any `https://trends.google.com/trends/explore?...` link into **`trends_urls`** and let the actor configure everything automatically.
2. **Choose Comparative vs. Bulk Mode**:
- Keep **`compare_keywords: true`** *(Default)* to compare up to 5 keywords side-by-side on a shared 0β100 scale.
- Uncheck **`compare_keywords: false`** to run **up to 100 keywords in bulk** in a single run (each keyword analyzed on its own 0β100 scale).
3. **Choose Output Format & Click Start**:
- Select **`flat`** *(Recommended for Spreadsheets)* if you want 1-click **Excel, CSV, or Google Sheets** rows with dedicated columns.
- Select **`legacy`** *(Default)* if you are integrating into an existing developer backend expecting a single JSON envelope.
#### π§ͺ Try It Now β Ready-to-Run Configurations
Copy and paste any of these JSON configurations into the **Input β JSON** tab in Apify Console or your API client:
##### 1. π All-in-One Keyword Monitor (Timeline + Regions + Queries + Topics in 1 Run)
```json
{
"scrape_type": "all",
"keywords": ["AI agents", "MCP server"],
"output_format": "flat",
"predefined_timeframe": "today 12-m",
"common_geo": "US"
}
```
##### 2. π₯ Real-Time Trending Now Monitor (Last 24 Hours Viral Spikes & News β No Keywords Needed)
```json
{
"scrape_type": "trending_now",
"common_geo": "US",
"trending_hours": 24,
"output_format": "flat"
}
```
##### 3. π¦ Bulk Keyword Research (Up to 100 Keywords on Independent 0β100 Scales)
```json
{
"scrape_type": "interest_over_time",
"keywords": [
"solar panels", "heat pump", "ev charger",
"home battery", "smart thermostat", "tankless water heater"
],
"compare_keywords": false,
"output_format": "flat",
"predefined_timeframe": "today 12-m",
"common_geo": "US"
}
```
##### 4. π Direct Google Trends URL Extraction (Auto-Parses Keywords, Geo & Timeframe)
```json
{
"trends_urls": [
"https://trends.google.com/trends/explore?date=today%203-m&geo=US&q=ChatGPT,Claude&gprop=youtube"
],
"output_format": "flat"
}
```
***
### π 8 Game-Changing Features You Won't Find Anywhere Else
#### 1. π All 5 Intelligence Endpoints + All-in-One Mode (`scrape_type: "all"`)
Stop paying for or juggling multiple scrapers. Run individual endpoints or extract everything at once:
- π **`all` (All-in-One Keyword Suite)**: Extracts `interest_over_time`, `interest_by_region`, `related_queries`, and `related_topics` in a single unified run.
- π **`trending_now`**: Real-time viral search spikes with hourly growth % and context news articles.
- π **`interest_over_time`**: 2004βpresent timelines with multi-keyword normalized indexing.
- πΊοΈ **`interest_by_region`**: Sub-national heatmaps down to Country, State/Province, City, and Metro DMA.
- π **`related_queries`**: Long-tail keyword mining separating established "Top" terms from "+5,000% Breakout" rising queries.
- π·οΈ **`related_topics`**: Semantic entity categorization from Google's Knowledge Graph.
#### 2. π― Complete 5-Property Multi-Platform Search (Web, YouTube, Shopping, Images & News)
Market alternatives are locked strictly to Web search. Our actor connects to Google's separate search indexes:
- ποΈ **Google Shopping (`froogle`)**: Discover which physical merchandise, electronics, and fashion items users are actively looking to buy right now.
- π₯ **YouTube Search (`youtube`)**: Uncover video creator tutorials, gameplay searches, and video SEO tags before they peak on YouTube.
- πΌοΈ **Image Search (`images`)**: Track aesthetic demand, wallpaper searches, design trends, and visual assets.
- π° **News Search (`news`)**: Gauge media coverage intensity, PR news cycles, and breaking press sentiment.
- π **Web Search (`web`)**: Broad, general macro search demand.
#### 3. π Comparative Mode (Up to 5 Keywords) + Bulk Mode (Up to 100 Keywords)
- **Comparative Mode (`compare_keywords: true`, Default)**: Compare up to 5 keywords side-by-side on the exact same 0β100 normalized index to see which competitor or product dominates market share.
- **Bulk Mode (`compare_keywords: false`)**: Process **up to 100 keywords in a single run**βeach keyword is queried individually on its own independent 0β100 scale, ideal for large-scale SEO audits and catalog research.
#### 4. π Direct Google Trends URL Support (`trends_urls`)
Already exploring trends in your browser? Paste any `https://trends.google.com/trends/explore?...` or `https://trends.google.com/trending?...` URL directly into `trends_urls` (or `startUrls`)βthe actor automatically extracts the keywords, country/state code, timeframe, and search property (`gprop`).
#### 5. π 1-Click Native Excel / CSV Exports (`output_format: "flat"`)
*Ever clicked "Export to Excel" on Apify only to get broken nested JSON or unusable `[object Object]` cells?*\
Our native `flat` mode formats every single data point into clean columnar rows (`keyword`, `value`, `date`, `geoName`, `category`) ready immediately for **Microsoft Excel, Google Sheets, PowerBI, Tableau, and Airtable** β while keeping `legacy` mode as the default for 100% backward compatibility with existing pipelines.
#### 6. π° True Zero-Startup-Fee ($0.00005 vs. $0.025 on typical actors)
Other scrapers charge a hidden **$0.025 penalty fee** every single time they start. If you run a scheduled job 10 times a day, you pay **$7.50/month in startup taxes alone** before receiving a single row! With UnitBytes, the start fee is virtually zero ($0.00005) β you pay strictly for the successful data points you extract.
#### 7. π‘οΈ Unbreakable Rate-Limit Resilience with Auto Residential Proxies & PPE Budget Limits
Google Trends aggressively blocks scraping traffic and datacenter IPs with HTTP 429 rate limits. Our crawler engine handles anti-scraping automatically:
- **Zero-Config Residential Proxies on Apify Cloud**: Auto-enforces high-grade Apify Residential proxies on cloud runs even if omitted from API requests.
- **Smart Soft-Block vs. Real Zero Detection**: Automatically detects soft IP throttles with automatic proxy rotation per worker thread, and retries. If a search term genuinely has zero search data, it exits cleanly in <2s with $0.00 charged.
- **Pay-Per-Event Budget Guard**: Full native integration with Apify's `maxTotalChargeUsd` budget limitβautomatically trips an internal circuit breaker and safely stops before exceeding your designated spend cap.
#### 8. π€ AI Agent & Automation Native (Apify MCP Server Ready)
Plug this scraper directly into **Claude Code, Cursor, Claude Desktop, or custom LLM agents** via the hosted Apify MCP server β no API token configuration needed if your client supports Apify OAuth!
***
### π₯ Side-by-Side Feature Matrix vs. Market Alternatives
| Feature / Capability | Other Scrapers | **This Scraper (UnitBytes)** |
| :--- | :--- | :--- |
| **Available Endpoints** | Usually only 1 or 2 modes | π **All 5 Endpoints + `all` Combined Mode in 1 Actor** |
| **Search Properties** | β Locked to Web only | π― **All 5 Properties**: Web, YouTube, Shopping (Froogle), Images & News |
| **Keyword Capacity** | Capped at 5 keywords per run | π **Up to 5 Comparative OR up to 100 Keywords in Bulk (`compare_keywords: false`)** |
| **Direct URL Pasting** | Manual parameter entry only | π **Paste `trends.google.com` URLs directly (`trends_urls`)** |
| **Spreadsheet Compatibility** | Nested JSON only (unusable in Excel) | π **Dual Output**: 1-click **Flat CSV/Excel** rows OR **Legacy JSON** |
| **Startup Penalty Fee** | Often **$0.025 per start** on other actors | π° **$0.00 Startup Fee** ($0.00005) β run small batches with zero penalty |
| **Result Pricing** | $1.00β$2.50 / 1k or $30/mo subscription | β‘ **$0.30 β $0.45 / 1,000 results** (4-Tier Volume PPE) |
| **Anti-Blocking Protection** | Basic retries on same IP (high failure rate) | π‘οΈ **Automated Anti-Blocking & Dynamic Residential Proxy Rotation** |
| **Enriched Context** | Raw keyword strings only | π° **News articles, volume growth %, breakout tags (+5000%), & entity categories** |
| **AI Agent Readiness** | Manual integration | π€ **Native compatibility with Apify MCP, N8N, Make, and LangChain** |
***
### π‘ 5 Core Intelligence Endpoints
Select your desired mode using the `scrape_type` dropdown:
#### 1. π `trending_now` β Real-Time Search Pulses
Discover what the world is searching for *right now*. Monitor viral breakout spikes hourly with search volume estimates, growth percentages, category tags, and context-rich news articles.
- **Best for:** News aggregators, social media managers, viral product hunters.
- π‘ **Profit Playbook**: Catch viral product waves and breaking news 6β12 hours before they peak on TikTok, Reddit, or Twitter. Spin up affiliate pages, write trending content, or launch targeted ads with zero competitor bidding.
```json
{
"scrape_type": "trending_now",
"error": false,
"error_message": null,
"data": [
{
"keyword": "Champions League Draw",
"volume": 500000,
"volume_growth_pct": 850,
"topic_names": ["Soccer", "Sports"],
"started_timestamp": "2026-09-12T14:00:00+00:00",
"news": [
{
"title": "Champions League group stage draw results and reactions...",
"source": "Sky Sports",
"url": "https://..."
}
]
}
]
}
```
***
#### 2. π `interest_over_time` β Historical Timelines (2004 β Today)
Analyze relative search interest (0β100 index) over any timeframe. Compare up to 5 keywords side-by-side on the exact same normalized index to track macro market trends, seasonality, and brand trajectory.
- **Best for:** E-commerce forecasting, algorithmic market research, brand sentiment analysis.
- π‘ **Profit Playbook**: Pinpoint the exact calendar week annual seasonal demand surges (e.g. "summer fashion", "tax prep", "fitness gifts"). Time your inventory orders and ad spend weeks ahead of the competition.
```json
{
"scrape_type": "interest_over_time",
"error": false,
"error_message": null,
"data": [
{
"date": "2026-09-01T00:00:00+00:00",
"OpenAI": 85,
"Anthropic": 42,
"isPartial": false
}
]
}
```
***
#### 3. πΊοΈ `interest_by_region` β Geographic Demand Heatmaps
Pinpoint exactly where consumer demand is centralized. Filter by **Country**, **Region (State/Province)**, **Metro DMA (Designated Market Area)**, or **City**.
- **Best for:** Local SEO optimization, targeted PPC ad spend, geographical product rollouts.
- π‘ **Profit Playbook**: Stop wasting ad budget nationally. Find the top 3 states or metro cities with 5x higher purchase intent, cut ad spend in low-demand areas, and boost ROAS immediately.
```json
{
"scrape_type": "interest_by_region",
"error": false,
"error_message": null,
"data": [
{
"geoName": "California",
"geo": "US",
"OpenAI": 92,
"Anthropic": 84
},
{
"geoName": "New York",
"geo": "US",
"OpenAI": 88,
"Anthropic": 76
}
]
}
```
***
#### 4. π `related_queries` β Long-Tail & Breakout Keyword Mining
Unearth the exact search queries people enter alongside your target keywords. Automatically separates established **"Top"** queries from explosive **"Rising"** breakout queries (up to `+5000%` growth).
- **Best for:** SEO keyword discovery, competitor gap analysis, blog post roadmap planning.
- π‘ **Profit Playbook**: Queries labeled with **"+5,000% Breakout"** represent explosive buyer searches where Google has almost zero established page-one search results yet. Target them immediately for effortless page-one SEO rankings.
```json
{
"scrape_type": "related_queries",
"error": false,
"error_message": null,
"data": [
{
"top": [
{ "query": "chatgpt login", "value": 100 },
{ "query": "chatgpt 5 release", "value": 85 }
]
},
{
"rising": [
{ "query": "chatgpt voice mode free", "value": 4500 }
]
}
]
}
```
***
#### 5. π·οΈ `related_topics` β Knowledge Graph Entity Intelligence
Extract Google's contextual entity groupings. Understand how Google's AI categorizes concepts, companies, and industries associated with your niche.
- **Best for:** Semantic SEO, topical authority building, programmatic entity optimization.
- π‘ **Profit Playbook**: Extract Google's Knowledge Graph entity IDs (`mid`) and topical groupings to build semantic topical clusters that Google's AI Overviews and search engines cite as primary authorities.
```json
{
"scrape_type": "related_topics",
"error": false,
"error_message": null,
"data": [
{
"top": [
{
"topic_title": "ChatGPT",
"value": 100,
"mid": "/g/11khcfz0y2",
"type": "Topic"
},
{
"topic_title": "OpenAI",
"value": 3,
"mid": "/g/11bxc656v6",
"type": "Artificial intelligence company"
}
]
},
{
"rising": [
{
"topic_title": "Artificial intelligence",
"value": 170,
"mid": "/m/0mkz",
"type": "Field of study"
}
]
}
]
}
```
***
### π― Multi-Platform Search Properties: Target Web, YouTube, Shopping, Images & News
Google maintains completely separate search indexes for its specialized platforms. A keyword that looks stable on general Web search may be exploding on **YouTube** or surging in **Google Shopping** buyer demand.
Select your target property using the **`gprop` (Search Property & Index)** dropdown:
| Google Property | Target Audience & Use Case | What Google's Dedicated Index Measures |
| :--- | :--- | :--- |
| ποΈ **Google Shopping (`froogle`)** | E-commerce brands, dropshippers, retail analysts | **Commercial buying intent**: Real consumers actively searching to purchase products, compare prices, and check availability. |
| π₯ **YouTube Search (`youtube`)** | Video creators, YouTubers, game studios | **Video consumption demand**: Viewers seeking tutorials, walkthroughs, reviews, and video entertainment. |
| πΌοΈ **Image Search (`images`)** | Designers, visual artists, print-on-demand brands | **Visual asset intent**: Users searching for infographics, wallpapers, memes, photos, and aesthetic patterns. |
| π° **News Search (`news`)** | PR agencies, journalists, corporate brand monitors | **Editorial & media momentum**: Real-time coverage across global news publishers, wire services, and journalists. |
| π **Web Search (`web`)** | SEOs, content strategists, general researchers | **General navigational & informational queries**: Google's universal search engine index (Default). |
> \[!TIP]
> **Empirically Proven Distinct Datasets**: For example, querying `"minecraft"` returns **physical merchandise** (`lego minecraft`, `minecraft switch`, `squishy`) on Google Shopping, **video creation & mods** (`minecraft build`, `horror mod`) on YouTube, and **graphic assets** (`minecraft skin`, `fanart`) on Image Search. Competitors locked to Web search completely miss this intelligence.
***
### π Output Formats: 1-Click Excel/CSV vs. Legacy JSON
Choose how you want your results structured using the `output_format` dropdown:
#### 1. π `flat` β Spreadsheet & No-Code Ready (Best for Excel, CSV, Google Sheets)
Outputs **one clean row per data point**. Clicking **Export to Excel / CSV** in Apify generates immediate, cleanly formatted columns without unparsed JSON or `[object Object]` cells.
- **Best for:** Marketing teams, SEO analysts, Airtable, Zapier, Google Sheets, PowerBI.
**What your exported Excel / CSV spreadsheet looks like:**
| scrape_type | keyword | value | date | geoName |
| :--- | :--- | :--- | :--- | :--- |
| `interest_over_time` | OpenAI | 92 | 2026-09-02T00:00:00Z | United States |
| `interest_over_time` | OpenAI | 86 | 2026-09-03T00:00:00Z | United States |
| `interest_over_time` | Anthropic | 42 | 2026-09-02T00:00:00Z | United States |
| `interest_over_time` | Anthropic | 48 | 2026-09-03T00:00:00Z | United States |
```json
{
"scrape_type": "interest_over_time",
"event_index": 1,
"error": false,
"keyword": "AI",
"value": 92,
"date": "2026-09-02T00:00:00+00:00"
}
```
#### 2. π¦ `legacy` β Classic Single-Object Envelope (Default β 100% Backward Compatible)
Packages all extracted data into a single nested object envelope with input metadata:
- **Best for:** Existing automated pipelines, custom backend code, and historical workflows.
```json
{
"scrape_type": "interest_over_time",
"error": false,
"error_message": null,
"input_summary": { "keywords_count": 2, "timeframe": "today 1-m", "geo": "US" },
"data": [
{ "date": "2026-09-02T00:00:00+00:00", "AI": 92, "Python": 7 },
{ "date": "2026-09-03T00:00:00+00:00", "AI": 86, "Python": 7 }
]
}
```
***
### β±οΈ Timeframe vs. Data Granularity Guide
Google Trends automatically adjusts the time intervals of data points depending on the length of your chosen timeframe. Use this cheat sheet to select the right window:
| Timeframe Option | Granularity Returned | Ideal Use Case |
| :--- | :--- | :--- |
| `now 1-H`, `now 4-H` | **Minute-by-minute** | Breaking news, viral spikes, live sports events |
| `now 1-d`, `now 7-d` | **Hourly intervals** | Weekly campaign tracking, product launch momentum |
| `today 1-m`, `today 3-m` | **Daily data points** | Monthly performance audits, seasonal trend tracking |
| `today 12-m`, `today 5-y` | **Weekly data points** | Multi-year demand forecasting, competitor benchmarking |
| `all` (2004 β Present) | **Monthly data points** | Macro industry evolution, historical retrospective analysis |
***
### π Transparent Pay-Per-Event Pricing (No Start Fee Penalty)
Stop paying high recurring monthly subscriptions or hidden startup fees. This actor operates on Apify's **Pay-Per-Event (PPE)** model with full **Apify Store Discounts** enabled:
| Benefit | Details |
| :--- | :--- |
| **Zero Start Fee Penalty ($0.00005)** | Other actors often charge **$0.025 every time their scraper runs**. We charge virtually $0 to start, saving you money on scheduled queries. |
| **Industry-Leading Result Price ($0.00045)** | Only **$0.45 per 1,000 results** ($0.00045 per item) β significantly cheaper than any competing Google Trends scraper. |
| **Apify Store Discounts Supported** | Volume rates scale down even further for Starter, Scale, and Business subscription plans. |
| **Residential Proxies Included** | Built-in smart residential proxy rotation is included at no additional charge. |
| **No Compute Time Fees** | You never pay for startup time, container memory, or scrape runtime delays. |
| **Zero-Risk Guarantee** | Failed requests or empty queries are never charged. |
#### π·οΈ 4-Tier Subscription Pricing Schedule
Thanks to **Apify Store Discounts**, your per-result price automatically scales down based on your Apify subscription tier:
| Apify Plan Tier | Discount Level | Price per 1,000 Results | Unit Price per Result | Run Start Fee |
| :--- | :--- | :--- | :--- | :--- |
| **Free** | Base Rate | **$0.45** | $0.00045 | **$0.00** ($0.00005) |
| **Starter** | ~11% Off | **$0.40** | $0.00040 | **$0.00** ($0.00005) |
| **Scale** | ~22% Off | **$0.35** | $0.00035 | **$0.00** ($0.00005) |
| **Business** | ~33% Off | **$0.30** | $0.00030 | **$0.00** ($0.00005) |
> \[!TIP]
> **Zero Startup Penalties**: Unlike other scrapers that charge up to **$0.025 on every single run start**, UnitBytes charges virtually **$0.00 to start** across all tiers.
#### π₯ Real-World Cost Comparison (100 Runs / 5,000 Results)
| Solution | Run Start Fee | Price per 1,000 Items | Total Cost | Savings |
| :--- | :--- | :--- | :--- | :--- |
| π **UnitBytes Google Trends Scraper** | **$0.00005** | **$0.45** | **$2.25** | **Best Value** |
| Other Actors | **$0.025** | $0.50 | **$5.00** | +122% More (2.2x) |
| Other Actors | $0.00 | $3.00 | **$15.00** | +566% More (6.6x) |
| Other Actors | $0.00005 | $5.00 | **$25.00** | +1,011% More (11x) |
| Other Actors | **$0.025** | $25.00 | **$127.50** | +5,566% More (56x) |
-------------------------------------------------------------------------
### π― High-Value Playbooks: How Users Win With This Scraper
#### ποΈ E-Commerce & Dropshipping: "Find Breakout Products Before Ad Costs Explode"
- **The Problem:** By the time a product trends on TikTok or Amazon Best Sellers, ad competition is fierce and margins are wiped out.
- **The Playbook:** Run `trending_now` on a daily schedule to catch viral product surges in their first 6 hours. Cross-reference with `interest_over_time` (5-year timeframe) to verify if the surge is an ephemeral fad or the beginning of a sustained seasonal buying curve.
- **Result:** Source and launch inventory 3β4 weeks before mass competition enters the market.
#### βοΈ SEO & Content Creators: "Rank on Page 1 With Zero Backlinks"
- **The Problem:** Ranking for saturated head terms requires high domain authority and months of expensive backlink building.
- **The Playbook:** Input your core seed keywords into `related_queries` and filter for terms with the **`+5,000% Breakout`** flag. These represent queries with massive surge volume where existing search results are sparse or outdated.
- **Result:** Capture instant organic traffic and first-mover topical authority before competitors even identify the keywords.
#### πΊοΈ Performance Marketers & Local Agencies: "Slash Ad Waste by 40%"
- **The Problem:** Running national campaigns burns ad spend in low-interest states and cities.
- **The Playbook:** Query `interest_by_region` with `geo_resolution: "DMA"` or `"REGION"`. Identify which specific metro areas or states have index scores of 80β100 vs. regions scoring below 20.
- **Result:** Reallocate ad budget to high-density demand centers, lowering customer acquisition cost (CAC) and increasing ROAS.
#### πΈ Quantitative Trading & Financial Research: "Front-Run Consumer Demand Shifts"
- **The Problem:** Financial reports and earnings releases are lagging indicators.
- **The Playbook:** Track multi-year `interest_over_time` for publicly traded brands, crypto tokens, commodities, and retail tickers. Spikes in retail search volume often precede volume expansion and volatility.
- **Result:** Real-time consumer attention datasets feed directly into quantitative alpha and sentiment models.
***
### π€ AI & Workflow Automations
Easily feed live search trends into your automated workflows and AI agents:
- π **N8N & Make (Integromat)**: Trigger automated content creation or Slack alerts whenever a keyword spikes.
- π€ **Model Context Protocol (MCP)**: Connect this scraper directly to **Cursor, Claude Desktop, or custom AI Agents** via the Apify MCP server to give your LLM live Google Trends research capabilities.
- π **LangChain & LlamaIndex**: Use Apify's official document loaders to build retrieval-augmented market intelligence bots.
***
### π» Quick Start Code Examples
Integrate effortlessly into any language or workflow using the official Apify Client:
#### Python
```python
from apify_client import ApifyClient
client = ApifyClient("YOUR_APIFY_TOKEN")
## Run Google Trends Scraper
run = client.actor("unitbytes/google-trends-scraper").call(run_input={
"scrape_type": "interest_over_time",
"keywords": ["OpenAI", "Anthropic", "DeepSeek"],
"output_format": "flat", # "flat" for 1-click Excel/CSV rows, or "legacy" for single object envelope
"timeframe_type": "predefined",
"predefined_timeframe": "today 12-m",
"geo_selection_type": "Common Countries",
"common_geo": "US",
"max_events": 100
})
## Fetch and inspect the dataset
dataset = client.dataset(run["defaultDatasetId"]).list_items().items
for result in dataset:
print(result)
```
#### Node.js / JavaScript
```javascript
import { ApifyClient } from 'apify-client';
const client = new ApifyClient({ token: 'YOUR_APIFY_TOKEN' });
const run = await client.actor('unitbytes/google-trends-scraper').call({
scrape_type: 'related_queries',
keywords: ['AI Tools'],
output_format: 'flat', // 'flat' for tabular rows, or 'legacy' for classic JSON
timeframe_type: 'predefined',
predefined_timeframe: 'today 3-m',
common_geo: 'US',
max_events: 50
});
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items);
```
***
### βοΈ Input Configuration
| Parameter | Type | Description |
| :--- | :--- | :--- |
| `scrape_type` | `string` | Endpoint to query: `interest_over_time` (default), `trending_now`, `interest_by_region`, `related_queries`, `related_topics`, or **`all`** (runs all 4 keyword endpoints in 1 run) |
| `output_format` | `string` | Data layout: `legacy` (default, single nested JSON envelope) or `flat` (1-click tabular rows for Excel/CSV exports) |
| `keywords` | `array` | Target search terms (up to 5 in comparative mode, or up to **100** when `compare_keywords: false`). Required unless using `trending_now` or `trends_urls` |
| `compare_keywords` | `boolean` | `true` (default) compares up to 5 keywords on a shared 0β100 scale. Set `false` to run up to **100 keywords in bulk**, each on its own independent 0β100 scale |
| `trends_urls` | `array` | Optional list of `https://trends.google.com/trends/explore?...` or `/trending?...` URLs to automatically parse `keywords`, `geo`, `timeframe`, and `gprop` |
| `predefined_timeframe` | `string` | Quick timeframes: `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` (also accepts shorthands like `1h`, `4h`, `24h`, `7d`, `30d`, `3m`, `1y`, `5y`) |
| `common_geo` | `string` | Country filter (e.g., `US`, `GB`, `DE`, `FR`, `CA`, `AU`) or leave blank for worldwide |
| `geo_resolution` | `string` | Regional granularity for `interest_by_region`: `COUNTRY`, `REGION`, `CITY`, or `DMA` |
| `gprop` | `string` | Google property filter: `""` (Web Search), `images`, `news`, `froogle` (Shopping), `youtube` |
| `category` | `integer` | Google Trends Topic Category ID (`0` = All Categories, `3` = Arts & Entertainment, `5` = Computers & Electronics, `7` = Finance, `8` = Games, `12` = Business & Industrial, `16` = News, `18` = Shopping, `20` = Sports, `45` = Health, `67` = Travel, `71` = Food & Drink, `174` = Science, etc.) |
| `max_events` | `integer` | Cap on results returned. Controls your total spend |
> π‘ **100% Drop-In API Shorthands & Migration Aliases Supported**: When calling via REST API or SDK, you can also pass shorthand aliases such as `terms` / `searchTerms` / `searchTerm` / `queries` / `query` / `q` (`keywords`), `geo` / `country` / `region` / `trendingSearchesGeo`, `time_range` / `timeRange` / `timeframe` / `date` / `customTimeRange` (preset shorthands like `"7d"`, `"30d"`, `"3m"`, `"1y"` or custom ranges like `"2025-01-01 2025-03-01"` and `"2025-01-01 to 2025-03-01"`), `search_type` / `searchType` / `property` (`gprop`), `cat` (`category`), `dataTypes` / `data_types` (array of endpoints to run), `includeInterestOverTime` / `includeGeoData` / `includeRelatedSearches` / `includeRelatedTopics` (boolean dataset flags), `compareKeywords`, `startUrls` / `start_urls`, `mode`, and `outputFormat` / `outputType`. All existing Web Console and API field names remain 100% unchanged and prioritized.
***
### π‘ Pro Tips for Best Results
1. **Zero-Config Proxies on Apify Cloud**: On Apify Cloud, the scraper automatically assigns and manages Apify Residential Proxies and cycles session IPs. You do not need to configure custom proxies in your API calls or inputs.
2. **Worldwide vs. Country-Specific**: For worldwide data, leave `common_geo` blank. Regional breakdown (`interest_by_region`) is most detailed when a specific country (e.g. `US`, `GB`, `DE`) is chosen.
3. **Multi-Keyword Comparison**: When using `interest_over_time` or `interest_by_region`, providing 2 to 5 keywords gives you directly normalized comparison scores on the same 0β100 scale.
4. **Discovering Hidden Breakouts**: Check the `rising` section of `related_queries`βqueries marked with high percentages or "Breakout" represent emerging search trends with low SEO competition.
5. **1-Click Tabular Rows vs. Nested JSON**: Need clean rows ready for instant Excel, CSV, or Google Sheets export? Set `output_format: "flat"`. For existing developer backends or AI agents expecting a single nested JSON envelope, use `output_format: "legacy"`.
***
#### π MCP Server Setup: Claude Code, Cursor & AI Agents
Connect this scraper directly to **Claude Code**, **Claude Desktop**, **Cursor**, or any MCP-compatible AI agent via the hosted Apify MCP server:
```json
{
"mcpServers": {
"apify": {
"type": "http",
"url": "https://mcp.apify.com/?tools=actors,docs,unitbytes/google-trends-scraper"
}
}
}
```
*No manual API token required in configuration if your client supports Apify OAuth sign-in. Alternatively, pass your Apify API Token in the authorization header.*
***
### β Frequently Asked Questions
**Q: How does this compare to other Google Trends scrapers on Apify?**\
A: Most alternative scrapers only support 1 or 2 endpoints, charge a hidden **$0.025 run-start fee** on every single execution, or return complex nested JSON that breaks in spreadsheets. UnitBytes unifies **all 5 endpoints** in a single actor, provides **1-click Excel/CSV tabular exports**, and charges virtually **$0.00 to start**.
**Q: Can I automate daily or weekly trend monitoring on a schedule?**\
A: Yes! In the Apify Console, go to the **Schedules** tab to run your queries every morning or weekly. Because UnitBytes has no $0.025 start-fee penalty, running 100 automated scheduled jobs costs less than half a penny in startup fees.
**Q: Do I need to buy or configure my own proxies?**\
A: No. High-speed residential proxies are integrated directly into the scraping engine at zero extra charge. On Apify Cloud, the actor automatically provisions and rotates Apify Residential proxies even if you omit proxy parameters when calling via API.
**Q: What happens if Google returns a 429 rate-limit error or soft block?**\
A: The scraper handles anti-scraping automatically. It distinguishes between a throttled proxy IP (triggering immediate session rotation and retries) and a genuinely zero-volume search query.
**Q: What happens if a keyword has no search data or volume?**\
A: If a niche keyword or regional sub-geo has zero search interest on Google Trends, the actor exits cleanly with 0 items in less than 2 seconds, charges $0.00 (`charged_events: 0`), and sets an informative status message. You never pay for empty results.
**Q: Can I set a maximum budget for my run?**\
A: Yes! You can set `maxTotalChargeUsd` in your Apify run configuration. The moment your spending limit is reached, the actor trips an internal circuit breaker, safely saves all extracted items, and completes with exit code 0 without overcharging.
**Q: Is it legal to scrape Google Trends?**\
A: Yes. This Actor extracts only publicly available, aggregate search statistics published by Google Trends and does not collect any personal or private user data. Read Apify's blog post on [the legality of web scraping](https://blog.apify.com/is-web-scraping-legal/) to learn more.
**Q: Can I export data to Excel or CSV?**\
A: Yes! Simply select **`output_format: "flat"`** in the input settings. When the run finishes, click **Export** β **Excel** or **CSV** in the Apify Console for clean, tabular columns with zero nested objects.
**Q: How does billing work?**\
A: You are billed strictly per successful result extracted via Apify's Pay-Per-Event model (see the **Pricing** tab for current rates). You are never charged for actor runtime, proxy bandwidth, or failed requests.
***
*Keywords: Google Trends API, Google Trends scraper, Google Trends real-time, interest over time scraper, related queries extractor, Google Trends keyword research, SEO trend analysis, trending searches API, regional interest data, Apify Google Trends.*
***
### π Complete UnitBytes Data Intelligence Ecosystem
Pair your Google Trends market signals with our specialized search, local intelligence, social, e-commerce, and classifieds scrapers on Apify:
| Suite / Category | Published UnitBytes Actors | Best For |
| :--- | :--- | :--- |
| **π Google Maps Local Intelligence** | **[Google Maps Reviews Scraper ($0.25/1k)](https://apify.com/unitbytes/google-maps-reviews-scraper?fpr=939u3w\&fp_sid=ecosystem)** Β· **[Google Maps Email & Leads Scraper ($0.50/1k)](https://apify.com/unitbytes/google-maps-leads-scraper?fpr=939u3w\&fp_sid=ecosystem)** Β· **[Google Maps Photos & Menus Scraper](https://apify.com/unitbytes/google-maps-photos-scraper?fpr=939u3w\&fp_sid=ecosystem)** Β· **[Google Maps Review Monitor & Tracker](https://apify.com/unitbytes/google-maps-reviews-tracker?fpr=939u3w\&fp_sid=ecosystem)** Β· **[Google Maps Contributor & Local Guides](https://apify.com/unitbytes/google-maps-contributor-scraper?fpr=939u3w\&fp_sid=ecosystem)** | Up to 10,000 reviews/place, verified B2B emails/phones, full-res photos/menus, ORM change tracking & Local Guide profiles |
| **π°π· Naver & Korean Local Suite** | **[Naver Place & Map Scraper](https://apify.com/unitbytes/naver-place-scraper?fpr=939u3w\&fp_sid=ecosystem)** Β· **[Naver Place Reviews Scraper ($0.50/1k)](https://apify.com/unitbytes/naver-place-reviews-scraper?fpr=939u3w\&fp_sid=ecosystem)** Β· **[Naver Map Leads & Menus Scraper](https://apify.com/unitbytes/naver-map-scraper?fpr=939u3w\&fp_sid=ecosystem)** | Korean local business leads, Naver Place visitor/blog reviews, menus & ratings (λ€μ΄λ² νλ μ΄μ€Β·μ§λ) |
| **π½ Reddit Intelligence Suite** | **[Reddit Scraper & Media API ($0.50/1k)](https://apify.com/unitbytes/reddit-scraper?fpr=939u3w\&fp_sid=ecosystem)** Β· **[Reddit Search & Brand Monitor](https://apify.com/unitbytes/reddit-search-scraper?fpr=939u3w\&fp_sid=ecosystem)** Β· **[Reddit Subreddit Scraper](https://apify.com/unitbytes/reddit-subreddits-scraper?fpr=939u3w\&fp_sid=ecosystem)** Β· **[Reddit Comments & Sentiment Scraper](https://apify.com/unitbytes/reddit-comments-scraper?fpr=939u3w\&fp_sid=ecosystem)** | Posts, full nested comment trees, subreddit feeds, user profiles & B2B social listening |
| **π China & Global E-Commerce Sourcing** | **[1688 Wholesale Scraper](https://apify.com/unitbytes/1688-scraper?fpr=939u3w\&fp_sid=ecosystem)** Β· **[1688 Global & Arbitrage Scraper](https://apify.com/unitbytes/1688-global-scraper?fpr=939u3w\&fp_sid=ecosystem)** Β· **[1688 Image Search Scraper](https://apify.com/unitbytes/1688-image-search-scraper?fpr=939u3w\&fp_sid=ecosystem)** Β· **[Alibaba B2B & Factory Scraper](https://apify.com/unitbytes/alibaba-scraper?fpr=939u3w\&fp_sid=ecosystem)** Β· **[Alibaba Supplier Audits](https://apify.com/unitbytes/alibaba-supplier-scraper?fpr=939u3w\&fp_sid=ecosystem)** Β· **[Alibaba Store Inventory](https://apify.com/unitbytes/alibaba-seller-inventory-scraper?fpr=939u3w\&fp_sid=ecosystem)** Β· **[Taobao & Tmall Scraper](https://apify.com/unitbytes/taobao-tmall-scraper?fpr=939u3w\&fp_sid=ecosystem)** Β· **[Taobao Seller Shop Catalog](https://apify.com/unitbytes/taobao-seller-shop-scraper?fpr=939u3w\&fp_sid=ecosystem)** Β· **[Goofish (Xianyu) Scraper](https://apify.com/unitbytes/goofish-scraper?fpr=939u3w\&fp_sid=ecosystem)** Β· **[Goofish Fast Search](https://apify.com/unitbytes/goofish-xianyu-search-scraper?fpr=939u3w\&fp_sid=ecosystem)** | Direct Chinese factory pricing, multi-currency arbitrage, reverse image supplier lookup, verified Gold Suppliers, Taobao shops & secondhand deals |
| **π US Classifieds, Autos & Real Estate** | **[Facebook Marketplace Scraper](https://apify.com/unitbytes/Facebook-Marketplace-Scraper?fpr=939u3w\&fp_sid=ecosystem)** ([Seller Intel](https://apify.com/unitbytes/facebook-marketplace-seller-scraper?fpr=939u3w\&fp_sid=ecosystem) Β· [Vehicles](https://apify.com/unitbytes/facebook-marketplace-vehicle-scraper?fpr=939u3w\&fp_sid=ecosystem) Β· [Property](https://apify.com/unitbytes/facebook-marketplace-property-scraper?fpr=939u3w\&fp_sid=ecosystem) Β· [Status Checker](https://apify.com/unitbytes/facebook-marketplace-status-checker?fpr=939u3w\&fp_sid=ecosystem)) Β· **[OfferUp Scraper](https://apify.com/unitbytes/offerup-scraper?fpr=939u3w\&fp_sid=ecosystem)** ([Vehicles](https://apify.com/unitbytes/offerup-vehicles-cars-scraper?fpr=939u3w\&fp_sid=ecosystem) Β· [Seller Inventory](https://apify.com/unitbytes/offerup-seller-inventory-scraper?fpr=939u3w\&fp_sid=ecosystem) Β· [Deal Monitor](https://apify.com/unitbytes/offerup-deal-monitor-scraper?fpr=939u3w\&fp_sid=ecosystem)) Β· **[Craigslist Scraper](https://apify.com/unitbytes/craigslist-scraper?fpr=939u3w\&fp_sid=ecosystem)** ([Cars & Trucks](https://apify.com/unitbytes/craigslist-cars-vehicles-scraper?fpr=939u3w\&fp_sid=ecosystem) Β· [Real Estate](https://apify.com/unitbytes/craigslist-real-estate-property-scraper?fpr=939u3w\&fp_sid=ecosystem) Β· [Jobs & Gigs](https://apify.com/unitbytes/craigslist-jobs-gigs-services-scraper?fpr=939u3w\&fp_sid=ecosystem)) | Local deals, seller profiles, used car arbitrage, property rentals, real-time deal alerts & nationwide classifieds |
***
### π Support, Bug Reports & Feature Requests
Need help with your Google Trends extraction, found a bug, or want a custom feature / higher volume endpoint?
- π **Bug Reports & Issues**: Open an issue on the [Apify Issues Tab](https://apify.com/unitbytes/google-trends-scraper/issues?fpr=939u3w)
- π‘ **Feature Requests & Custom Enhancements**: Submit your request on the [Issues Tab](https://apify.com/unitbytes/google-trends-scraper/issues?fpr=939u3w)
- π¬ **Apify Creator Profile**: [unitbytes on Apify](https://apify.com/unitbytes)
***
### βοΈ Compliance & Privacy
This Actor is an independent tool and is not affiliated with, endorsed by, or sponsored by Google LLC or Alphabet Inc. "Google", "Google Trends", "YouTube", and related marks and logos are the registered trademarks of Google LLC and Alphabet Inc.
This tool extracts only publicly available, aggregate search volume indices and statistical interest metrics published by Google Trends. It does not collect or process any personal data or private user information. To learn more about the legal framework surrounding public data extraction, read Apify's guide on [the legality of web scraping](https://blog.apify.com/is-web-scraping-legal/).
# Actor input Schema
## `scrape_type` (type: `string`):
Select the type of data to retrieve. 'All-in-One' extracts all 4 keyword datasets at once. 'Trending now' ignores keywords.
## `keywords` (type: `array`):
Enter the terms you want to analyze (up to 5 when comparing on a shared scale, or up to 100 when 'Compare Keywords' is unchecked). REQUIRED for all types EXCEPT 'Trending now'.
## `compare_keywords` (type: `boolean`):
When enabled (default), up to 5 keywords are compared side-by-side on the same 0β100 scale. Uncheck to bulk-scrape large keyword lists (up to 100 keywords in one run), where each keyword is scored independently on its own 0β100 scale.
## `scrape_types` (type: `array`):
Optionally specify multiple datasets to extract in one run (e.g. \['interest_over_time', 'related_queries']). Overrides 'Scrape Type' when provided.
## `trends_urls` (type: `array`):
Optionally paste trends.google.com/trends/explore or /trending URLs directly. Automatically extracts keywords (q), country/region (geo), timeframe (date), and search property (gprop).
## `gprop` (type: `string`):
Target specific Google search indexes: 'Google Shopping' for physical product demand, 'YouTube Search' for video creator trends, 'Image Search' for visual assets, 'News Search' for media spikes, or 'Web Search' (default).
## `category` (type: `integer`):
Filter by Google Trends category ID (0 = All Categories, 3 = Arts & Entertainment, 5 = Computers & Electronics, 7 = Finance, 12 = Business & Industrial, 18 = Shopping, 45 = Health, 71 = Food & Drink).
## `timeframe_type` (type: `string`):
Choose between a predefined range (easier) or a custom specific range.
## `predefined_timeframe` (type: `string`):
Select a standard time window.
## `custom_timeframe` (type: `string`):
Format: 'YYYY-MM-DD YYYY-MM-DD'. Example: '2023-01-01 2023-12-31'. Leave empty if using Predefined.
## `geo_selection_type` (type: `string`):
Choose how to specify the location.
## `common_geo` (type: `string`):
2-letter ISO country code (e.g. 'US', 'GB', 'DE', 'CA', 'IN'), full country name, or 'WORLDWIDE' for global search interest.
## `custom_geo_code` (type: `string`):
Specific code like 'US-NY' (New York) or 'US-CA' (California). Leave empty for Worldwide when 'Custom Geo Code' is selected.
## `output_format` (type: `string`):
Choose dataset output structure. 'legacy' preserves backward compatibility (single nested object). 'flat' outputs one record per data point (best for Excel, CSV, Google Sheets).
## `geo_resolution` (type: `string`):
Level of detail for 'Interest by region'.
## `inc_low_vol` (type: `boolean`):
Get data even for regions with low search volume (slower).
## `trending_language` (type: `string`):
Language for 'Trending now' scrape type.
## `trending_hours` (type: `integer`):
Hours back for 'Trending now' (Max 191).
## `proxyConfiguration` (type: `object`):
Crucial for avoiding Google blocks. Use Apify Proxy (Residential) for best results.
## `max_events` (type: `integer`):
Internal limit for backward compatibility
## `acknowledge_costs` (type: `boolean`):
Internal flag for backward compatibility
## Actor input object example
```json
{
"scrape_type": "interest_over_time",
"keywords": [
"OpenAI",
"ChatGPT"
],
"compare_keywords": true,
"gprop": "web",
"category": 0,
"timeframe_type": "predefined",
"predefined_timeframe": "today 12-m",
"custom_timeframe": "2023-01-01 2023-12-31",
"geo_selection_type": "Common Countries",
"common_geo": "US",
"custom_geo_code": "",
"output_format": "legacy",
"geo_resolution": "COUNTRY",
"inc_low_vol": false,
"trending_language": "en",
"trending_hours": 24,
"proxyConfiguration": {
"useApifyProxy": true,
"apifyProxyGroups": [
"RESIDENTIAL"
]
},
"max_events": 10000,
"acknowledge_costs": true
}
```
# Actor output Schema
## `results` (type: `string`):
No description
# API
You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.
## JavaScript example
```javascript
import { ApifyClient } from 'apify-client';
// Initialize the ApifyClient with your Apify API token
// Replace the '
