# Google News Keyword Monitor and Alert Feed (`redfoxxie/google-news-keyword-monitor-alerts`) Actor Monitor public Google News keyword searches and emit only unseen articles across scheduled runs, with persistent deduplication, locale controls, publisher metadata, free previews, and source diagnostics. - **URL**: https://apify.com/redfoxxie/google-news-keyword-monitor-alerts.md - **Developed by:** [Joรฃo Ferreira](https://apify.com/redfoxxie) (community) - **Categories:** News, Automation, Developer tools - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing $3.00 / 1,000 new google news article alerts 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 web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows. 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 This independent product is not affiliated with, sponsored by, or endorsed by Google or Google News. ### Scheduled Google News searches that return only unseen articles Google News Keyword Monitor and Alert Feed converts public Google News RSS searches into a persistent media-monitoring stream. It is designed for brand mentions, competitor intelligence, company monitoring, regulatory topics, market research, public-relations workflows, and automation systems that need new headlines rather than the same search page on every run. Provide up to 20 keyword or advanced search queries, a two-letter language, a two-letter country edition, and a stable `monitorId`. The Actor requests the corresponding public RSS editions and normalizes article identity, headline, publisher, publication time, feed link, discovery query, source, and discovery timestamp. Results found by multiple queries are deduplicated within the run. ### Persistent deduplication A bounded set of delivered article IDs is stored in limited-permission named key-value storage. Scheduled runs suppress previously delivered records while preserving the query that first discovered each new article. Separate monitor IDs maintain independent histories for clients, brands, projects, or alert topics. `previewOnly=true` is enabled by default. Preview mode confirms query behavior, locale settings, source availability, and potential output without charging custom events or changing state. Partial query failures are shown in the summary. If every source request fails, the run fails visibly instead of pretending there were no relevant articles. ### Output Article alerts include the stable article ID, headline, publisher, publication time, Google News link, search query, public source identifier, and discovery timestamp. The `alerts` dataset view supports webhooks, media dashboards, research archives, email digests, and downstream classification. The Actor deliberately returns source metadata rather than claiming to reproduce publisher article bodies. ### Pricing Pricing is **Pay per event + usage** with **no start fee**. Each delivered unseen article uses event `new_google_news_alert` at **$0.003**. Duplicate articles are not billed again. Apify platform usage is charged separately to the runner under the platformโ€™s normal compute and storage rules. Preview mode does not emit the paid event. Google News controls feed coverage, ranking, links, and availability. This Actor reports what the public feed returned and does not promise exhaustive global news coverage. Users remain responsible for lawful usage and for respecting publisher rights when following article links. # Actor input Schema ## `queries` (type: `array`): Keyword or advanced Google News queries to monitor. ## `language` (type: `string`): Two-letter Google News interface language. ## `country` (type: `string`): Two-letter Google News country edition. ## `maxAlerts` (type: `integer`): Maximum paid unseen articles emitted per run. ## `monitorId` (type: `string`): Stable identifier for independent deduplication state. ## `previewOnly` (type: `boolean`): Fetch articles without charging or mutating state. ## Actor input object example ```json { "queries": [ "artificial intelligence regulation" ], "language": "en", "country": "us", "maxAlerts": 200, "monitorId": "ai-regulation", "previewOnly": true } ```` # Actor output Schema ## `articles` (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 = {}; // Run the Actor and wait for it to finish const run = await client.actor("redfoxxie/google-news-keyword-monitor-alerts").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 = {} # Run the Actor and wait for it to finish run = client.actor("redfoxxie/google-news-keyword-monitor-alerts").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 '{}' | apify call redfoxxie/google-news-keyword-monitor-alerts --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=redfoxxie/google-news-keyword-monitor-alerts", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Google News Keyword Monitor and Alert Feed", "description": "Monitor public Google News keyword searches and emit only unseen articles across scheduled runs, with persistent deduplication, locale controls, publisher metadata, free previews, and source diagnostics.", "version": "0.1", "x-build-id": "a3S0odHBHUpa7oW83" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/redfoxxie~google-news-keyword-monitor-alerts/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-redfoxxie-google-news-keyword-monitor-alerts", "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/redfoxxie~google-news-keyword-monitor-alerts/runs": { "post": { "operationId": "runs-sync-redfoxxie-google-news-keyword-monitor-alerts", "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/redfoxxie~google-news-keyword-monitor-alerts/run-sync": { "post": { "operationId": "run-sync-redfoxxie-google-news-keyword-monitor-alerts", "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": [ "queries" ], "properties": { "queries": { "title": "News search queries", "minItems": 1, "maxItems": 20, "type": "array", "description": "Keyword or advanced Google News queries to monitor.", "items": { "type": "string", "maxLength": 300 }, "default": [ "artificial intelligence regulation" ] }, "language": { "title": "Language code", "maxLength": 2, "type": "string", "description": "Two-letter Google News interface language.", "default": "en" }, "country": { "title": "Country code", "maxLength": 2, "type": "string", "description": "Two-letter Google News country edition.", "default": "us" }, "maxAlerts": { "title": "Maximum article alerts", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Maximum paid unseen articles emitted per run.", "default": 200 }, "monitorId": { "title": "Monitor state ID", "maxLength": 60, "type": "string", "description": "Stable identifier for independent deduplication state.", "default": "default" }, "previewOnly": { "title": "Free preview", "type": "boolean", "description": "Fetch articles without charging or mutating state.", "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 } } } } } } } } } } ```