# Google Trends Scraper (`fetch_cat/google-trends-scraper`) Actor Track public Google Trends Trending Now searches by country. Export trend ranks, traffic labels, related queries, and articles. - **URL**: https://apify.com/fetch\_cat/google-trends-scraper.md - **Developed by:** [Hanna Nosova](https://apify.com/fetch_cat) (community) - **Categories:** SEO tools, Marketing, News - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $0.60 / 1,000 trend saveds 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 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 ## Google Trends Scraper Track what people are searching for on Google right now. Google Trends Scraper collects public Google Trends Trending Now rows for a selected country and saves clean, analysis-ready trend records to an Apify dataset. Use it to monitor news cycles, plan content, watch brand-adjacent topics, and spot fast-moving demand signals without manually refreshing Google Trends. ### What does Google Trends Scraper do? Google Trends Scraper extracts current Trending Now searches from public Google Trends country feeds. It returns each trend as a structured dataset row with the trend title, rank, country, search-volume label, normalized traffic number, related news context, article links, source URL, and scrape timestamp. The actor is designed for simple recurring monitoring jobs where you need fresh trend rows in a spreadsheet, BI tool, automation workflow, or API pipeline. ### Who is it for? - 📰 Newsrooms tracking breaking topics by country. - 🔎 SEO teams watching search demand before planning articles. - 📣 PR and reputation teams monitoring sudden story spikes. - 📈 Market researchers looking for early demand signals. - 🧑‍💼 Agencies preparing daily trend briefs for clients. - 🤖 Automation builders feeding trend data into alerts or dashboards. ### Why use this actor? Manual Google Trends checks are easy once, but hard to repeat at scale. This actor gives you repeatable inputs, consistent output fields, API access, scheduling, webhooks, dataset exports, and integration with the wider Apify platform. You can run it every hour, every morning, or on demand when a campaign or topic needs monitoring. ### Current MVP scope The first version focuses on `trending_now` data. It collects public country-level Google Trends Trending Now rows. Keyword interest over time is not exposed in the input yet because the first release prioritizes stable public trend collection. ### Data returned | Field | Description | | --- | --- | | `mode` | Collection mode, currently `trending_now`. | | `query` | Trend query text. | | `title` | Human-readable trend title. | | `rank` | 1-based order in the source feed. | | `geo` | Country code used for the run. | | `hl` | Locale stored for context. | | `observedAt` | Time supplied by Google Trends when available. | | `traffic` | Parsed numeric traffic estimate when possible. | | `searchVolumeLabel` | Original traffic label, such as `10K+`. | | `trendBreakdown` | Supporting trend/news text. | | `relatedQueries` | Related trend context extracted from the feed. | | `articles` | News articles with title, URL, source, and snippet when available. | | `sourceUrl` | Public Google Trends source URL. | | `scrapedAt` | Actor scrape timestamp. | ### Input settings | Setting | JSON key | Type / default | Description | | --- | --- | --- | --- | | Mode | `mode` | string, default `"trending_now"` | Trending Now collects the public daily trending searches from Google Trends. Keyword interest mode is planned for a later version. | | Country code | `geo` | string, default `"US"` | Two-letter Google Trends country code, such as US, GB, DE, CA, AU, IN, or JP. | | Additional country codes | `geos` | array, default `["US","GB","DE"]` | Optional list of country codes to collect in one run. Leave empty to use only Country code. | | Locale | `hl` | string, default `"en-US"` | Locale tag saved in output and used for reporting context. | | Maximum trends | `maxItems` | integer, default `20` | Maximum number of trending searches to save. Keep this low for quick tests. | | Proxy configuration | `proxyConfiguration` | object, default `{"useApifyProxy":false}` | Optional proxy settings. The public Google Trends RSS feed usually works without a proxy. | ### Output fields | JSON key | Label | Type | Description | | --- | --- | --- | --- | | `mode` | Mode | string | Output field for mode. | | `query` | Query | string | Output field for query. | | `title` | Title | string | Output field for title. | | `rank` | Rank | integer | Output field for rank. | | `geo` | Geo | string | Output field for geo. | | `hl` | Hl | string | Output field for hl. | | `observedAt` | ObservedAt | string / null | Output field for observedat. | | `traffic` | Traffic | integer / null | Output field for traffic. | | `searchVolumeLabel` | SearchVolumeLabel | string / null | Output field for searchvolumelabel. | | `trendBreakdown` | TrendBreakdown | array | Output field for trendbreakdown. | | `relatedQueries` | RelatedQueries | array | Output field for relatedqueries. | | `articles` | Articles | array | Output field for articles. | | `sourceUrl` | SourceUrl | string | Output field for sourceurl. | | `scrapedAt` | ScrapedAt | string | Output field for scrapedat. | ### Pricing This Actor uses Apify pay-per-event pricing. The prices below come from the current Actor pricing configuration. Apify public plans map to Store discount tiers, so the table shows both the user-facing plan context and the pricing tier name. The final price shown in Apify depends on the user account plan and any custom agreement. | Event | What is charged | Price | | --- | --- | ---: | | `start` | One-time fee per run | $0.005 | | Event | What is charged | Free / no discount | Starter / Bronze | Scale / Silver | Business / Gold | Custom / Platinum | Custom / Diamond | | --- | --- | ---: | ---: | ---: | ---: | ---: | ---: | | `item` | Per Google Trends row produced | $1.15 / 1,000 | $1 / 1,000 | $0.78 / 1,000 | $0.6 / 1,000 | $0.4 / 1,000 | $0.28 / 1,000 | Apify may also charge platform usage for compute, storage, proxies, or data transfer outside this Actor pricing. Check the Actor run and the Apify Pricing tab for the exact cost shown to your account. ### Input options #### Mode Choose `Trending Now`. The schema currently exposes only the stable `trending_now` mode. #### Country code Use a two-letter Google Trends country code such as `US`, `GB`, `DE`, `CA`, `AU`, `IN`, or `JP`. #### Additional country codes Add optional country codes when you want one run to collect several markets. For example, use `US`, `GB`, and `DE` to create a small international trend snapshot. #### Locale Use a locale label such as `en-US`. The locale is stored in the output for reporting context. #### Maximum trends Set the maximum number of trend rows to save. For fast tests, keep this around 10 to 25. For production monitoring, use the number of rows your workflow needs. #### Proxy configuration Proxy use is optional. The public feed usually works without a proxy, which keeps runs lightweight. If your environment needs proxy routing, configure it in the advanced section. ### Ready-to-run examples - [Google Trends Japan Trending Now](https://apify.com/fetch_cat/google-trends-scraper/examples/google-trends-japan-trending-now) - [Google Trends Daily News Brief](https://apify.com/fetch_cat/google-trends-scraper/examples/google-trends-daily-news-brief) - [Google Trends India Content Ideas](https://apify.com/fetch_cat/google-trends-scraper/examples/google-trends-india-content-ideas) - [Google Trends Us Gb De Snapshot](https://apify.com/fetch_cat/google-trends-scraper/examples/google-trends-us-gb-de-snapshot) - [Google Trends Us Trending Now](https://apify.com/fetch_cat/google-trends-scraper/examples/google-trends-us-trending-now) [View all ready-to-run examples](https://apify.com/fetch_cat/google-trends-scraper/examples) ### Example input ```json { "mode": "trending_now", "geo": "US", "geos": ["US", "GB", "DE"], "hl": "en-US", "maxItems": 20, "proxyConfiguration": { "useApifyProxy": false } } ```` ### Example output ```json { "mode": "trending_now", "query": "houston rockets", "title": "houston rockets", "rank": 1, "geo": "US", "hl": "en-US", "observedAt": "Thu, 2 Jul 2026 01:30:00 -0700", "traffic": 200, "searchVolumeLabel": "200+", "relatedQueries": ["Rockets, Marcus Smart reportedly agree to 2-year deal"], "articles": [ { "title": "Sources: Marcus Smart agrees to 2-year deal with Rockets", "url": "https://www.espn.com/", "source": "ESPN", "snippet": null } ], "sourceUrl": "https://trends.google.com/trending/rss?geo=US", "scrapedAt": "2026-07-02T08:53:48.654Z" } ``` ### API usage Run Google Trends Scraper from your own code with the Apify API. **Node.js** ```js import { ApifyClient } from 'apify-client'; const client = new ApifyClient({ token: process.env.APIFY_TOKEN }); const input = { "mode": "trending_now", "geo": "US", "geos": [ "US", "GB", "DE" ], "hl": "en-US", "maxItems": 20 }; const run = await client.actor('fetch_cat/google-trends-scraper').call(input); const { items } = await client.dataset(run.defaultDatasetId).listItems(); console.log(items); ``` **Python** ```python from apify_client import ApifyClient import os client = ApifyClient(os.environ["APIFY_TOKEN"]) run = client.actor("fetch_cat/google-trends-scraper").call(run_input={ "mode": "trending_now", "geo": "US", "geos": [ "US", "GB", "DE" ], "hl": "en-US", "maxItems": 20 }) items = client.dataset(run["defaultDatasetId"]).list_items().items print(items) ``` **cURL** ```bash curl -X POST "https://api.apify.com/v2/acts/fetch_cat~google-trends-scraper/runs?token=$APIFY_TOKEN" \ -H "Content-Type: application/json" \ -d '{"mode":"trending_now","geo":"US","geos":["US","GB","DE"],"hl":"en-US","maxItems":20}' ``` ### Tips for better trend monitoring - Run the actor on a schedule for comparable daily snapshots. - Store both `traffic` and `searchVolumeLabel` because labels may be approximate. - Use `rank` to compare feed position across repeated runs. - Keep `geo` explicit when combining datasets from multiple countries. - Use webhooks to trigger alerts when new rows arrive. ### Integrations Google Trends Scraper works with standard Apify integrations. You can send results to Google Sheets, Make, Zapier, Slack, Airtable, BigQuery, or your own API. Common workflows include daily editorial trend briefings, PR monitoring alerts, SEO topic discovery, and market research dashboards. ### Use with AI agents via MCP Google Trends Scraper can be used by AI assistants through the hosted Apify MCP server. **Claude Code setup** ```bash claude mcp add --transport http apify "https://mcp.apify.com?tools=fetch_cat/google-trends-scraper" ``` **Claude Desktop, Cursor, or VS Code JSON config** ```json { "mcpServers": { "apify": { "url": "https://mcp.apify.com?tools=fetch_cat/google-trends-scraper" } } } ``` **Example prompts** - "Run Google Trends Scraper with this input JSON and summarize the dataset." - "Export the latest Google Trends Scraper results to a table I can review." - "Schedule this Actor for monitoring and tell me what changed between runs." ### Scheduling Use Apify schedules for repeated monitoring. Hourly runs work for fast-moving news desks. Daily morning runs work for content calendars. Weekly runs work for broad market snapshots. ### Webhooks Add a webhook to notify your workflow when a run succeeds. For example, send the dataset URL to Slack or trigger a Make scenario that appends rows to a spreadsheet. ### FAQ and troubleshooting #### Why did I get fewer rows than requested? Google Trends may publish fewer current trend rows for some countries at a given moment. The actor saves what the public feed returns. #### Why is `traffic` lower than expected? The numeric `traffic` field is parsed from the public label. Always keep `searchVolumeLabel` for the original Google Trends text. #### Do I need a proxy? Usually no. If your environment receives temporary network errors, enable Apify Proxy in the advanced input section. ### Legality and responsible use This actor collects public Google Trends information. Use the data responsibly, respect applicable laws, and review Google terms and Apify platform policies for your use case. Do not use trend data to infer private information about individuals. ### Limits The actor is designed for public Trending Now rows. It does not log in to Google. It does not collect personalized account data. It does not currently provide keyword interest over time. ### Related actors - [Apple App Store Apps Scraper](https://apify.com/fetch_cat/apple-app-store-apps-scraper) - [Apple App Store Reviews Scraper](https://apify.com/fetch_cat/apple-app-store-reviews-scraper) - [Bing SERP & Search Results Scraper](https://apify.com/fetch_cat/bing-search-results-scraper) - [DuckDuckGo Search Results Scraper](https://apify.com/fetch_cat/duckduckgo-search-results-scraper) - [Google Ads Transparency Scraper](https://apify.com/fetch_cat/google-ads-transparency-scraper) ### Support Report bugs, wrong output, blocked runs, or missing fields from the Actor page. Include the Apify run ID or run URL, your input JSON, what you expected, what the Actor returned, and one reproducible public URL so the issue can be tested quickly. # Actor input Schema ## `mode` (type: `string`): Trending Now collects the public daily trending searches from Google Trends. Keyword interest mode is planned for a later version. ## `geo` (type: `string`): Two-letter Google Trends country code, such as US, GB, DE, CA, AU, IN, or JP. ## `geos` (type: `array`): Optional list of country codes to collect in one run. Leave empty to use only Country code. ## `hl` (type: `string`): Locale tag saved in output and used for reporting context. ## `maxItems` (type: `integer`): Maximum number of trending searches to save. Keep this low for quick tests. ## `proxyConfiguration` (type: `object`): Optional proxy settings. The public Google Trends RSS feed usually works without a proxy. ## Actor input object example ```json { "mode": "trending_now", "geo": "US", "geos": [ "US", "GB", "DE" ], "hl": "en-US", "maxItems": 20, "proxyConfiguration": { "useApifyProxy": false } } ``` # Actor output Schema ## `overview` (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 '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "mode": "trending_now", "geo": "US", "geos": [ "US", "GB", "DE" ], "hl": "en-US", "maxItems": 20, "proxyConfiguration": { "useApifyProxy": false } }; // Run the Actor and wait for it to finish const run = await client.actor("fetch_cat/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_now", "geo": "US", "geos": [ "US", "GB", "DE", ], "hl": "en-US", "maxItems": 20, "proxyConfiguration": { "useApifyProxy": False }, } # Run the Actor and wait for it to finish run = client.actor("fetch_cat/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_now", "geo": "US", "geos": [ "US", "GB", "DE" ], "hl": "en-US", "maxItems": 20, "proxyConfiguration": { "useApifyProxy": false } }' | apify call fetch_cat/google-trends-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=fetch_cat/google-trends-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Google Trends Scraper", "description": "Track public Google Trends Trending Now searches by country. Export trend ranks, traffic labels, related queries, and articles.", "version": "0.1", "x-build-id": "FhSQLjJiZ8WIE9TI1" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/fetch_cat~google-trends-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-fetch_cat-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/fetch_cat~google-trends-scraper/runs": { "post": { "operationId": "runs-sync-fetch_cat-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/fetch_cat~google-trends-scraper/run-sync": { "post": { "operationId": "run-sync-fetch_cat-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": [ "geo" ], "properties": { "mode": { "title": "Mode", "enum": [ "trending_now" ], "type": "string", "description": "Trending Now collects the public daily trending searches from Google Trends. Keyword interest mode is planned for a later version.", "default": "trending_now" }, "geo": { "title": "Country code", "minLength": 2, "maxLength": 2, "type": "string", "description": "Two-letter Google Trends country code, such as US, GB, DE, CA, AU, IN, or JP.", "default": "US" }, "geos": { "title": "Additional country codes", "type": "array", "description": "Optional list of country codes to collect in one run. Leave empty to use only Country code.", "items": { "type": "string" } }, "hl": { "title": "Locale", "type": "string", "description": "Locale tag saved in output and used for reporting context.", "default": "en-US" }, "maxItems": { "title": "Maximum trends", "minimum": 1, "maximum": 500, "type": "integer", "description": "Maximum number of trending searches to save. Keep this low for quick tests.", "default": 20 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Optional proxy settings. The public Google Trends RSS feed usually works without a proxy.", "default": { "useApifyProxy": false } } } }, "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 } } } } } } } } } } ```