# Google Trends Scraper (`myagizm/google-trends-scraper`) Actor

Scrape Google Trends trending searches by country — title, traffic estimate, related news articles and timestamp. No login, no API key.

- **URL**: https://apify.com/myagizm/google-trends-scraper.md
- **Developed by:** [MYM](https://apify.com/myagizm) (community)
- **Categories:** SEO tools
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.20 / 1,000 trend results

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).

# README

## Google Trends Scraper — daily trends, interest over time & related queries (No API Key)

<p align="center">
  <a href="https://apify.com/myagizm/google-trends-scraper"><img src="https://img.shields.io/badge/Apify-Actor-00b96b?logo=apify&logoColor=white" alt="Apify Actor"></a>
  <img src="https://img.shields.io/badge/No%20API%20Key-required-blue" alt="No API Key required">
  <img src="https://img.shields.io/badge/No%20Login-needed-blue" alt="No Login needed">
  <img src="https://img.shields.io/badge/No%20Cookies-needed-blue" alt="No cookies needed">
  <img src="https://img.shields.io/badge/Export-JSON%20%7C%20CSV%20%7C%20Excel%20%7C%20XML-orange" alt="Export formats">
  <img src="https://img.shields.io/badge/MCP-AI%20agents-8A2BE2" alt="MCP AI agents">
  <img src="https://img.shields.io/badge/Pricing-pay%20per%20result-success" alt="Pay per result">
</p>

**Scrape Google Trends in five modes** — no API key, no Google Cloud project, no login. Pick `daily` for trending searches, `interest_over_time` for a keyword's curve, `related_queries` for rising and top associated searches, `interest_by_region` for geographic breakdowns, or `autocomplete` for suggestion mining. Set the country, timeframe, language, category, and search property (web, images, news, YouTube, shopping). Export to JSON, CSV, Excel, or XML.

> **Get your first trends free in under 2 minutes** — pick a mode, click Start. No configuration, no credit card to try.

***

### Table of contents

- [What can it do?](#what-can-it-do)
- [Who uses it?](#who-uses-it)
- [What data can I scrape?](#what-data)
- [How to use it](#how-to)
- [Input example](#input-example)
- [Output example](#output-example)
- [Pricing](#pricing)
- [Tips](#tips)
- [Want other data?](#want-other-data)
- [AI agents (MCP)](#mcp)
- [Integrations & API](#integrations)
- [Support](#support)
- [FAQ](#faq)
- [Related searches](#related-searches)
- [Disclaimer](#disclaimer)
- [Resources](#resources)

***

### What can the Google Trends Scraper do? {#what-can-it-do}

- 📈 **Five modes in one actor** — `daily`, `interest_over_time`, `related_queries`, `interest_by_region`, `autocomplete`.
- 🔥 **Daily trending searches** with traffic estimates and the news articles behind each trend.
- 📉 **Interest over time** for your keywords, on any timeframe from the last hour to five years.
- 🔗 **Related and rising queries** — the fastest way to find what people search next.
- 🗺️ **Interest by region** to see where demand actually is.
- ⌨️ **Autocomplete mining** with optional alphabet expansion for long-tail keyword discovery.
- 🌍 **Country, language, and category filters**, plus search property (web, images, news, YouTube, shopping).
- ⏰ **Schedule runs** to build the trend history Google does not keep for you.
- 📤 **Export** to JSON, CSV, Excel, or XML, or pull live via API.

Go beyond the limits of the official Google API: no OAuth app, no app review, no quota juggling — paste your input and collect publicly available data.

***

### Who uses the Google Trends Scraper? {#who-uses-it}

- 🧠 **SEO & content teams** — find rising queries before the competition writes about them.
- 📊 **Market researchers** — quantify seasonal demand and regional differences.
- 🛒 **E-commerce & product teams** — validate demand for a product idea with real search data.
- 📰 **Newsrooms** — catch what a country is searching for right now.
- 🧑‍💻 **Data teams** — build a trend archive by scheduling daily runs.

***

### What data can I scrape? {#what-data}

| Field | Type | Description |
|-------|------|-------------|
| `mode` | string | Which mode produced the row. |
| `query` | string | Trending search or keyword. |
| `title` | string | Trend title (daily mode). |
| `formattedTraffic` | string | Traffic estimate, e.g. `200K+`. |
| `date` | string | Date of the trend snapshot. |
| `source` | string | Source label where Google provides one. |
| `articles` | array | News articles behind the trend: title, source, link. |
| `relatedQueries` | array | Related or rising queries for the trend or keyword. |
| `value` | number | Interest value 0–100 (interest modes). |
| `geo` | string | Region code for the row. |
| `timeframe` | string | Timeframe used for the request. |

> Fields reflect what Google exposes publicly for that item. Values that do not exist for a given item are returned as `null` rather than dropped, so your schema stays stable.

***

### How to scrape Google Trends data {#how-to}

1. **Open the Google Trends Scraper** on [Apify](https://apify.com/myagizm/google-trends-scraper).
2. **Pick a mode** — `daily`, `interest_over_time`, `related_queries`, `interest_by_region`, or `autocomplete`.
3. **Set the country** (`geo`) and, for keyword modes, add your **keywords**.
4. *(Optional)* Set **timeframe**, **language**, **category**, **search property**, and **Max items**.
5. Click **▶ Start** and export the dataset.

No login, no cookies, no proxy configuration. Start with one input to see the output shape, then scale the same run — the fields stay identical, so code written against a test run keeps working.

***

### Input example {#input-example}

```json
{
  "mode": "daily",
  "geo": "US",
  "keywords": [
    "web scraping"
  ],
  "timeframe": "today 12-m",
  "language": "en-US",
  "maxItems": 100
}
```

- **mode** — `daily`, `interest_over_time`, `related_queries`, `interest_by_region`, `autocomplete`.
- **geo** — country or region code, e.g. `US`, `DE`, `TR`.
- **keywords** — required for keyword-based modes.
- **timeframe** — `now 1-H` … `today 5-y` or `all`.
- **language**, **category**, **searchProperty** — locale and vertical filters.
- **alphabetExpand** — in autocomplete mode, expand suggestions across the alphabet.
- **maxItems** — hard cap on rows returned.

***

### Output example {#output-example}

```json
{
  "date": "Tue, 28 Jul 2026 00:50:00 -0700",
  "query": "deshaun watson",
  "title": "deshaun watson",
  "source": "rss",
  "articles": [
    {
      "url": "https://www.espn.com/nfl/story/_/id/49450773/cleveland-browns-2026-week-1-starting-quarterback-deshaun-watson-shedeur-sanders-dillon-gabriel-taylen-green",
      "title": "Who will Browns' starting QB be: Deshaun Watson or Shedeur Sanders?",
      "source": "ESPN"
    }
  ],
  "relatedQueries": [],
  "formattedTraffic": "200+"
}
```

Every run produces a clean dataset you can page through in the Apify Console or pull via API. Export to JSON, CSV, Excel, or XML in one click.

***

### How much will it cost? {#pricing}

Simple, predictable **pay-per-result** pricing — you pay for the rows you actually receive, not for compute time.

- 💸 **Pay per row** — budget is just rows × rate, so you can estimate spend up front.
- 📉 **Volume discounts** — Bronze, Silver, Gold, Platinum, and Diamond Apify plans get progressively lower rates.
- 🆓 **Free to try** — new Apify accounts include monthly free usage, so your first run costs nothing.
- 🚫 **No hidden fees** — no proxy add-on, no per-request API charge, no minimum spend.

See the live rate on the [Apify store page](https://apify.com/myagizm/google-trends-scraper).

***

### Tips {#tips}

- 🔗 **`related_queries` beats keyword tools for freshness** — rising queries show demand before volume data updates.
- ⌨️ **Turn on alphabet expansion** in autocomplete mode for a long-tail keyword harvest in one run.
- 📉 **Interest is relative, not absolute** — a value of 100 is the peak within your timeframe, not a volume.
- 🌍 **Compare `geo` values** to decide which market to launch in first.
- ⏰ **Schedule `daily` mode** and append to one dataset — Google does not give you trend history, but your archive will.
- 🗓️ **Match the timeframe to the question**: `now 1-d` for breaking topics, `today 5-y` for structural trends.

***

### Want other Google data? {#want-other-data}

- 🗺️ **[Google Maps Scraper](https://apify.com/myagizm/google-maps-scraper)** — local business listings with phone, website, rating and coordinates.
- ⭐ **[Google Maps Reviews Scraper](https://apify.com/myagizm/google-maps-reviews-scraper)** — places together with their review text, ratings and authors.
- 📰 **[Google News Scraper](https://apify.com/myagizm/google-news-scraper)** — news headlines, sources and links for any query or country.
- 📱 **[Google Play Scraper](https://apify.com/myagizm/google-play-scraper)** — app listings and user reviews from the Play Store.

Building a multi-platform dataset? The same no-login, pay-per-result approach covers the other networks:

- 🎵 **[TikTok Profile Scraper](https://apify.com/myagizm/tiktok-profile-scraper-v2)** · **[TikTok Video Scraper](https://apify.com/myagizm/tiktok-video-scraper-v2)** · **[TikTok Hashtag Scraper](https://apify.com/myagizm/tiktok-hashtag-scraper-v2)** · **[TikTok Comments Scraper](https://apify.com/myagizm/tiktok-comments-scraper-v2)**
- 🐦 **[X (Twitter) Tweets Scraper](https://apify.com/myagizm/x-tweets-scraper)** · **[X Profile Scraper](https://apify.com/myagizm/x-profile-scraper)** · **[X Trends Scraper](https://apify.com/myagizm/x-trends-scraper)**
- 👔 **[LinkedIn Profile Scraper](https://apify.com/myagizm/linkedin-profile-scraper)** · **[LinkedIn Company Scraper](https://apify.com/myagizm/linkedin-company-scraper)** · **[LinkedIn Jobs Scraper](https://apify.com/myagizm/linkedin-jobs-scraper)**
- 🤖 **[Reddit Scraper](https://apify.com/myagizm/reddit-scraper-v2)** · **[Reddit Search Scraper](https://apify.com/myagizm/reddit-search-scraper-v2)** · **[Reddit Subreddit Scraper](https://apify.com/myagizm/reddit-subreddit-scraper-v2)**
- ▶️ **[YouTube Channel Scraper](https://apify.com/myagizm/youtube-channel-scraper)** · **[YouTube Comment Scraper](https://apify.com/myagizm/youtube-comment-scraper)** · **[YouTube Transcript Scraper](https://apify.com/myagizm/youtube-transcript-scraper)**
- 🗺️ **[Google Maps Scraper](https://apify.com/myagizm/google-maps-scraper)** · **[Google News Scraper](https://apify.com/myagizm/google-news-scraper)**

Browse everything on the **[myagizm store profile](https://apify.com/myagizm)**.

***

### Use the data with AI agents (MCP) {#mcp}

The Google Trends Scraper is available through the **Apify MCP server**, so AI assistants can call it as a tool and pull Google Trends data on demand.

- 🧩 **Claude** — add the Apify MCP server and let Claude fetch and analyse the data.
- 🤖 **ChatGPT** — use the actor as a tool inside research and reporting workflows.
- 🖊️ **Cursor** — pull structured results straight into your coding sessions.

Common AI-agent recipes:

- 🧠 **Content ideas** — "what related queries are rising for this topic?"
- 📊 **Demand check** — "is interest in this product growing or fading over 12 months?"
- 🌍 **Market pick** — "which regions search for this most?"
- 📰 **Daily brief** — "what is trending in this country today and why?"

***

### Integrations & API {#integrations}

Connect the actor to the tools you already use: **Make, Zapier, n8n, Slack, Airbyte, Gumloop, CrewAI, IFTTT, Lindy, GitHub, Google Sheets, and Google Drive** — plus webhooks, Apify Schedules, and the MCP server.

#### Run synchronously and get the dataset (Apify API)

```bash
curl -X POST "https://api.apify.com/v2/acts/myagizm~google-trends-scraper/run-sync-get-dataset-items?token=YOUR_APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"mode": "daily", "geo": "US", "keywords": ["web scraping"], "timeframe": "today 12-m", "language": "en-US", "maxItems": 100}'
```

#### Start a run asynchronously

```bash
curl -X POST "https://api.apify.com/v2/acts/myagizm~google-trends-scraper/runs?token=YOUR_APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"mode": "daily", "geo": "US", "keywords": ["web scraping"], "timeframe": "today 12-m", "language": "en-US", "maxItems": 100}'
```

#### Fetch dataset items later

```bash
curl "https://api.apify.com/v2/acts/myagizm~google-trends-scraper/runs/last/dataset/items?token=YOUR_APIFY_TOKEN&format=csv"
```

Change `format` to `json`, `csv`, `xlsx`, or `xml` to export in your preferred format. The Apify Console also auto-generates ready-to-paste **JavaScript, Python, and CLI** snippets plus an **OpenAPI** spec for this actor.

***

### Support {#support}

Questions, feature requests, or something not looking right? Open an issue on the actor's **[Issues tab](https://apify.com/myagizm/google-trends-scraper/issues)**. Please include the input you used so we can reproduce and fix it quickly.

***

### FAQ {#faq}

#### Do I need a Google Trends API key?

There is no official Google Trends API to buy. This actor reads the public Trends surfaces, so no key, project, or billing is needed.

#### Why are interest values 0–100 instead of search volumes?

That is how Google Trends works: values are normalised to the peak inside your timeframe. Use them for shape and comparison, not absolute volume.

#### Which mode should I use?

`daily` for what is hot now, `interest_over_time` for a keyword's trajectory, `related_queries` for discovery, `interest_by_region` for geography, `autocomplete` for long-tail keywords.

#### Can I get historical trends?

Trends itself exposes limited history. Schedule the actor and append to one dataset to build your own archive.

#### Do I need a Google API key, Cloud project, or billing account?

No. This actor does not use Google's official APIs, so there is no Cloud project, no API key, no quota, and no per-request Google billing.

#### Do I need proxies?

No. Proxy handling is built in and managed for you.

#### Can I export to CSV, Excel, or JSON?

Yes — JSON, CSV, Excel, or XML from the Console, or the API `format` parameter.

#### Can I use it with the Apify API?

Yes, using the sync and async endpoints shown above.

#### Is there an MCP server for AI agents?

Yes. Claude, ChatGPT, and Cursor can call this actor as a tool.

#### Can I schedule runs?

Yes — Apify Schedules, API, or webhooks.

#### How fresh is the data?

No caching: every run reads the current public page.

***

### Related searches {#related-searches}

google trends scraper · google trends api alternative · daily trending searches · interest over time data · related queries scraper · rising search queries · google autocomplete scraper · keyword research data · seasonal demand analysis · interest by region · trend archive builder · google trends csv export

***

### Disclaimer {#disclaimer}

This is an independent tool and is not affiliated with, endorsed by, or sponsored by Google LLC. All product names, logos, and brands are property of their respective owners.

The actor collects only **publicly available** data — the same content any visitor can see without logging in. It never logs in, never bypasses access controls, and never touches private or protected content. You are responsible for how you use the data: if it contains personal data, follow GDPR, CCPA, and other applicable regulations, and respect the platform's terms.

***

### Resources {#resources}

- 📘 [Apify API documentation](https://docs.apify.com/api/v2) — run actors and fetch datasets programmatically.
- 🤖 [Apify MCP server](https://mcp.apify.com) — use this actor as a tool in Claude, ChatGPT, and Cursor.
- 📤 [Dataset export docs](https://docs.apify.com/platform/storage/dataset) — export to JSON, CSV, Excel, and XML.
- ⏰ [Scheduling actor runs](https://docs.apify.com/platform/schedules) — keep your data fresh automatically.
- 🔌 [Apify integrations](https://docs.apify.com/platform/integrations) — n8n, Zapier, Make, Slack, and more.
- 🏪 [myagizm store profile](https://apify.com/myagizm) — the full family of no-login scrapers.

***

## 中文说明 —— Google Trends 抓取工具

**以五种模式抓取 Google Trends** —— 不需要 API Key、Cloud 项目或登录。`daily` 取每日热搜，`interest_over_time` 取关键词趋势曲线，`related_queries` 取相关与上升查询，`interest_by_region` 取地区分布，`autocomplete` 做长尾词挖掘。可设置国家、时间范围、语言、分类与搜索属性（网页 / 图片 / 新闻 / YouTube / 购物）。

> **两分钟内免费拿到第一批数据** —— 填入内容、点击 Start 即可。无需配置，试用不需要信用卡。

### 能做什么

- 📈 **五种模式合一**。
- 🔥 **每日热搜**，含流量估算与背后新闻。
- 📉 **关键词趋势曲线**，时间范围从最近 1 小时到 5 年。
- 🔗 **相关与上升查询** —— 发现下一步搜索方向最快的方式。
- 🗺️ **地区兴趣分布**。
- ⌨️ **自动补全挖掘**，可按字母扩展做长尾采集。
- 🌍 **国家、语言、分类与搜索属性过滤**。
- ⏰ **定时运行**即可自建 Google 不保留的趋势历史。
- 📤 **导出** JSON / CSV / Excel / XML。

无需 OAuth 应用、无需应用审核、无需配额管理 —— 填入内容即可采集公开数据。

### 谁在用

- 🧠 **SEO 与内容团队** —— 在竞品动笔前发现上升查询。
- 📊 **市场研究** —— 量化季节性需求与地区差异。
- 🛒 **电商与产品团队** —— 用真实搜索数据验证选品。
- 📰 **新闻编辑室** —— 掌握某国当下在搜什么。
- 🧑‍💻 **数据团队** —— 定时运行构建趋势档案。

### 可以抓取哪些数据

| 字段 | 类型 | 说明 |
|------|------|------|
| `mode` | string | 该行来自哪个模式 |
| `query` | string | 热搜词或关键词 |
| `title` | string | 趋势标题（daily 模式） |
| `formattedTraffic` | string | 流量估算，如 `200K+` |
| `date` | string | 快照日期 |
| `source` | string | 来源标签 |
| `articles` | array | 趋势背后的新闻：标题、来源、链接 |
| `relatedQueries` | array | 相关 / 上升查询 |
| `value` | number | 兴趣值 0–100（兴趣类模式） |
| `geo` | string | 地区代码 |
| `timeframe` | string | 请求使用的时间范围 |

> 字段取决于平台对外公开了什么。某个条目没有的值会返回 `null` 而不是直接省略，因此你的数据结构始终稳定。

### 使用步骤

1. 打开 [Google Trends 抓取工具](https://apify.com/myagizm/google-trends-scraper)。
2. 选择 **mode**。
3. 设置国家（`geo`），关键词类模式还需填 **keywords**。
4. （可选）设置时间范围、语言、分类、搜索属性与 **Max items**。
5. 点击 **▶ Start** 并导出数据。

### 输入示例

```json
{
  "mode": "daily",
  "geo": "US",
  "keywords": [
    "web scraping"
  ],
  "timeframe": "today 12-m",
  "language": "en-US",
  "maxItems": 100
}
```

### 输出示例

```json
{
  "date": "Tue, 28 Jul 2026 00:50:00 -0700",
  "query": "deshaun watson",
  "title": "deshaun watson",
  "source": "rss",
  "articles": [
    {
      "url": "https://www.espn.com/nfl/story/_/id/49450773/cleveland-browns-2026-week-1-starting-quarterback-deshaun-watson-shedeur-sanders-dillon-gabriel-taylen-green",
      "title": "Who will Browns' starting QB be: Deshaun Watson or Shedeur Sanders?",
      "source": "ESPN"
    }
  ],
  "relatedQueries": [],
  "formattedTraffic": "200+"
}
```

### 价格

采用**按结果计费**：只为真正拿到的数据付费，不按运行时间计费。

- 💸 成本 = 结果数量 × 单价，预算可提前算清。
- 📉 Apify 的 Bronze / Silver / Gold / Platinum / Diamond 套餐享阶梯折扣。
- 🆓 新账号自带每月免费额度，第一次运行不花钱。
- 🚫 无代理附加费、无单次请求费、无最低消费。

实时价格见 [Apify 商店页面](https://apify.com/myagizm/google-trends-scraper)。

### 使用建议

- 🔗 **`related_queries` 的时效性优于常规关键词工具**，上升查询往往先于volume数据更新。
- ⌨️ 自动补全模式开启字母扩展，一次跑完长尾词。
- 📉 **兴趣值是相对值**：100 表示你所选时间范围内的峰值，不是搜索量。
- 🌍 对比不同 `geo`，决定先进入哪个市场。
- ⏰ 定时跑 `daily` 并追加到同一数据集，自建趋势档案。
- 🗓️ 时间范围要匹配问题：突发看 `now 1-d`，结构性趋势看 `today 5-y`。

### 其他 Google 数据

- 🗺️ **[Google 地图抓取工具](https://apify.com/myagizm/google-maps-scraper)** —— 抓取本地商家的电话、网站、评分与坐标。
- ⭐ **[Google 地图评论抓取工具](https://apify.com/myagizm/google-maps-reviews-scraper)** —— 抓取商家及其评论内容、评分与作者。
- 📰 **[Google 新闻抓取工具](https://apify.com/myagizm/google-news-scraper)** —— 按关键词或国家抓取新闻标题、来源与链接。
- 📱 **[Google Play 抓取工具](https://apify.com/myagizm/google-play-scraper)** —— 抓取应用信息与用户评论。

需要多平台数据？以下工具采用同样的免登录、按结果计费方式：

- 🎵 **[TikTok 账号抓取](https://apify.com/myagizm/tiktok-profile-scraper-v2)** · **[TikTok 视频抓取](https://apify.com/myagizm/tiktok-video-scraper-v2)** · **[TikTok 话题抓取](https://apify.com/myagizm/tiktok-hashtag-scraper-v2)** · **[TikTok 评论抓取](https://apify.com/myagizm/tiktok-comments-scraper-v2)**
- 🐦 **[X（推特）推文抓取](https://apify.com/myagizm/x-tweets-scraper)** · **[X 账号资料抓取](https://apify.com/myagizm/x-profile-scraper)** · **[X 热门趋势抓取](https://apify.com/myagizm/x-trends-scraper)**
- 👔 **[LinkedIn 个人资料抓取](https://apify.com/myagizm/linkedin-profile-scraper)** · **[LinkedIn 公司抓取](https://apify.com/myagizm/linkedin-company-scraper)** · **[LinkedIn 职位抓取](https://apify.com/myagizm/linkedin-jobs-scraper)**
- 🤖 **[Reddit 抓取](https://apify.com/myagizm/reddit-scraper-v2)** · **[Reddit 搜索抓取](https://apify.com/myagizm/reddit-search-scraper-v2)** · **[子版块抓取](https://apify.com/myagizm/reddit-subreddit-scraper-v2)**
- ▶️ **[YouTube 频道抓取](https://apify.com/myagizm/youtube-channel-scraper)** · **[YouTube 评论抓取](https://apify.com/myagizm/youtube-comment-scraper)** · **[YouTube 字幕抓取](https://apify.com/myagizm/youtube-transcript-scraper)**
- 🗺️ **[Google 地图抓取](https://apify.com/myagizm/google-maps-scraper)** · **[Google 新闻抓取](https://apify.com/myagizm/google-news-scraper)**

全部工具见 **[myagizm 商店主页](https://apify.com/myagizm)**。

### 配合 AI 智能体使用（MCP）

本 Actor 已接入 **Apify MCP 服务器**，Claude、ChatGPT、Cursor 等助手可以把它当作工具直接调用，用自然语言提问即可拿到结构化结果，无需写胶水代码。

### 集成与 API

支持 **Make、Zapier、n8n、Slack、Airbyte、Gumloop、CrewAI、IFTTT、Lindy、GitHub、Google Sheets、Google Drive**，以及 Webhook、定时任务与 MCP 服务器。

```bash
curl -X POST "https://api.apify.com/v2/acts/myagizm~google-trends-scraper/run-sync-get-dataset-items?token=YOUR_APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"mode": "daily", "geo": "US", "keywords": ["web scraping"], "timeframe": "today 12-m", "language": "en-US", "maxItems": 100}'
```

把 `format` 改成 `json`、`csv`、`xlsx` 或 `xml` 即可导出不同格式。

### 常见问题

**需要 Google Trends API Key 吗？**
Google 本身没有可购买的官方 Trends API。本工具读取公开页面，无需 Key、项目或结算。

**为什么兴趣值是 0–100 而不是搜索量？**
这是 Trends 的机制：数值按所选时间范围内的峰值归一化，适合看形状与对比，不代表绝对量。

**该用哪个模式？**
当下热点用 `daily`，关键词走势用 `interest_over_time`，发现新词用 `related_queries`，地域分布用 `interest_by_region`，长尾词用 `autocomplete`。

**能拿到历史趋势吗？**
平台本身历史有限，定时运行并追加数据即可自建档案。

**需要 Google API Key、Cloud 项目或结算账号吗？**
不需要。本工具不使用官方 API，因此没有 Cloud 项目、没有 API Key、没有配额，也没有 Google 按次计费。

**需要代理吗？**
不需要，已内置托管。

**支持导出 CSV / Excel / JSON 吗？**
支持 JSON、CSV、Excel、XML。

**可以通过 Apify API 调用吗？**
可以。

**支持 AI 智能体（MCP）吗？**
支持，Claude、ChatGPT、Cursor 均可当作工具调用。

**可以定时运行吗？**
可以，支持 Apify Schedules、API 与 Webhook。

**数据有多新？**
不缓存，每次运行都读取当前公开页面。

### 免责声明

本工具为独立第三方工具，与 Google LLC 无任何隶属、认可或赞助关系，所有商标归各自所有者。

本 Actor 只采集**公开可见**的数据 —— 即任何未登录访客都能看到的内容。它不登录、不绕过访问控制、不获取私密内容。数据使用的合规责任由使用者承担：如涉及个人数据，请遵守 GDPR、CCPA 等法规与平台条款。

### 相关搜索

google trends 抓取 · google trends api 替代 · 每日热搜抓取 · 关键词趋势数据 · 相关查询抓取 · 上升查询 · google 自动补全抓取 · 关键词研究数据 · 季节性需求分析 · 地区兴趣分布 · 趋势档案 · trends 导出 csv

# Actor input Schema

## `mode` (type: `string`):

daily = today's trending searches (no keyword needed). interest\_over\_time = relative search interest per week/day. related\_queries = top and rising queries around your keyword. interest\_by\_region = where the keyword is searched most. autocomplete = real long-tail search suggestions people type.

## `geo` (type: `string`):

Any Google Trends location code. Country: "US", "GB", "DE", "TR", "IN", "BR", "JP". Sub-region: "US-CA", "GB-ENG". Metro: "US-CA-807". Leave "US" for the United States.

## `keywords` (type: `array`):

Up to 5 search terms. Required for every mode except "Daily trending searches". With several keywords in "Interest over time" the values are directly comparable on one scale.

## `timeframe` (type: `string`):

Used by interest over time, related queries and interest by region. Presets: 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 an explicit range: "2025-01-01 2025-12-31".

## `language` (type: `string`):

Interface language for labels and the language used for autocomplete suggestions, e.g. "en-US", "de", "tr", "pt-BR".

## `category` (type: `integer`):

Google Trends category to narrow results. 0 = all categories, 5 = Computers & Electronics, 12 = Business & Industrial, 45 = News, 71 = Food & Drink.

## `searchProperty` (type: `string`):

Which Google surface to measure. Empty = web search.

## `alphabetExpand` (type: `boolean`):

Autocomplete mode only. Also queries "<keyword> a" through "<keyword> z" to uncover far more long-tail suggestions. Slower but much richer.

## `maxItems` (type: `integer`):

Upper bound on rows written to the dataset.

## Actor input object example

```json
{
  "mode": "daily",
  "geo": "US",
  "keywords": [
    "web scraping"
  ],
  "timeframe": "today 12-m",
  "language": "en-US",
  "category": 0,
  "searchProperty": "",
  "alphabetExpand": true,
  "maxItems": 100
}
```

# Actor output Schema

## `results` (type: `string`):

All scraped trending searches as structured JSON.

# 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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "mode": "daily",
    "geo": "US",
    "keywords": [
        "web scraping"
    ],
    "timeframe": "today 12-m",
    "language": "en-US",
    "category": 0,
    "searchProperty": "",
    "maxItems": 100
};

// Run the Actor and wait for it to finish
const run = await client.actor("myagizm/google-trends-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "mode": "daily",
    "geo": "US",
    "keywords": ["web scraping"],
    "timeframe": "today 12-m",
    "language": "en-US",
    "category": 0,
    "searchProperty": "",
    "maxItems": 100,
}

# Run the Actor and wait for it to finish
run = client.actor("myagizm/google-trends-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "mode": "daily",
  "geo": "US",
  "keywords": [
    "web scraping"
  ],
  "timeframe": "today 12-m",
  "language": "en-US",
  "category": 0,
  "searchProperty": "",
  "maxItems": 100
}' |
apify call myagizm/google-trends-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=myagizm/google-trends-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/acts/X4rG86irAs3VA39tO/builds/vSShsVxarbZYbl3PP/openapi.json
