# Google Trends Scraper (`xtracto/google-trends-scraper`) Actor Get current trending searches for any country, or interest-over-time plus top & rising related queries and geographic breakdown for any keyword. No account, no API key. - **URL**: https://apify.com/xtracto/google-trends-scraper.md - **Developed by:** [Farhan Febrian Nauval](https://apify.com/xtracto) (community) - **Categories:** Lead generation, News, Social media - **Stats:** 3 total users, 2 monthly users, 93.8% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $0.99 / 1,000 results This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage. 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 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/docs.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.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/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 ## Google Trends Scraper Pull **live Google Trends data** without an account, an API key, or a browser. Two modes in one actor: - **Trending searches** — the current trending topics for any country, each with its approximate search volume and the news stories driving it. - **Interest over time** — how search interest for any keyword has moved over your chosen time range, plus the top and rising related searches and a state-by-state (or country-by-country) breakdown. ### Why use this actor - **No account, no API key, no login** — just press Run. - **Two data products in one** — country trending feed *and* keyword interest analysis. - **Real "what's trending now"** — the top topics people are searching for right now, with related news articles attached. - **Keyword deep-dive** — interest curve over time, the searches people pair with your keyword (top and fast-rising "breakout" terms), and where in the country interest is strongest. - **Any country, any language** — set a country code and language and go. - **Clean, stable JSON** ready for spreadsheets, dashboards, databases, or alerting pipelines. Export to JSON, CSV, or Excel, and run it on a schedule. ### How it works 1. Pick a **mode**: `trending` (a country's current trending searches) or `interest` (a deep-dive on keyword(s) you supply). 2. Set the **country** (and, for interest mode, your **keywords**, **time range**, and optional **category**), or just use the prefilled examples. 3. Press **Run**. Results stream into the dataset as they are collected and can be exported to JSON, CSV, or Excel. You don't manage any scrapers, servers, or blocks — the actor handles the session setup, retries, and pacing for you. ### Modes | Mode | What it returns | Key input | | --- | --- | --- | | `trending` *(default)* | Current trending searches for a country: topic, approximate search volume, publish time, and related news items. | `geo` | | `interest` | Per keyword: interest-over-time series, top & rising related queries, and a geographic breakdown. | `keywords` | ### Input **Trending mode (default):** ```json { "mode": "trending", "geo": "US" } ```` **Interest mode:** ```json { "mode": "interest", "keywords": ["bitcoin"], "geo": "US", "timeRange": "today 12-m", "category": 0, "hl": "en-US" } ``` | Field | Type | Description | | --- | --- | --- | | `mode` | string | `trending` (default) or `interest`. | | `geo` | string | Two-letter country code, e.g. `US`, `GB`, `DE`, `ID`, `JP`. In interest mode, leave blank for worldwide. | | `keywords` | array of strings | Interest mode: one or more search terms to analyze. One record per keyword. | | `timeRange` | string | Interest mode: `now 1-H`, `now 4-H`, `now 1-d`, `now 7-d`, `today 1-m`, `today 3-m`, `today 12-m` (default), `today 5-y`, or `all`. | | `category` | integer | Interest mode: restrict to a topic category (e.g. `3` = Business and Finance). `0` = all categories. | | `hl` | string | Language for labels, e.g. `en-US`, `de`, `ja`, `id`. | | `maxConcurrency` | integer | Keywords fetched in parallel in interest mode. Default `2` (kept low to respect rate limits). | | `proxyConfiguration` | object | Recommended. A residential proxy matched to your country improves reliability at scale. | ### Output Every record carries a small envelope (`_input`, `_source`, `_scrapedAt`, `recordType`) followed by the data fields. #### `TRENDING_TOPIC` record — mode `trending`, `geo: "US"` ```json { "_input": "trending:US", "_source": "S1-trending-rss", "_scrapedAt": "2026-07-10T12:09:45Z", "recordType": "TRENDING_TOPIC", "geo": "US", "rank": 1, "title": "waymo vehicle passenger privacy", "approxTraffic": "200+", "pubDate": "Fri, 10 Jul 2026 04:50:00 -0700", "picture": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcROBHszTQWYKZq00aEQWcYalNoHWxdUtPYXjns1A0fSvHrEonQAD3ErWzolIG0", "pictureSource": "NPR", "newsItems": [ { "title": "Waymo called the cops on teen riders, raising privacy concerns", "url": "https://www.npr.org/2026/07/10/nx-s1-5886113/waymo-police-privacy-driverless-autonomous-vehicles", "source": "NPR", "picture": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcROBHszTQWYKZq00aEQWcYalNoHWxdUtPYXjns1A0fSvHrEonQAD3ErWzolIG0" }, { "title": "Waymo turns in teens who were drinking, shooting Orbeez from robotaxi in San Mateo", "url": "https://www.nbcbayarea.com/news/local/waymo-teens-drinking-shooting-objects-san-mateo/4110140/", "source": "NBC Bay Area", "picture": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcT31LAmr0hr8O7lmLP8v5oy26Ik5Ce1SSSdQFcxl2HtnMDW4QfYVHXKEEEt5cU" } // ... 1 more ] } ``` | Field | Type | Description | | --- | --- | --- | | `rank` | integer | Position in the trending feed (1 = most prominent). | | `title` | string | The trending search topic. | | `approxTraffic` | string | Approximate search volume, e.g. `"200+"`, `"2000+"`. | | `pubDate` | string | When the topic started trending. | | `picture` / `pictureSource` | string | A representative image and its source. | | `newsItems` | array | Related news articles: `title`, `url`, `source`, `picture`. | #### `INTEREST_OVER_TIME` record — mode `interest`, keyword `bitcoin`, `geo: "US"`, `timeRange: "today 12-m"` ```json { "_input": "interest:bitcoin", "_source": "S1-explore", "_scrapedAt": "2026-07-10T12:10:20Z", "recordType": "INTEREST_OVER_TIME", "keyword": "bitcoin", "geo": "US", "timeRange": "today 12-m", "category": 0, "categoryName": "All categories", "interestOverTime": [ { "time": "1751760000", "formattedTime": "Jul 6 – 12, 2025", "value": 39 }, { "time": "1752364800", "formattedTime": "Jul 13 – 19, 2025", "value": 54 }, { "time": "1752969600", "formattedTime": "Jul 20 – 26, 2025", "value": 44 } // ... 50 more weekly points ], "topRelatedQueries": [ { "query": "bitcoin price", "value": 100, "formattedValue": "100", "link": "/trends/explore?q=bitcoin+price&date=today+12-m&geo=US" }, { "query": "bitcoin today", "value": 18, "formattedValue": "18", "link": "/trends/explore?q=bitcoin+today&date=today+12-m&geo=US" }, { "query": "bitcoin stock", "value": 18, "formattedValue": "18", "link": "/trends/explore?q=bitcoin+stock&date=today+12-m&geo=US" } // ... 22 more ], "risingRelatedQueries": [ { "query": "how to buy bitcoin safely", "value": 15600, "formattedValue": "Breakout", "link": "/trends/explore?q=how+to+buy+bitcoin+safely&date=today+12-m&geo=US" }, { "query": "strc stock", "value": 4100, "formattedValue": "+4,100%", "link": "/trends/explore?q=strc+stock&date=today+12-m&geo=US" } // ... 23 more ], "geoBreakdown": [ { "geoName": "Wyoming", "geoCode": "US-WY", "value": 100 }, { "geoName": "Nevada", "geoCode": "US-NV", "value": 45 }, { "geoName": "California", "geoCode": "US-CA", "value": 45 } // ... 48 more regions ] } ``` | Field | Type | Description | | --- | --- | --- | | `keyword` | string | The analyzed search term. | | `geo` / `timeRange` / `category` / `categoryName` | — | The query settings used. | | `interestOverTime` | array | The interest curve: `time` (epoch seconds), `formattedTime`, and `value`. | | `topRelatedQueries` | array | The searches most associated with your keyword. `value` is relative (0–100). | | `risingRelatedQueries` | array | Fastest-growing related searches. `formattedValue` is a growth % or `"Breakout"` (5000%+). | | `geoBreakdown` | array | Where interest is strongest: `geoName`, `geoCode`, and relative `value`. | On any failure the actor emits a `{_input, _source, _scrapedAt, _error, _errorDetail}` record instead of silently skipping. ### Notes & limits - **Interest values are relative, not absolute.** In interest mode, `value` (and the geo/related-query values) are scaled `0–100`, where `100` is the peak within your chosen time range and region — they are not raw search counts. - **Trending is a live snapshot** of what's trending right now for the country; run it on a schedule to build history. - `approxTraffic` in trending mode is Google's own rounded estimate (e.g. `"200+"`), not an exact number. - A residential proxy matched to your `geo` is recommended for reliable, larger runs; small runs may work without one. # Actor input Schema ## `mode` (type: `string`): What to collect. 'trending' = the current trending searches for a country (with related news). 'interest' = interest-over-time plus top & rising related queries and a geographic breakdown for the keyword(s) you provide. ## `geo` (type: `string`): Two-letter country code, e.g. US, GB, DE, ID, JP. In 'interest' mode, leave blank for worldwide. ## `keywords` (type: `array`): Used in 'interest' mode. One or more search terms to analyze, e.g. \["bitcoin", "ethereum"]. Each keyword produces one record with its interest-over-time series, related queries, and geographic breakdown. ## `timeRange` (type: `string`): Used in 'interest' mode. How far back to measure interest. ## `category` (type: `string`): Used in 'interest' mode. Restrict interest to a topic category. 0 = all categories. ## `hl` (type: `string`): Language for results and related-query labels, e.g. en-US, de, fr, ja, id. ## `maxConcurrency` (type: `integer`): Number of keywords fetched in parallel in 'interest' mode. Kept low because Google rate-limits per IP. ## `proxyConfiguration` (type: `object`): Recommended for reliability and scale. A residential proxy matched to your country avoids per-IP rate limits. Small runs may work without one. ## Actor input object example ```json { "mode": "trending", "geo": "US", "keywords": [ "bitcoin" ], "timeRange": "today 12-m", "category": "0", "hl": "en-US", "maxConcurrency": 2, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } ``` # 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 = { "mode": "trending", "geo": "US", "keywords": [ "bitcoin" ], "timeRange": "today 12-m", "category": "0", "hl": "en-US" }; // Run the Actor and wait for it to finish const run = await client.actor("xtracto/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 = { "mode": "trending", "geo": "US", "keywords": ["bitcoin"], "timeRange": "today 12-m", "category": "0", "hl": "en-US", } # Run the Actor and wait for it to finish run = client.actor("xtracto/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": "trending", "geo": "US", "keywords": [ "bitcoin" ], "timeRange": "today 12-m", "category": "0", "hl": "en-US" }' | apify call xtracto/google-trends-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=xtracto/google-trends-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Google Trends Scraper", "description": "Get current trending searches for any country, or interest-over-time plus top & rising related queries and geographic breakdown for any keyword. No account, no API key.", "version": "0.1", "x-build-id": "YQe7RuSgf6VO0smGu" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/xtracto~google-trends-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-xtracto-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/xtracto~google-trends-scraper/runs": { "post": { "operationId": "runs-sync-xtracto-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/xtracto~google-trends-scraper/run-sync": { "post": { "operationId": "run-sync-xtracto-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", "required": [ "mode" ], "properties": { "mode": { "title": "Mode", "enum": [ "trending", "interest" ], "type": "string", "description": "What to collect. 'trending' = the current trending searches for a country (with related news). 'interest' = interest-over-time plus top & rising related queries and a geographic breakdown for the keyword(s) you provide.", "default": "trending" }, "geo": { "title": "Country", "type": "string", "description": "Two-letter country code, e.g. US, GB, DE, ID, JP. In 'interest' mode, leave blank for worldwide.", "default": "US" }, "keywords": { "title": "Keywords", "type": "array", "description": "Used in 'interest' mode. One or more search terms to analyze, e.g. [\"bitcoin\", \"ethereum\"]. Each keyword produces one record with its interest-over-time series, related queries, and geographic breakdown.", "items": { "type": "string" } }, "timeRange": { "title": "Time range", "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": "Used in 'interest' mode. How far back to measure interest.", "default": "today 12-m" }, "category": { "title": "Category", "enum": [ "0", "3", "4", "5", "6", "7", "8", "9", "10", "13", "14", "15", "16", "17", "18", "19", "20" ], "type": "string", "description": "Used in 'interest' mode. Restrict interest to a topic category. 0 = all categories.", "default": "0" }, "hl": { "title": "Language", "type": "string", "description": "Language for results and related-query labels, e.g. en-US, de, fr, ja, id.", "default": "en-US" }, "maxConcurrency": { "title": "Max concurrent requests", "minimum": 1, "maximum": 6, "type": "integer", "description": "Number of keywords fetched in parallel in 'interest' mode. Kept low because Google rate-limits per IP.", "default": 2 }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Recommended for reliability and scale. A residential proxy matched to your country avoids per-IP rate limits. Small runs may work without one.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } } }, "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 } } } } } } } } } } ```