# Google Trends Scraper (`curious_coder/google-trends-scraper`) Actor Scrape google keyword trends, related kewords, trending keywords, news etc with advanced filtering support and historical data - **URL**: https://apify.com/curious\_coder/google-trends-scraper.md - **Developed by:** [Curious Coder](https://apify.com/curious_coder) (community) - **Categories:** Automation, News - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $0.50 / 1,000 results 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/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. 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. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use 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 Scrape [Google Trends](https://trends.google.com) fast and cheap. It supports **two modes**: | Mode | What you get | |------|--------------| | **1. Keyword Trends** | For each keyword: interest over time, interest by region, and related queries/topics — with full filter support (location, time period, category, search property). | | **2. Trending Now** | The real-time *Trending Now* list for a country: trending searches with search volume, growth, start time, related queries and (optionally) related news articles. | --- ### Input Pick a `mode`, then fill in that mode's section. Common examples: #### Mode 1 — Keyword Trends ```json { "mode": "keyword_trends", "searchTerms": ["artificial intelligence", "bitcoin"], "geo": "US", "timeRange": "today 12-m", "category": 0, "property": "", "includeInterestOverTime": true, "includeInterestByRegion": true, "includeRelatedQueries": true, "includeRelatedTopics": true } ```` | Field | Description | |-------|-------------| | `searchTerms` | Array of keywords/topics. Each is scraped individually for its own full dataset. | | `geo` | Country code (`US`, `IN`, `GB`) or sub-region (`US-CA`). Empty = Worldwide. | | `timeRange` | `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`. | | `category` | Google Trends category id (`0` = all). E.g. `7` Finance, `16` News, `20` Sports, `174` Science. | | `property` | `""` Web, `images`, `news`, `youtube`, `froogle` (Shopping). | | `includeInterestOverTime` / `includeInterestByRegion` / `includeRelatedQueries` / `includeRelatedTopics` | Toggle which data sets to fetch. | #### Mode 2 — Trending Now ```json { "mode": "trending_now", "trendingGeo": "US", "trendingHours": "24", "trendingCategory": 0, "includeNews": true, "newsArticlesPerTrend": 3, "maxItems": 50 } ``` | Field | Description | |-------|-------------| | `trendingGeo` | Country code for the real-time list. | | `trendingHours` | `4`, `24`, `48`, `168` (7 days). | | `trendingCategory` | `0` = all, or a topical category id. | | `includeNews` | Resolve & attach related news articles per trend. | | `newsArticlesPerTrend` | How many articles to resolve per trend. | | `maxItems` | Cap the number of trends (`0` = no limit). | #### Advanced (both modes) | Field | Description | |-------|-------------| | `hl` | UI language, e.g. `en-US`. | | `tz` | Timezone offset in minutes for time bucketing (browser sign, e.g. `-330`). | | `proxyCountryCode` | Optional country (e.g. `US`) to target exit IPs in Keyword Trends mode. | *** ### Output #### Mode 1 — Keyword Trends (one item per keyword) ```jsonc { "keyword": "bitcoin", "geo": "US", "time": "today 12-m", "category": 0, "property": "web", "interestOverTime": { "averages": [], "timeline": [{ "time": 1750550400, "date": "Jun 22, 2025", "value": 59, "hasData": true }] }, "interestByRegion": [{ "geoCode": "US-WY", "geoName": "Wyoming", "value": 100 }], "relatedQueries": { "top": [{ "query": "bitcoin price", "value": 100, "link": "https://trends.google.com/..." }], "rising": [{ "query": "how to buy bitcoin", "value": 4500 }] }, "relatedTopics": { "top": [], "rising": [] }, "proxyType": "residential", "scrapedAt": "2026-06-25T..." } ``` #### Mode 2 — Trending Now (one item per trend) ```jsonc { "rank": 1, "title": "fifa world cup 2026 standings", "geo": "US", "searchVolume": 200000, "formattedVolume": "200K+", "growthPercent": 1000, "startedAt": "2026-06-24T13:00:00.000Z", "relatedQueries": ["fifa world cup standings", "world cup rankings 2026"], "news": [{ "title": "...", "url": "https://...", "source": "ESPN", "time": "2026-06-24T...", "image": "https://..." }] } ``` # Actor input Schema ## `mode` (type: `string`): Choose what to scrape. 'Keyword Trends' returns interest-over-time, interest-by-region and related queries/topics for your keywords. 'Trending Now' returns the live real-time trending searches for a country. ## `searchTerms` (type: `array`): Keywords/topics to get trends for. Each keyword is scraped individually so it gets its own full data set. (Used only in 'Keyword Trends' mode.) ## `geo` (type: `string`): Two-letter country code (e.g. US, IN, GB) or a sub-region code (e.g. US-CA). Leave empty for Worldwide. ## `timeRange` (type: `string`): Time range for interest data. ## `category` (type: `integer`): Google Trends category id. 0 = All categories. Common: 3 Arts & Entertainment, 5 Computers & Electronics, 7 Finance, 8 Games, 12 Business & Industrial, 16 News, 18 Shopping, 20 Sports, 45 Beauty & Fitness, 65 Health, 71 Travel, 174 Science, 958 Jobs & Education. ## `property` (type: `string`): Which Google surface to measure interest on. ## `includeInterestOverTime` (type: `boolean`): Fetch the time-series of search interest. ## `includeInterestByRegion` (type: `boolean`): Fetch the breakdown of interest by geographic region. ## `includeRelatedQueries` (type: `boolean`): Fetch top & rising related search queries. ## `includeRelatedTopics` (type: `boolean`): Fetch top & rising related topics. ## `trendingGeo` (type: `string`): Two-letter country code for the real-time trending list (e.g. US, IN, GB). (Used only in 'Trending Now' mode.) ## `trendingHours` (type: `string`): Trending window. ## `trendingCategory` (type: `integer`): Trending category filter. 0 = All categories. Other ids select a topical category (e.g. Sports, Entertainment, Business). ## `includeNews` (type: `boolean`): Resolve and attach related news articles for each trend (extra requests). ## `newsArticlesPerTrend` (type: `integer`): How many news articles to resolve per trend (when 'Include related news' is on). ## `maxItems` (type: `integer`): Limit the number of trending items returned (0 = no limit). ## `hl` (type: `string`): UI language code for labels, e.g. en-US, es, de. ## `tz` (type: `integer`): Timezone offset in minutes used for time bucketing (browser-style sign, e.g. -330 for IST). Default 0 (UTC). ## `proxyCountryCode` (type: `string`): Optional country code (e.g. US, GB). Leave empty for any country. ## Actor input object example ```json { "mode": "keyword_trends", "searchTerms": [ "artificial intelligence", "bitcoin" ], "geo": "US", "timeRange": "today 12-m", "category": 0, "property": "", "includeInterestOverTime": true, "includeInterestByRegion": true, "includeRelatedQueries": true, "includeRelatedTopics": true, "trendingGeo": "US", "trendingHours": "24", "trendingCategory": 0, "includeNews": true, "newsArticlesPerTrend": 3, "maxItems": 0, "hl": "en-US", "tz": 0, "proxyCountryCode": "" } ``` # 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 '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "searchTerms": [ "artificial intelligence", "bitcoin" ] }; // Run the Actor and wait for it to finish const run = await client.actor("curious_coder/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 '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "searchTerms": [ "artificial intelligence", "bitcoin", ] } # Run the Actor and wait for it to finish run = client.actor("curious_coder/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 '{ "searchTerms": [ "artificial intelligence", "bitcoin" ] }' | apify call curious_coder/google-trends-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=curious_coder/google-trends-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Google Trends Scraper", "description": "Scrape google keyword trends, related kewords, trending keywords, news etc with advanced filtering support and historical data", "version": "1.0", "x-build-id": "lgMbTUXK3UkbfKHRm" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/curious_coder~google-trends-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-curious_coder-google-trends-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/curious_coder~google-trends-scraper/runs": { "post": { "operationId": "runs-sync-curious_coder-google-trends-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/curious_coder~google-trends-scraper/run-sync": { "post": { "operationId": "run-sync-curious_coder-google-trends-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "mode": { "title": "Mode", "enum": [ "keyword_trends", "trending_now" ], "type": "string", "description": "Choose what to scrape. 'Keyword Trends' returns interest-over-time, interest-by-region and related queries/topics for your keywords. 'Trending Now' returns the live real-time trending searches for a country.", "default": "keyword_trends" }, "searchTerms": { "title": "1️⃣ Keyword Trends — Search terms", "type": "array", "description": "Keywords/topics to get trends for. Each keyword is scraped individually so it gets its own full data set. (Used only in 'Keyword Trends' mode.)", "items": { "type": "string" } }, "geo": { "title": "Location (geo)", "type": "string", "description": "Two-letter country code (e.g. US, IN, GB) or a sub-region code (e.g. US-CA). Leave empty for Worldwide.", "default": "" }, "timeRange": { "title": "Time period", "enum": [ "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" ], "type": "string", "description": "Time range for interest data.", "default": "today 12-m" }, "category": { "title": "Category", "type": "integer", "description": "Google Trends category id. 0 = All categories. Common: 3 Arts & Entertainment, 5 Computers & Electronics, 7 Finance, 8 Games, 12 Business & Industrial, 16 News, 18 Shopping, 20 Sports, 45 Beauty & Fitness, 65 Health, 71 Travel, 174 Science, 958 Jobs & Education.", "default": 0 }, "property": { "title": "Search property", "enum": [ "", "images", "news", "youtube", "froogle" ], "type": "string", "description": "Which Google surface to measure interest on.", "default": "" }, "includeInterestOverTime": { "title": "Include interest over time", "type": "boolean", "description": "Fetch the time-series of search interest.", "default": true }, "includeInterestByRegion": { "title": "Include interest by region", "type": "boolean", "description": "Fetch the breakdown of interest by geographic region.", "default": true }, "includeRelatedQueries": { "title": "Include related queries", "type": "boolean", "description": "Fetch top & rising related search queries.", "default": true }, "includeRelatedTopics": { "title": "Include related topics", "type": "boolean", "description": "Fetch top & rising related topics.", "default": true }, "trendingGeo": { "title": "2️⃣ Trending Now — Location", "type": "string", "description": "Two-letter country code for the real-time trending list (e.g. US, IN, GB). (Used only in 'Trending Now' mode.)", "default": "US" }, "trendingHours": { "title": "Time period", "enum": [ "4", "24", "48", "168" ], "type": "string", "description": "Trending window.", "default": "24" }, "trendingCategory": { "title": "Category", "type": "integer", "description": "Trending category filter. 0 = All categories. Other ids select a topical category (e.g. Sports, Entertainment, Business).", "default": 0 }, "includeNews": { "title": "Include related news articles", "type": "boolean", "description": "Resolve and attach related news articles for each trend (extra requests).", "default": true }, "newsArticlesPerTrend": { "title": "News articles per trend", "type": "integer", "description": "How many news articles to resolve per trend (when 'Include related news' is on).", "default": 3 }, "maxItems": { "title": "Max trends", "type": "integer", "description": "Limit the number of trending items returned (0 = no limit).", "default": 0 }, "hl": { "title": "Language (hl)", "type": "string", "description": "UI language code for labels, e.g. en-US, es, de.", "default": "en-US" }, "tz": { "title": "Timezone offset (minutes)", "type": "integer", "description": "Timezone offset in minutes used for time bucketing (browser-style sign, e.g. -330 for IST). Default 0 (UTC).", "default": 0 }, "proxyCountryCode": { "title": "Proxy country", "type": "string", "description": "Optional country code (e.g. US, GB). Leave empty for any country.", "default": "" } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```