Google Trends Scraper (Apify)

Extract Google Trends keyword history by country and period: interest over time, dates and availability. JSON or CSV.

Hosted MCP Server

npx add-mcp 'https://mcp.apify.com/?tools=monkey.d.scraping/google-trends-keyword-analysis'

Installs into Claude Code, Codex, Cursor and more

Documentation

Google Trends Scraper — Keyword History API (monkey.d.scraping/google-trends-keyword-analysis) Actor

Extract Google Trends keyword history by country and period. Export interest-over-time data, dates and availability flags to JSON, CSV or Excel for SEO research, seasonality and n8n workflows. Simple input; no Google login or Google API key.

Pricing

from $0.50 / 1,000 keyword histories

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

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

What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes. 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.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

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.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the API section below.

Each client library has reference documentation the quickstart does not restate: JavaScript/TypeScript (npm install apify-client) and Python (pip install apify-client).

README

Google Trends Scraper — Keyword History API

Extract Google Trends keyword history and interest over time by country and date range. Get the available timeline points for each search term, with dates, interest values, data availability and partial-period flags. Export JSON, CSV or Excel, or use the Apify API in n8n, Make, Zapier and scheduled research workflows.

This independent Actor is built for keyword history: SEO research, seasonal content planning, brand interest monitoring and market research. It uses a simple three-field input and requires no Google login or Google API key.

中文用户 / 中文用戶: 简体中文说明 · 繁體中文說明(谷歌趋势数据采集、Google Trends关键词热度、关键词历史趋势API)

Scope: one to five keywords per run, with interest over time for each keyword (Google's relative index, not absolute search volume). RUN_SUMMARY lists the status of every keyword.

Example cost: $0.0025 for one keyword with available data, or $0.0045 for five. Platform usage is included. Each keyword history counts once, regardless of the number of dates; the $0.002 startup charge also applies when no usable data is returned. See Pricing for the active rate.

Is this the right Google Trends scraper for your task?

Your goalSupported here
Export keyword history for SEO and seasonal planningYes: dated interest-over-time points in JSON, CSV or Excel
Track a brand's relative interest in a selected countryYes: each keyword is normalized independently

Ready-to-run Google Trends example

Open the example below and choose Try for free to create your own task in Apify Console. Keep coffee or replace it with your keyword, choose a country and period, and check the current Pricing tab before starting.

Public taskSaved settingsOutput and exportExample charge per run
Coffee search seasonalityOne keyword: coffee; Worldwide; past five yearsOne keyword record with dated interest-over-time points. Use Timeline to export date rows as CSV or Excel; RUN_SUMMARY shows each keyword's status.$0.0025 with available data; $0.002 startup only without usable data

Browse all ready-to-run examples → — English and 中文.

The saved example uses 128 MB and a $0.01 spending cap. The cap is a limit, not the example charge. The prices above include platform usage. Adding keywords changes the total; every timeline date stays inside its keyword's single result charge. Repeated runs take new snapshots and can include the same dates.

Quick start

  1. Enter Search terms, one keyword per line. Start with one term such as coffee.
  2. Select Country, or keep Worldwide.
  3. Select Time period, then start the Actor.
{
  "keywords": ["coffee"],
  "geo": "IT",
  "timeRange": "today 3-m"
}

Country options: Worldwide (""), Italy (IT), United States (US), United Kingdom (GB), Germany (DE), France (FR) and Spain (ES). Periods: past month (today 1-m), three months (today 3-m), twelve months (today 12-m) and five years (today 5-y).

Each keyword is measured separately, on its own 0–100 scale rather than the shared scale of a multi-term Google Trends chart.

Pricing: a whole keyword history counts once

The launch price is $0.002 per run start + $0.0005 per keyword with available data, with platform usage included. Check the Actor's Pricing tab for the active rate before starting a run.

Run resultCharge
One keyword with data$0.0025
Five keywords with data$0.0045
No usable keyword data$0.002 startup charge only

A five-year series containing hundreds of dates is one keyword result, not hundreds of billable results. Empty/no-data series and failed keywords do not incur the keyword charge. The startup charge still applies when Google returns no usable results. No charge is added for CSV exports or the Timeline view.

Set a maximum run cost in Apify to control spending. The Actor checks the remaining budget before collecting each keyword and stops when it cannot cover the next usable series.

Output and exports

The default dataset contains one record for each completed keyword:

FieldMeaning
keywordSearch term supplied in the input
geoCountry code, or an empty string for Worldwide
timeRangeRequested Google Trends date range
statusok when points have available data; otherwise no_data
pointCountNumber of timeline points
fetchedAtCollection time in UTC
trendsUrlLink to the corresponding Google Trends Explore page
timelineDates, timestamps, interest values, hasData and isPartial flags

Choose Keyword overview to review keyword availability. Choose Timeline to export individual dates as CSV or Excel rows. Both views use the same saved records; expanding timeline points does not add keyword charges.

Real keyword-history excerpt

Owner verification observed on 19 October 2026: caffè, Italy, past twelve months. The full record contained 53 points; only the first two are shown below. pointCount is the full record's count.

{
  "keyword": "caffè",
  "geo": "IT",
  "timeRange": "today 12-m",
  "status": "ok",
  "pointCount": 53,
  "fetchedAt": "2026-10-19T12:22:30.598348+00:00",
  "trendsUrl": "https://trends.google.com/trends/explore?q=caff%C3%A8&geo=IT&date=today+12-m",
  "timeline": [
    {
      "date": "2025-10-19T00:00:00+00:00",
      "timestamp": 1760832000,
      "interest": 77,
      "hasData": true,
      "isPartial": false
    },
    {
      "date": "2025-10-26T00:00:00+00:00",
      "timestamp": 1761436800,
      "interest": 82,
      "hasData": true,
      "isPartial": false
    }
  ]
}

These are dated observations. Interest is Google's relative 0–100 index within each keyword's series. hasData and isPartial are the source flags for each point. Series length and resolution follow Google Trends and the selected period.

Practical use cases

  • SEO and content calendars: identify seasonal interest in products, destinations or topics.
  • Brand research: follow changes in relative interest for a brand within the same country and period.
  • Market research: retrieve country-specific keyword histories for reports and spreadsheets.
  • n8n, Make and Zapier: schedule collection and pass dataset exports into automated reporting.
  • AI agents and retrieval workflows: use structured historical interest data through the Apify API or MCP; retain the country, period and collection timestamp when citing a result.

Google Trends scraper FAQ

What do the interest values mean?

Google Trends reports relative search interest on a 0–100 scale rather than the number of searches. A value of 100 marks the peak within that keyword's requested country and time range. Google's sampling can shift values between runs. Google explains Trends data.

Which Google Trends data does it return?

Interest-over-time timelines for each keyword, country and period, with dates, interest values and source flags.

How do I check each keyword's status?

RUN_SUMMARY lists every requested keyword with its status. The dataset contains the keywords with saved series; no data is ever invented.

Do I pay for failed keywords or dates inside a timeline?

The keyword event is charged only for a saved series with available data. Failed and no-data keywords do not incur that event. Every run has the startup charge, including runs without usable data. Individual timeline dates are not charged separately.

Can I collect more than five keywords?

Split the list into batches of up to five keywords and run them one after another.

Can I use it as a Google Trends API alternative?

Yes, for the historical keyword timelines supported here. Run it through the Apify API and retrieve the default dataset. You need Apify API authentication for programmatic calls; no Google account credentials are required in the input.

Chinese Simplified

中文说明:谷歌趋势关键词历史采集工具(Google Trends 爬虫 / API)

Google Trends Scraper 按国家和时间范围,批量导出 Google Trends(谷歌趋势) 的关键词历史热度(interest over time):每个关键词的全部时间点、日期、0–100相对热度值,以及数据可用性和不完整周期标记。可导出为JSON、CSV或Excel,也可通过Apify API接入n8n、Make、Zapier和定时研究流程。只需填写三个字段,无需Google账号登录,也无需Google API密钥。本工具与Google官方无关联。

专为跨境电商卖家、出海品牌、SEO和内容团队以及市场研究人员打造:在进入欧美市场前,先看清关键词的季节性和热度走势。

为什么选择这款谷歌趋势采集工具?

  • 整条历史只计费一次:一个关键词的五年历史即使包含数百个日期,也只算一条结果。每个有数据的关键词0.0005美元,每次运行启动费0.002美元,平台用量已包含。
  • 只为有数据的关键词付费:无数据或失败的关键词不收取关键词费用。
  • 输入简单:只需填写关键词、国家和时间范围三个字段。
  • 无需Google账号或API密钥:开箱即用,可作为Google Trends API的替代方案获取关键词历史数据。
  • 导出方便:Keyword overview 视图查看每个关键词的概况,Timeline 视图按日期逐行导出CSV或Excel,不额外收费。
  • 适合自动化和AI智能体:可通过Apify API或MCP调用,用于n8n、Make、Zapier工作流和AI检索流程。

适用场景

  • 跨境电商选品与季节性分析:查看产品关键词在美国、英国、德国、法国、西班牙或意大利的历史热度,找出需求旺季,提前备货和安排投放。
  • SEO与内容日历:识别产品、目的地或话题的季节性关键词热度,规划内容发布时间。
  • 品牌热度跟踪:在同一国家和时间范围内,跟踪品牌关键词的相对热度变化。
  • 市场研究报告:按国家获取关键词历史趋势,直接导入报告和表格。
  • 自动化与AI工作流:在n8n、Make、Zapier中定时采集,或作为AI智能体的结构化历史热度数据源;引用结果时保留国家、时间范围和采集时间。

可以获取哪些数据?

每个完成的关键词对应一条记录:

  • keyword:输入的关键词
  • geo:国家代码(全球为空字符串)
  • timeRange:所选时间范围
  • status:有可用数据时为 ok,否则为 no_data
  • pointCount:时间点数量
  • fetchedAt:采集时间(UTC)
  • trendsUrl:对应的Google Trends Explore页面链接
  • timeline:每个时间点的日期、时间戳、热度值(interest)以及 hasData 和 isPartial 标记

热度值是Google Trends在该关键词、国家和时间范围内的0–100相对指数,每个关键词单独计算。

价格

按结果付费,平台用量已包含:每次运行0.002美元 + 每个有数据的关键词0.0005美元。开始运行前请在Pricing标签页确认当前价格。

运行结果费用
1个关键词有数据0.0025美元
5个关键词有数据0.0045美元
没有可用的关键词数据仅启动费0.002美元

时间线中的每个日期不单独计费,导出CSV和使用Timeline视图也不额外收费。可在Apify中设置每次运行的最高费用,工具会在采集每个关键词前检查剩余预算。

使用方法

  1. 在 Search terms 中输入1到5个关键词,每行一个,建议先从一个关键词开始,例如 coffee。
  2. 选择 Country:Worldwide("")、意大利(IT)、美国(US)、英国(GB)、德国(DE)、法国(FR)或西班牙(ES)。
  3. 选择 Time period:过去1个月(today 1-m)、3个月(today 3-m)、12个月(today 12-m)或5年(today 5-y),然后点击 Start。
{
  "keywords": ["coffee"],
  "geo": "US",
  "timeRange": "today 5-y"
}

中文示例任务: 谷歌趋势跨境选品:美国季节性关键词热度

常见问题

需要Google账号或Google API密钥吗? 不需要。输入中不需要任何Google账号凭据;通过API调用时只需Apify API认证。

可以当作Google Trends API使用吗? 可以,用于获取本工具支持的关键词历史热度时间线。通过Apify API运行并读取默认数据集即可。

热度值代表什么? Google Trends的0–100相对搜索热度,100表示该关键词在所选国家和时间范围内的峰值。

五年历史有数百个日期,会按日期收费吗? 不会。一个关键词的完整历史只算一条结果,每个有数据的关键词0.0005美元。

如何在Excel中按日期查看数据? 选择 Timeline 视图,导出为CSV或Excel,每个日期一行。

如何查看每个关键词的状态? 查看 RUN_SUMMARY,其中列出每个关键词的状态。

中文说明会翻译采集到的数据吗? 不会。中文说明只是使用文档;采集到的数据保持来源的原始语言(关键词按输入原样保留,热度值为Google Trends的原始数值)。

其他相关工具

Chinese Traditional

中文說明(繁體):Google搜尋趨勢關鍵字歷史擷取工具(Google Trends 爬蟲 / API)

Google Trends Scraper 依國家與時間範圍,批次匯出 Google Trends(Google搜尋趨勢) 的關鍵字歷史熱度(interest over time):每個關鍵字的全部時間點、日期、0–100相對熱度值與資料標記。可匯出JSON、CSV或Excel。只需三個欄位,不需要Google帳號登入或Google API金鑰。本工具與Google官方無關。

為什麼選擇這款Google Trends爬蟲?

  • 整段歷史只計費一次:一個關鍵字的五年歷史即使有數百個日期,也只算一筆結果。
  • 只為有資料的關鍵字付費:沒有資料或失敗的關鍵字不收關鍵字費用。
  • 匯出方便:Timeline 檢視依日期逐列匯出CSV或Excel,不另收費。

適用場景

  • 電商選品與季節性分析:查看商品關鍵字在各國的歷史熱度,找出需求旺季。
  • SEO與內容規劃:找出季節性關鍵字,安排內容發布時間。
  • 品牌熱度追蹤:在同一國家與時間範圍內追蹤品牌關鍵字的相對熱度。
  • 市場研究報告:依國家取得關鍵字歷史趨勢,直接匯入報告與試算表。

使用方法

  1. 在 Search terms 輸入1到5個關鍵字,每行一個,例如 coffee。
  2. 選擇 Country(Worldwide、IT、US、GB、DE、FR 或 ES)。
  3. 選擇 Time period(過去1個月、3個月、12個月或5年),點擊 Start。
{
  "keywords": ["coffee"],
  "geo": "US",
  "timeRange": "today 5-y"
}

中文範例任務: 谷歌趋势跨境选品:美国季节性关键词热度

價格

每次執行0.002美元,每個有資料的關鍵字另加0.0005美元,平台用量已包含。例如5個關鍵字都有資料,合計0.0045美元。

常見問題

需要Google帳號或API金鑰嗎? 不需要,透過API呼叫時只需Apify API驗證。

熱度值代表什麼? Google Trends的0–100相對搜尋熱度,100代表該關鍵字在所選國家與時間範圍內的高峰。

五年歷史有數百個日期,會按日期計費嗎? 不會,一個關鍵字的完整歷史只算一筆結果。

中文說明會翻譯擷取到的資料嗎? 不會。說明是中文,資料保留來源的原始語言(關鍵字依輸入原樣保留,熱度值為Google Trends的原始數值)。

完整欄位與輸出範例請見英文說明或简体中文说明。

Other Actors from this publisher

ActorWhen to use it
Google News ScraperCollect recent headlines across 13 supported editions, with optional direct article URLs, descriptions and images
Telegram Keyword Search & Channel ScraperFind publicly indexed Telegram posts for a topic and retain source URLs

Support

Open an Actor issue with the run ID and a non-sensitive description of your question. Include the keyword, country and period when appropriate. Never post tokens, cookies or private account credentials.

This is an independent community Actor and is not affiliated with Google.

Actor input Schema

keywords (type: array):

Enter one to five search terms, one per line. Each term is analysed separately. Start with one term; smaller batches run more smoothly.

geo (type: string):

Choose the country whose search interest you want to analyse.

timeRange (type: string):

Choose how far back the analysis should go.

Actor input object example

{
  "keywords": [
    "coffee"
  ],
  "geo": "",
  "timeRange": "today 3-m"
}

Actor output Schema

overview (type: string):

One saved record per completed keyword, including country, requested period, ok/no_data status, point count, collection time and Google Trends source URL. Failed keywords are listed in the run summary.

timeline (type: string):

Date-level timeline perspective of the same keyword records, expanded using the timeline dataset view. Each point has a timestamp, relative interest from 0 to 100, data-availability and partial-period flags. Resolution is chosen by Google Trends; each keyword has its own 0 to 100 scale. Expanding dates adds no keyword charge.

summary (type: string):

RUN_SUMMARY records requested, completed, failed and skipped keywords and coverage/budget outcomes for each run.

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

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 = {
    "keywords": [
        "coffee"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("monkey.d.scraping/google-trends-keyword-analysis").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

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 = { "keywords": ["coffee"] }

# Run the Actor and wait for it to finish
run = client.actor("monkey.d.scraping/google-trends-keyword-analysis").call(run_input=run_input)

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

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

CLI example

echo '{
  "keywords": [
    "coffee"
  ]
}' |
apify call monkey.d.scraping/google-trends-keyword-analysis --silent --output-dataset

MCP server setup

{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,monkey.d.scraping/google-trends-keyword-analysis"
        }
    }
}

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an Authorization: Bearer <APIFY_API_TOKEN> header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/dmAGNi6SIjekDcmgi/builds/VwbTlr1FTHtoNOCFK/openapi.json