# Google News Scraper — Keyword & Brand Monitoring (`q_services/google-news-scraper`) Actor Search Google News by keyword and get clean article data: title, link, source, date. Multi-language. Ideal for brand monitoring. - **URL**: https://apify.com/q\_services/google-news-scraper.md - **Developed by:** [Q Services](https://apify.com/q_services) (community) - **Categories:** News, Marketing - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $0.50 / 1,000 article extracteds 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 ## Google News Scraper — Keyword & Brand Monitoring Recherchez **n'importe quel mot-clé dans Google News** et récupérez un dataset propre d'articles : titre, lien, source, date de publication. Multi-langues, multi-pays, prêt à exporter en JSON, CSV ou Excel. Idéal pour : brand monitoring, veille média, suivi de concurrents, détection de crises, alimentation de newsletters et workflows Make / Zapier / n8n. **Exemple de résultat :** ```json { "title": "OpenAI announces new enterprise partnership", "link": "https://news.google.com/rss/articles/CBMi...", "source": "The New York Times", "sourceUrl": "https://www.nytimes.com", "publishedAt": "2026-07-09T06:12:00.000Z", "query": "openai", "scrapedAt": "2026-07-09T10:30:00.000Z" } ```` ### Comment l'utiliser 1. Entrez un ou plusieurs **mots-clés** (marque, concurrent, sujet…) 2. Choisissez la **langue** et le **pays** des résultats 3. Cliquez sur **Start** — les résultats apparaissent dans l'onglet *Dataset* Astuce : planifiez un run quotidien (onglet *Schedule*) pour une veille média automatique. Les opérateurs de recherche Google fonctionnent : `"expression exacte"`, `site:lemonde.fr`, `-exclusion`, `when:24h` (dernières 24 h). ### Combien ça coûte ? Tarification à l'usage, sans abonnement : | Événement | Prix | |---|---| | Démarrage du run | 0,005 $ | | Par article extrait | 0,0005 $ | **Exemple concret : 500 articles ≈ 0,26 $.** Vous pouvez fixer une limite de dépense par run dans les options — l'Actor s'arrête proprement dès qu'elle est atteinte. ### Champs retournés | Champ | Type | Toujours présent ? | |---|---|---| | `title` | texte | Oui | | `link` | lien (redirection Google News) | Oui | | `source` | texte (nom du média) | Non (`null` si absent) | | `sourceUrl` | lien (site du média) | Non (`null` si absent) | | `publishedAt` | date ISO | Non (`null` si absent) | | `query` | texte (mot-clé d'origine) | Oui | | `scrapedAt` | date ISO | Oui | ### Limitations (en toute transparence) - Google News limite chaque recherche à ~100 articles ; utilisez plusieurs mots-clés ou l'opérateur `when:24h` avec un run planifié pour une couverture continue - Le champ `link` est l'URL de redirection Google News (elle s'ouvre normalement dans un navigateur) — pas l'URL finale de l'article - Ne récupère pas le contenu complet des articles — uniquement les métadonnées du flux ### FAQ **Le run se termine avec 0 résultat, pourquoi ?** Mots-clés trop restrictifs ou combinaison langue/pays sans résultats. Essayez des termes plus larges. L'Actor échoue volontairement plutôt que de retourner un dataset vide. **Puis-je surveiller plusieurs marques en un seul run ?** Oui, ajoutez autant de mots-clés que vous voulez. Les doublons entre recherches sont automatiquement supprimés. **Puis-je l'utiliser via API ?** Oui, chaque Actor Apify est appelable par API et via MCP. Voir l'onglet *API* de cette page. **Les données sont-elles à jour ?** Chaque run interroge Google News en temps réel au moment de l'exécution. **Est-ce légal ?** L'Actor n'extrait que des métadonnées publiquement accessibles via les flux RSS de Google News. Vous restez responsable de l'usage que vous faites des données et du respect des conditions d'utilisation de Google. # Actor input Schema ## `queries` (type: `array`): Un ou plusieurs termes à rechercher dans Google News. Exemple : le nom de votre marque, d'un concurrent, d'un sujet à surveiller. ## `language` (type: `string`): Code langue des résultats, ex. "en-US", "fr", "de", "es". ## `country` (type: `string`): Code pays à 2 lettres, ex. "US", "FR", "DE". ## `maxResults` (type: `integer`): L'Actor s'arrête (et arrête de facturer) une fois ce nombre atteint. Google News retourne au maximum ~100 articles par recherche. ## `proxyConfiguration` (type: `object`): Configuration proxy. Le proxy Apify par défaut convient dans la plupart des cas. ## Actor input object example ```json { "queries": [ "artificial intelligence" ], "language": "en-US", "country": "US", "maxResults": 100, "proxyConfiguration": { "useApifyProxy": true } } ``` # 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 = { "queries": [ "artificial intelligence" ], "language": "en-US", "country": "US", "maxResults": 100, "proxyConfiguration": { "useApifyProxy": true } }; // Run the Actor and wait for it to finish const run = await client.actor("q_services/google-news-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 = { "queries": ["artificial intelligence"], "language": "en-US", "country": "US", "maxResults": 100, "proxyConfiguration": { "useApifyProxy": True }, } # Run the Actor and wait for it to finish run = client.actor("q_services/google-news-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 '{ "queries": [ "artificial intelligence" ], "language": "en-US", "country": "US", "maxResults": 100, "proxyConfiguration": { "useApifyProxy": true } }' | apify call q_services/google-news-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=q_services/google-news-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Google News Scraper — Keyword & Brand Monitoring", "description": "Search Google News by keyword and get clean article data: title, link, source, date. Multi-language. Ideal for brand monitoring.", "version": "1.0", "x-build-id": "3YU3mgVtfcHAGYo7w" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/q_services~google-news-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-q_services-google-news-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/q_services~google-news-scraper/runs": { "post": { "operationId": "runs-sync-q_services-google-news-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/q_services~google-news-scraper/run-sync": { "post": { "operationId": "run-sync-q_services-google-news-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": [ "queries" ], "properties": { "queries": { "title": "Mots-clés de recherche", "type": "array", "description": "Un ou plusieurs termes à rechercher dans Google News. Exemple : le nom de votre marque, d'un concurrent, d'un sujet à surveiller.", "default": [ "artificial intelligence" ], "items": { "type": "string" } }, "language": { "title": "Langue", "type": "string", "description": "Code langue des résultats, ex. \"en-US\", \"fr\", \"de\", \"es\".", "default": "en-US" }, "country": { "title": "Pays", "type": "string", "description": "Code pays à 2 lettres, ex. \"US\", \"FR\", \"DE\".", "default": "US" }, "maxResults": { "title": "Nombre maximum de résultats", "minimum": 1, "maximum": 10000, "type": "integer", "description": "L'Actor s'arrête (et arrête de facturer) une fois ce nombre atteint. Google News retourne au maximum ~100 articles par recherche.", "default": 100 }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Configuration proxy. Le proxy Apify par défaut convient dans la plupart des cas.", "default": { "useApifyProxy": 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 } } } } } } } } } } ```