# Google Trending Searches Scraper (`fetch_cat/google-trending-searches-scraper`) Actor Track country-level Google trending searches with traffic labels, timing, images, and optional related news for SEO, editorial, and market-monitoring workflows. - **URL**: https://apify.com/fetch\_cat/google-trending-searches-scraper.md - **Developed by:** [Hanna Nosova](https://apify.com/fetch_cat) (community) - **Categories:** SEO tools, News - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing Pay per event 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 Trending Searches Scraper Track country-level Google trending search topics, traffic estimates, timing, and related news context in a clean Apify dataset. ### Daily Google Trending Searches by country Google Trending Searches Scraper collects current country-level trending search topics for one or more countries. ### Google Trends vs Google Trending Searches: what this actor collects This actor collects the daily/current Google Trending Searches feed by country, including trend titles, traffic labels, timing, images, and optional related news context. It is not a full Google Trends historical analytics API for arbitrary keyword interest-over-time queries. It returns structured rows that are ready for dashboards, alerts, spreadsheets, content calendars, and market monitoring workflows. Each result can include the trend phrase, approximate traffic, publication time, image metadata, source traceability, and related news context. Use it when you need recurring visibility into what people are searching for right now. ### Who is it for? #### SEO teams Monitor country-level trend demand and discover timely keyword opportunities. #### Publishers and editors Find story ideas while a topic is still gaining public attention. #### Content marketers Plan fast-response posts, newsletters, videos, or social media updates around real demand. #### Market researchers Track attention spikes by country and compare which themes appear in different markets. #### Automation builders Feed trend data into Slack alerts, BI tools, Airtable bases, or internal scoring workflows. ### Why use this actor? - ⚡ Fast HTTP collection for lightweight trend monitoring. - 🌍 Multi-country input so one run can cover several markets. - 📰 Optional related news cards for context around each search topic. - 📊 Consistent dataset fields for export and automation. - 🔁 Designed for scheduled runs and recurring trend watchlists. Daily Google Trending Searches by country are useful for recurring dashboards, newsroom alerts, content calendars, and market-monitoring workflows. Google Trends vs Google Trending Searches: what this actor collects is simple: this actor focuses on the current country-level trending searches feed, not historical interest-over-time analytics for arbitrary keywords. ### What data can you extract? | Field | Description | | --- | --- | | `geo` | Country or region code used for the trend collection. | | `title` | Trending search topic or phrase. | | `approxTraffic` | Approximate traffic label when available. | | `pubDate` | Time associated with the trend item. | | `link` | Source trend link. | | `picture` | Related image URL when available. | | `pictureSource` | Image source label. | | `newsItems` | Related news cards when enabled. | | `sourceUrl` | Source URL used for the geo. | | `scrapedAt` | Timestamp when the actor saved the item. | ### Use as an RSS feed You can turn the latest dataset items from a saved Apify task into an RSS feed. Create an actor task with your preferred input, then use the task's last-run dataset endpoint with `format=rss`, `fields`, and `outputFields`: ```text https://api.apify.com/v2/actor-tasks/[TASK_ID]/runs/last/dataset/items?format=rss&fields=title,link,pubDate&outputFields=title,link,pubDate&token=[APIFY_TOKEN] ```` Use the `fields` list to select this actor's dataset columns, and `outputFields` to map them to RSS item fields such as `title`, `link`, `description`, and `pubDate`. Keep your Apify API token private; do not embed tokenized feed URLs in public websites, public repositories, or client-side code. ### How much does it cost to scrape Google trending searches? This actor uses pay-per-event pricing. You pay a small run-start event and a per-result event for each saved trending search topic. For most small monitoring jobs, the cost is low because each country requires only a lightweight collection request. Example: scraping 2 countries with 10 trends per country saves up to 20 result rows. ### Input options | Input | Type | Default | Description | | --- | --- | --- | --- | | `geos` | array of strings | `['US']` | Google Trends country or region codes. | | `maxItemsPerGeo` | integer | `20` | Maximum trend rows to save per geo. | | `includeNewsItems` | boolean | `true` | Include related news cards when available. | ### Example input ```json { "geos": ["US", "GB", "CA"], "maxItemsPerGeo": 10, "includeNewsItems": true } ``` ### Example output ```json { "geo": "US", "title": "example trend", "approxTraffic": "2000+", "pubDate": "Tue, 16 Jun 2026 19:30:00 -0700", "link": "https://trends.google.com/trending/rss?geo=US", "picture": "https://encrypted-tbn0.gstatic.com/images?...", "pictureSource": "Example Source", "newsItems": [ { "title": "Related story title", "snippet": "Short context about the trend", "url": "https://example.com/story", "picture": "https://example.com/image.jpg", "source": "Example Publisher" } ], "sourceUrl": "https://trends.google.com/trending/rss?geo=US", "scrapedAt": "2026-06-17T00:00:00.000Z" } ``` ### How to run it 1. Open the actor on Apify. 2. Add one or more geo codes. 3. Choose the maximum number of trends per geo. 4. Decide whether to include related news context. 5. Click **Start**. 6. Export the dataset as JSON, CSV, Excel, XML, or RSS. ### Tips for best results - Use common country codes such as `US`, `GB`, `CA`, `AU`, `IN`, `DE`, `FR`, `BR`, and `JP`. - Keep `maxItemsPerGeo` modest for scheduled monitoring runs. - Enable related news items when you need editorial context. - Disable related news items when you only need a compact keyword watchlist. - Schedule the actor daily or hourly depending on how quickly your workflow reacts to trends. ### Scheduling ideas Run the actor every morning for a daily editorial planning report. Run it every few hours for newsroom alerts. Run it before campaign planning meetings to identify sudden audience interest. Run separate tasks by region if different teams own different markets. ### Integrations #### Slack alerts Connect the dataset to a Slack automation and post the top trends for selected countries. #### Google Sheets Export results to Sheets for editorial review, keyword tagging, and content planning. #### Airtable Store trend rows in Airtable and add custom workflow fields such as priority, owner, or status. #### BI dashboards Use the Apify API to feed trend data into Looker Studio, Power BI, Tableau, or internal dashboards. #### Content calendars Turn trend titles and related news snippets into draft calendar ideas for writers or social teams. #### Scheduled editorial feeds Send scheduled trend snapshots to Google Sheets, Slack or email via Zapier/Make, BI dashboards, Apify API workflows, or MCP-enabled research assistants. ### API usage with Node.js ```js import { ApifyClient } from 'apify-client'; const client = new ApifyClient({ token: process.env.APIFY_TOKEN }); const run = await client.actor('fetch_cat/google-trending-searches-scraper').call({ geos: ['US', 'GB'], maxItemsPerGeo: 10, includeNewsItems: true, }); const { items } = await client.dataset(run.defaultDatasetId).listItems(); console.log(items); ``` ### API usage with Python ```python from apify_client import ApifyClient import os client = ApifyClient(os.environ['APIFY_TOKEN']) run = client.actor('fetch_cat/google-trending-searches-scraper').call(run_input={ 'geos': ['US', 'GB'], 'maxItemsPerGeo': 10, 'includeNewsItems': True, }) items = client.dataset(run['defaultDatasetId']).list_items().items print(items) ``` ### API usage with cURL ```bash curl -X POST 'https://api.apify.com/v2/acts/fetch_cat~google-trending-searches-scraper/runs?token=YOUR_APIFY_TOKEN' \ -H 'Content-Type: application/json' \ -d '{"geos":["US","GB"],"maxItemsPerGeo":10,"includeNewsItems":true}' ``` ### MCP integration Use this actor through Apify MCP from Claude or other MCP-compatible clients. MCP endpoint: ```text https://mcp.apify.com/?tools=fetch_cat/google-trending-searches-scraper ``` #### Claude Code MCP setup ```bash claude mcp add apify-google-trending-searches https://mcp.apify.com/?tools=fetch_cat/google-trending-searches-scraper ``` Then ask: ```text Run Google Trending Searches Scraper for US and GB with 10 trends per country and summarize the biggest topics. ``` #### Claude Desktop MCP setup Add an MCP server entry that points to: ```text https://mcp.apify.com/?tools=fetch_cat/google-trending-searches-scraper ``` Example JSON configuration: ```json { "mcpServers": { "apify-google-trending-searches": { "url": "https://mcp.apify.com/?tools=fetch_cat/google-trending-searches-scraper" } } } ``` Example prompt: ```text Collect today's trending searches for CA, AU, and IN. Group them by country and suggest newsletter angles. ``` #### MCP automation prompts - "Find trending searches in the US and suggest 5 blog post ideas." - "Compare trending searches in GB and AU and identify overlapping themes." - "Collect trends for DE, FR, and IT and create a short market brief." - "Send me the top 10 US trends with related news sources." ### Data quality notes Traffic values are approximate labels provided by the source. Trend availability varies by country and time. Some trend items may have images or related news while others may not. The actor keeps missing optional fields as `null` or empty arrays rather than inventing data. ### Limits The actor caps `maxItemsPerGeo` at 100 to keep runs predictable. Unsupported or temporarily unavailable geo codes may produce no rows. Country-level availability can change over time. For broad monitoring, start with a few geos and expand after confirming the dataset matches your workflow. ### FAQ and troubleshooting #### Can I use this as a Google Trends API alternative? Use it as an API alternative for daily/current Google Trending Searches feeds. It does not cover every Google Trends feature, such as historical interest-over-time analytics for arbitrary keywords. #### Which countries are supported? Use common Google Trending Searches country codes such as `US`, `GB`, `CA`, `AU`, `IN`, `DE`, `FR`, `BR`, and `JP`. Availability can change by country and time. #### Can I include related news cards? Yes. Enable `includeNewsItems` to include related news context when the source exposes it. #### Why did a geo return no results? Check that the geo code is supported and try a common code such as `US`, `GB`, `CA`, `AU`, or `IN`. #### Why are some news fields empty? Related news cards are optional. Some trend topics only include the trend title and traffic context. #### Why is traffic a string like `2000+`? The source provides approximate traffic labels, not exact numeric counts. ### Legality and responsible use This actor collects publicly available trend information. Use the data responsibly and respect applicable laws, platform terms, and privacy requirements. Do not use the actor to infer sensitive personal information about individuals. ### Related actors and scrapers - https://apify.com/fetch\_cat/google-news-scraper - https://apify.com/fetch\_cat/bing-search-results-scraper - https://apify.com/fetch\_cat/youtube-search-results-scraper - https://apify.com/fetch\_cat/substack-posts-scraper - https://apify.com/fetch\_cat/reddit-scraper ### Changelog #### 0.1 Initial version with multi-geo trending search collection, traffic estimates, optional related news cards, and normalized dataset output. ### Support If you need a new country workflow, additional output fields, or a scheduled monitoring setup, open an Apify issue from the actor page. ### Summary Google Trending Searches Scraper helps teams spot what audiences are searching for now. It is built for recurring trend monitoring, editorial planning, SEO workflows, and lightweight market intelligence. # Actor input Schema ## `geos` (type: `array`): Country or region codes to collect trends for. Use Google Trends country codes such as US, GB, CA, AU, IN, DE, FR, BR, or JP. ## `maxItemsPerGeo` (type: `integer`): Maximum number of trending search topics to save for each geo. ## `includeNewsItems` (type: `boolean`): Include related news article titles, snippets, URLs, images, and sources when Google provides them for a trend. ## Actor input object example ```json { "geos": [ "US", "GB" ], "maxItemsPerGeo": 10, "includeNewsItems": true } ``` # 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 = { "geos": [ "US", "GB" ], "maxItemsPerGeo": 10, "includeNewsItems": true }; // Run the Actor and wait for it to finish const run = await client.actor("fetch_cat/google-trending-searches-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 = { "geos": [ "US", "GB", ], "maxItemsPerGeo": 10, "includeNewsItems": True, } # Run the Actor and wait for it to finish run = client.actor("fetch_cat/google-trending-searches-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 '{ "geos": [ "US", "GB" ], "maxItemsPerGeo": 10, "includeNewsItems": true }' | apify call fetch_cat/google-trending-searches-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=fetch_cat/google-trending-searches-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Google Trending Searches Scraper", "description": "Track country-level Google trending searches with traffic labels, timing, images, and optional related news for SEO, editorial, and market-monitoring workflows.", "version": "0.1", "x-build-id": "QxgPvYOd1HbtjbhbM" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/fetch_cat~google-trending-searches-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-fetch_cat-google-trending-searches-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-trending-searches-scraper/runs": { "post": { "operationId": "runs-sync-fetch_cat-google-trending-searches-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-trending-searches-scraper/run-sync": { "post": { "operationId": "run-sync-fetch_cat-google-trending-searches-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": { "geos": { "title": "Geo codes", "type": "array", "description": "Country or region codes to collect trends for. Use Google Trends country codes such as US, GB, CA, AU, IN, DE, FR, BR, or JP.", "items": { "type": "string", "minLength": 2 }, "default": [ "US" ] }, "maxItemsPerGeo": { "title": "Maximum trends per geo", "minimum": 1, "maximum": 100, "type": "integer", "description": "Maximum number of trending search topics to save for each geo.", "default": 20 }, "includeNewsItems": { "title": "Include related news items", "type": "boolean", "description": "Include related news article titles, snippets, URLs, images, and sources when Google provides them for a trend.", "default": true } } }, "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 } } } } } } } } } } ```