# Google News Scraper CHEAP (`quintuple_quidnunc/google-news-serp-api`) Actor Google News scraper. Direct article URLs, date filters, regional domains. No browser, no proxies. Fast and reliable. Pay per result. $1.00/1K. - **URL**: https://apify.com/quintuple\_quidnunc/google-news-serp-api.md - **Developed by:** [Dmitry BT](https://apify.com/quintuple_quidnunc) (community) - **Categories:** News, SEO tools, MCP servers - **Stats:** 1 total users, 0 monthly users, 0.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing $1.00 / 1,000 result items 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 API Extract structured Google News search results via a clean, fast API. Get headlines, sources, URLs, snippets, and publication dates - with support for date filtering, regional domains, and advanced search parameters. **Pricing:** $1.00 per 1,000 results (~$0.001 per result). Pay only for what you extract. --- ### Why use this Actor? - **True API, not a scraper** - built on a real search API, not browser automation. No Playwright, no proxies, no bot detection headaches. Results are fast and reliable. - **Direct article URLs** - every result contains the real article URL, not a Google redirect link. No extra decoding step needed - the URL is ready to use immediately. - **Rich date filtering** - filter by past hour, day, week, month, year, or any custom date range (e.g. `2024-01-01:2024-01-31`). Most competitors only support preset options. - **Regional search via seDomain** - search on any Google regional version: `google.de`, `google.co.uk`, `google.fr`, and more. Combine with language and location codes for truly localized results. - **Advanced searchParam for power users** - pass raw Google URL parameters directly (e.g. `tbs=qdr:w`, `safe=active`). Full control over search behavior without waiting for new features. - **Pay per result** - you only pay for data extracted, not for compute time or idle runs. - **Up to 200 results per query** - suitable for monitoring, research, and aggregation at scale. --- ### Monitoring & scheduling This Actor is well suited for continuous news monitoring. Run it on a schedule to track any topic, brand, or keyword over time. **How to set up monitoring:** 1. Open the Actor and click **Schedule** to set a recurring run (hourly, daily, weekly). 2. Use `dateFilter: "past_day"` (or `past_hour`) so each run only fetches fresh articles. 3. Connect to downstream tools via Apify integrations: send results to **Google Sheets**, trigger a **Slack** notification, post to a **webhook**, or pipe data into **Make** / **Zapier**. This gives you a lightweight media monitoring system - no additional infrastructure required. --- ### What you get Each result includes: - `type` - `news_search` or `top_stories_element` - `title` - article headline - `source` / `domain` - publisher name and domain - `url` - direct link to the article - `snippet` - article summary - `publishedText` - relative time (e.g. "2 hours ago", "3 days ago") - `timestamp` - publication timestamp - `imageUrl` - thumbnail image URL (when available) - `keyword`, `locationCode`, `languageCode`, `searchDatetime` - search metadata - `rankAbsolute`, `rankGroup` - position in search results --- ### Input parameters | Parameter | Type | Default | Description | |-----------|------|---------|-------------| | `keyword` | string | *required* | Search query. Max 500 characters. | | `languageCode` | string | `en` | Language code (ISO 639-1). E.g. `en`, `de`, `fr`, `es`. | | `locationCode` | integer | `2840` | Location code. `2840` = USA, `2826` = UK, `2276` = Germany. See [Supported locations](#supported-locations) below. | | `depth` | integer | `100` | Number of results to retrieve. Min 10, max 200. | | `dateFilter` | string | - | Filter results by date. See [Date Filtering](#date-filtering) below. | | `searchParam` | string | - | Advanced: raw Google search parameter string (e.g. `tbs=qdr:d`). Overrides `dateFilter` if both set. | | `seDomain` | string | - | Google domain to use (e.g. `google.de`, `google.co.uk`). Useful for region-specific results. | | `maxWaitSeconds` | integer | `600` | Max time to wait for results. Range: 60-1800 seconds. | | `pollIntervalSeconds` | integer | `10` | How often to check for results. Range: 5-60 seconds. | --- ### Date Filtering Use `dateFilter` to restrict results to a specific time period. #### Preset values | Value | Description | |-------|-------------| | `past_hour` | Results published in the past hour | | `past_day` | Results published in the past 24 hours | | `past_week` | Results published in the past 7 days | | `past_month` | Results published in the past month | | `past_year` | Results published in the past year | #### Custom date range Use ISO format: `YYYY-MM-DD:YYYY-MM-DD` ```` dateFilter: "2024-01-01:2024-01-31" ```` This returns news articles published between January 1 and January 31, 2024. --- ### Advanced: searchParam For power users, `searchParam` passes raw Google URL parameters directly to the search engine. This gives full control over search filters. **Examples:** | searchParam | Effect | |-------------|--------| | `tbs=qdr:h` | Past hour | | `tbs=qdr:d` | Past 24 hours | | `tbs=qdr:w` | Past week | | `tbs=qdr:m` | Past month | | `tbs=qdr:y` | Past year | | `tbs=cdr:1,cd_min:01/01/2024,cd_max:01/31/2024` | Custom date range | | `safe=active` | SafeSearch on | > **Note:** `searchParam` takes priority over `dateFilter` if both are provided. --- ### Regional search with seDomain Use `seDomain` to search on a specific regional Google version. | seDomain | Region | |----------|--------| | `google.com` | Global (default) | | `google.de` | Germany | | `google.co.uk` | United Kingdom | | `google.fr` | France | | `google.es` | Spain | | `google.it` | Italy | | `google.com.br` | Brazil | | `google.co.jp` | Japan | | `google.com.au` | Australia | Combine with `locationCode` and `languageCode` for best results. For example, German news: `seDomain: "google.de"`, `languageCode: "de"`, `locationCode: 2276`. --- ### Use cases - **Media monitoring** - track brand mentions, competitor coverage, or industry topics in real-time - **Market research** - collect news about specific companies, markets, or trends for analysis - **Content aggregation** - build news feeds or newsletters from curated topics and sources - **Sentiment analysis** - feed article headlines and snippets into NLP pipelines - **Academic research** - gather news datasets filtered by date, region, and topic - **AI/LLM training data** - extract structured news data at scale --- ### Example inputs **Basic: top AI news from the past 24 hours (USA)** ```json { "keyword": "artificial intelligence", "languageCode": "en", "locationCode": 2840, "depth": 100, "dateFilter": "past_day" } ```` **German news about Bundesliga** ```json { "keyword": "Bundesliga", "languageCode": "de", "locationCode": 2276, "depth": 50, "seDomain": "google.de", "dateFilter": "past_week" } ``` **Bitcoin news for a custom date range** ```json { "keyword": "bitcoin", "languageCode": "en", "locationCode": 2840, "depth": 200, "dateFilter": "2024-01-01:2024-01-31" } ``` **Advanced raw search param** ```json { "keyword": "climate change", "languageCode": "en", "locationCode": 2840, "depth": 100, "searchParam": "tbs=qdr:w" } ``` *** ### Pricing - **$1.00 per 1,000 results** ($0.001 per result) - Billing is per extracted result item - A run with `depth: 100` costs $0.10 - A run with `depth: 10` costs $0.01 *** ### Supported languages Top 30 most common language codes: | Language | Code | Language | Code | |----------|------|----------|------| | English | `en` | Arabic | `ar` | | German | `de` | Korean | `ko` | | French | `fr` | Turkish | `tr` | | Spanish | `es` | Swedish | `sv` | | Portuguese | `pt` | Danish | `da` | | Italian | `it` | Finnish | `fi` | | Dutch | `nl` | Norwegian | `no` | | Polish | `pl` | Czech | `cs` | | Russian | `ru` | Hungarian | `hu` | | Japanese | `ja` | Romanian | `ro` | | Chinese (Simplified) | `zh-CN` | Ukrainian | `uk` | | Chinese (Traditional) | `zh-TW` | Hindi | `hi` | | Indonesian | `id` | Vietnamese | `vi` | | Thai | `th` | Greek | `el` | | Hebrew | `he` | Bulgarian | `bg` | Full list of all 129 supported languages: [languages.md](https://github.com/satorisat/apiscraper/blob/main/actor/docs/languages.md) *** ### Supported locations Top 30 most common location codes (countries): | Code | Country | Code | Country | |------|---------|------|---------| | 2840 | United States | 2356 | India | | 2826 | United Kingdom | 2392 | Japan | | 2276 | Germany | 2124 | Canada | | 2250 | France | 2036 | Australia | | 2724 | Spain | 2643 | Russia | | 2380 | Italy | 2484 | Mexico | | 2528 | Netherlands | 2410 | South Korea | | 2616 | Poland | 2040 | Austria | | 2752 | Sweden | 2756 | Switzerland | | 2056 | Belgium | 2702 | Singapore | | 2620 | Portugal | 2764 | Thailand | | 2076 | Brazil | 2818 | Egypt | | 2792 | Turkey | 2710 | South Africa | | 2566 | Nigeria | 2682 | Saudi Arabia | | 2032 | Argentina | 2458 | Malaysia | Full list of all 213 supported countries: [locations.md](https://github.com/satorisat/apiscraper/blob/main/actor/docs/locations.md) # Actor input Schema ## `keyword` (type: `string`): Search query for Google News results. Max 500 characters. ## `languageCode` (type: `string`): Search language. Two-letter ISO 639-1 code. Common values: en (English), de (German), fr (French), es (Spanish), pt (Portuguese), it (Italian), nl (Dutch), pl (Polish), ru (Russian), ja (Japanese), zh-CN (Chinese Simplified), ar (Arabic). Default: en. ## `locationCode` (type: `integer`): Numeric country/region code for search localization. Common values: 2840 United States, 2826 United Kingdom, 2276 Germany, 2250 France, 2724 Spain, 2380 Italy, 2076 Brazil, 2356 India, 2392 Japan, 2124 Canada, 2036 Australia. See Supported Locations section in the README. Default: 2840. ## `depth` (type: `integer`): Number of Google News results to retrieve. Billing is per result ($0.00075 per result). Default: 100. ## `dateFilter` (type: `string`): Filter news results by publication date. Presets: past\_hour, past\_day, past\_week, past\_month, past\_year. For a custom range use ISO format: YYYY-MM-DD:YYYY-MM-DD (e.g. 2024-01-01:2024-01-31). Leave empty for no date filter. ## `searchParam` (type: `string`): Advanced: pass raw Google URL parameters directly (e.g. 'tbs=qdr:d' for past day, 'safe=active' for SafeSearch). Overrides dateFilter if both are set. Leave empty if not needed. ## `seDomain` (type: `string`): Google search engine domain to use. Useful for region-specific results. Examples: google.com (default), google.de (Germany), google.co.uk (UK), google.fr (France), google.es (Spain), google.it (Italy), google.com.br (Brazil), google.co.jp (Japan). Leave empty to use the default for the selected location. ## `maxWaitSeconds` (type: `integer`): Maximum time to wait for search results. Minimum 60, maximum 1800 seconds. Default: 600. ## `pollIntervalSeconds` (type: `integer`): How often to check for results. Minimum 5 seconds. Default: 10. ## Actor input object example ```json { "keyword": "android", "languageCode": "en", "locationCode": 2840, "depth": 100, "dateFilter": "", "searchParam": "", "seDomain": "", "maxWaitSeconds": 600, "pollIntervalSeconds": 10 } ``` # Actor output Schema ## `results` (type: `string`): Dataset containing extracted news articles. ## `output` (type: `string`): Key-value store entry with run metadata. # 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("quintuple_quidnunc/google-news-serp-api").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("quintuple_quidnunc/google-news-serp-api").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 quintuple_quidnunc/google-news-serp-api --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=quintuple_quidnunc/google-news-serp-api", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Google News Scraper CHEAP", "description": "Google News scraper. Direct article URLs, date filters, regional domains. No browser, no proxies. Fast and reliable. Pay per result. $1.00/1K.", "version": "0.1", "x-build-id": "sdLHVHScTx0LUoffX" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/quintuple_quidnunc~google-news-serp-api/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-quintuple_quidnunc-google-news-serp-api", "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/quintuple_quidnunc~google-news-serp-api/runs": { "post": { "operationId": "runs-sync-quintuple_quidnunc-google-news-serp-api", "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/quintuple_quidnunc~google-news-serp-api/run-sync": { "post": { "operationId": "run-sync-quintuple_quidnunc-google-news-serp-api", "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": [ "keyword" ], "properties": { "keyword": { "title": "Keyword", "type": "string", "description": "Search query for Google News results. Max 500 characters.", "default": "android" }, "languageCode": { "title": "Language code", "type": "string", "description": "Search language. Two-letter ISO 639-1 code. Common values: en (English), de (German), fr (French), es (Spanish), pt (Portuguese), it (Italian), nl (Dutch), pl (Polish), ru (Russian), ja (Japanese), zh-CN (Chinese Simplified), ar (Arabic). Default: en.", "default": "en" }, "locationCode": { "title": "Location code", "minimum": 1, "type": "integer", "description": "Numeric country/region code for search localization. Common values: 2840 United States, 2826 United Kingdom, 2276 Germany, 2250 France, 2724 Spain, 2380 Italy, 2076 Brazil, 2356 India, 2392 Japan, 2124 Canada, 2036 Australia. See Supported Locations section in the README. Default: 2840.", "default": 2840 }, "depth": { "title": "Number of results", "minimum": 10, "maximum": 200, "type": "integer", "description": "Number of Google News results to retrieve. Billing is per result ($0.00075 per result). Default: 100.", "default": 100 }, "dateFilter": { "title": "Date filter", "type": "string", "description": "Filter news results by publication date. Presets: past_hour, past_day, past_week, past_month, past_year. For a custom range use ISO format: YYYY-MM-DD:YYYY-MM-DD (e.g. 2024-01-01:2024-01-31). Leave empty for no date filter.", "default": "" }, "searchParam": { "title": "Search param (advanced)", "type": "string", "description": "Advanced: pass raw Google URL parameters directly (e.g. 'tbs=qdr:d' for past day, 'safe=active' for SafeSearch). Overrides dateFilter if both are set. Leave empty if not needed.", "default": "" }, "seDomain": { "title": "Search engine domain", "type": "string", "description": "Google search engine domain to use. Useful for region-specific results. Examples: google.com (default), google.de (Germany), google.co.uk (UK), google.fr (France), google.es (Spain), google.it (Italy), google.com.br (Brazil), google.co.jp (Japan). Leave empty to use the default for the selected location.", "default": "" }, "maxWaitSeconds": { "title": "Max wait (seconds)", "minimum": 60, "maximum": 1800, "type": "integer", "description": "Maximum time to wait for search results. Minimum 60, maximum 1800 seconds. Default: 600.", "default": 600 }, "pollIntervalSeconds": { "title": "Poll interval (seconds)", "minimum": 5, "maximum": 60, "type": "integer", "description": "How often to check for results. Minimum 5 seconds. Default: 10.", "default": 10 } } }, "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 } } } } } } } } } } ```