# Google News Scraper (`parseforge/google-news-scraper`) Actor Monitor the news automatically with our Google News scraper. Track articles by keyword or topic with flexible date filtering and multi language support. Access structured data including headlines, publishers, links, and more. Built for teams that need reliable news insights without manual work. - **URL**: https://apify.com/parseforge/google-news-scraper.md - **Developed by:** [ParseForge](https://apify.com/parseforge) (community) - **Categories:** News, Automation, Developer tools - **Stats:** 12 total users, 5 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 ![ParseForge Banner](https://github.com/ParseForge/apify-assets/blob/ad35ccc13ddd068b9d6cba33f323962e39aed5b2/banner.jpg?raw=true) ## πŸ“° Google News Scraper > πŸ•’ **Last updated:** 2026-05-05 Automate your news monitoring with this Google News scraper that collects articles by keyword search, topic browsing, or custom topic feeds. Perfect for researchers, marketers, analysts, and PR professionals who need structured news data for competitor tracking, trend analysis, market research, or news monitoring without manual work. Supports 50+ languages and regions, flexible date filtering, and enriched article details like author, category, keywords, and article images. > **The Google News Scraper collects news articles from Google News, up to 1,000,000 per run, with automatic day-by-day pagination for large datasets and enriched article details including author, category, and keywords.** ### ✨ What Does It Do - πŸ“ **Article Title** - The headline of the news article for quick identification and cataloging - πŸ–ΌοΈ **Article Image** - Preview image from the article or RSS feed for visual content presentation - πŸ“Š **Publication Details** - Published date, modification date, and article links for complete temporal context - πŸ‘€ **Author and Source** - Author name, news source, and source URL for credibility tracking and attribution - 🎯 **Categories and Keywords** - Article categories and extracted keywords for topic classification and research filtering - πŸ”— **Multiple Links** - Article URL, RSS link, and source URL for complete reference documentation and verification ### πŸ”§ Input - **Search Query** - Keyword or phrase to search Google News. Supports advanced operators like "site:bbc.com", "intitle:AI", and exact match with quotes. Leave blank if using topics instead - **Max Items** - Maximum number of articles to collect. Free users limited to 100, paid users can request up to 1,000,000. When requesting more than 100 articles with search queries, results are fetched day by day automatically - **Language and Region** - Choose from 50+ language and region combinations to target specific markets like English (US), Spanish (Mexico), or French (Canada) - **Date From** - Start date for filtering articles in YYYY-MM-DD format. Only applies when using search queries - **Date To** - End date for filtering articles in YYYY-MM-DD format. Only applies when using search queries - **Open-Ended Date Range** - Relative date range for recent articles (e.g., "1h" for last hour, "7d" for last 7 days, "1y" for last year). Cannot be used together with Date From and Date To - **Standard Topics** - Select one or more Google News topic sections like WORLD, BUSINESS, TECHNOLOGY, or SPORTS. Can be combined with search queries - **Hashed Topic IDs** - Custom Google News topic IDs for specialized topics. Find these in Google News URLs when browsing specific topics - **Fetch Article Details** - Enable to decode article URLs and collect additional data like preview image, description, author, category, and modification date. Slower but provides richer data - **Proxy Configuration** - Optional proxy settings for when fetchArticleDetails is enabled and target sites are geo-restricted Example configuration: ```json { "searchQuery": "artificial intelligence", "maxItems": 50, "language": "en:US", "dateFrom": "2024-01-01", "dateTo": "2024-12-31", "fetchArticleDetails": true } ```` ### πŸ“Š Output Each article includes up to 15 data fields. Download as JSON, CSV, or Excel. | πŸ–ΌοΈ Article Image | πŸ“ Article Title | πŸ“Š Published Date | |---|---|---| | πŸ‘€ Author Name | πŸ“„ Source Name | πŸ”— Source URL | | πŸ“‹ Description | 🎯 Category | 🏷️ Keywords | | πŸ”— Article URL | πŸ”— RSS Link | πŸ†” GUID | | πŸ“… Modified Date | ⏱️ Scraped At | ⚠️ Error Messages | ### πŸ’Ž Why Choose the Google News Scraper? | Feature | Our Actor | Similar Tools | |---|---|---| | Multi-language support (50+ languages) | βœ”οΈ | ❌ | | Custom topic IDs support | βœ”οΈ | ❌ | | Automatic day-by-day pagination for large datasets | βœ”οΈ | ❌ | | Article details enrichment (author, category, keywords) | βœ”οΈ | Partial | | Advanced search operators (site:, intitle:, exact match) | βœ”οΈ | ❌ | | Flexible date range filtering with open-ended ranges | βœ”οΈ | Partial | | Proxy support for geo-restricted sites | βœ”οΈ | Partial | | Up to 1,000,000 articles per run for paid users | βœ”οΈ | ❌ | | Real article URLs (decodes Google redirect links) | βœ”οΈ | ❌ | | Automatic retry logic on rate limits | βœ”οΈ | ❌ | | Fast RSS-based collection without browsers | βœ”οΈ | ❌ | | Scheduled daily or weekly collection support | βœ”οΈ | ❌ | ### πŸ“‹ How to Use No technical skills required. Follow these simple steps: 1. **Sign Up**: [Create a free account with $5 credit](https://console.apify.com/sign-up?fpr=vmoqkp) 2. **Find the Tool**: Search for "Google News Scraper" in the Apify Store and configure your input 3. **Run It**: Click "Start" and watch your results appear That's it. No coding, no setup, no complicated configuration. Now you can export your data in CSV, Excel, or JSON format. ### 🎯 Business Use Cases - πŸ“Š **Market Researchers** - Monitor competitor announcements across global news sources to identify market shifts and product launches before your competitors do - πŸ’Ό **PR Professionals** - Track brand mentions and media coverage across multiple languages and regions to measure PR campaign effectiveness and respond to crises quickly - πŸ“£ **Marketing Analysts** - Collect industry trend articles and keyword-specific news to identify emerging opportunities and craft data-driven content strategies - πŸ”¬ **Competitive Intelligence Teams** - Analyze competitor news patterns over time to detect strategic pivots, partnerships, and growth signals for business planning - πŸ“ˆ **Financial Analysts** - Monitor company announcements and industry news by date range to build comprehensive datasets for fundamental analysis and market insights *** ### ✨ Why choose this Actor | | Capability | |---|---| | 🎯 | **Built for the job.** Scoped specifically to this data source so you skip the parser engineering entirely. | | πŸ”– | **Structured output.** Clean, typed fields ready for analysis, dashboards, or downstream pipelines. | | ⚑ | **Fast.** Optimized request patterns return results in seconds, not minutes. | | πŸ” | **Always fresh.** Every run pulls live data, so the dataset reflects the source as of run time. | | 🌐 | **No infra to manage.** Apify handles proxies, retries, scaling, scheduling, and storage. | | πŸ›‘οΈ | **Reliable.** Battle-tested across many runs and edge cases, with graceful error handling. | | 🚫 | **No code required.** Configure in the UI, run from CLI, schedule via cron, or call from any language with the Apify SDK. | > πŸ“Š Production-grade structured data without the engineering overhead of building and maintaining your own scraper. *** ### πŸ“ˆ How it compares to alternatives | Approach | Cost | Coverage | Refresh | Filters | Setup | |---|---|---|---|---|---| | **⭐ Google News Scraper** *(this Actor)* | $5 free credit, then pay-per-use | Full source coverage | **Live per run** | Source-native filters supported | ⚑ 2 min | | Build your own scraper | Engineering hours | Full once built | Whenever you maintain it | Custom code | 🐒 Days to weeks | | Paid managed APIs | $$$ monthly | Vendor-defined | Live | Vendor-defined | ⏳ Hours | | Third-party data dumps | Varies | Subset, often stale | Periodic | None | πŸ•’ Variable | Pick this Actor when you want broad coverage, server-side filtering, and no pipeline maintenance. *** ### πŸš€ How to use 1. πŸ“ **Sign up.** [Create a free account with $5 credit](https://console.apify.com/sign-up?fpr=vmoqkp) (takes 2 minutes). 2. 🌐 **Open the Actor.** Go to the Google News Scraper page on the Apify Store. 3. 🎯 **Set input.** Configure the input fields in the form (or paste a JSON), then set `maxItems`. 4. πŸš€ **Run it.** Click **Start** and let the Actor collect your data. 5. πŸ“₯ **Download.** Grab your results in the **Dataset** tab as CSV, Excel, JSON, or XML. > ⏱️ Total time from signup to downloaded dataset: **3-5 minutes.** No coding required. *** ### πŸ’Ό Business use cases
#### πŸ“Š Data & Analytics - Build trend reports and dashboards from live source data - Feed BI tools, warehouses, and ML pipelines with structured records - Run periodic snapshots to track changes over time - Compare segments, regions, or categories with consistent fields #### 🏒 Operations & Strategy - Monitor competitor moves, pricing, and inventory shifts - Build internal directories and lookup tools backed by current data - Power workflows that depend on fresh source records - Cut manual data-gathering time from hours to minutes
#### 🎯 Marketing & Growth - Identify market opportunities and trending topics - Research target audiences and customer personas at scale - Power lead-generation pipelines with verified records - Track sentiment, reviews, or social signals over time #### πŸ› οΈ Engineering & Product - Prototype features that need real-world data without owning a crawler - Replace fragile in-house scrapers with a managed Actor - Wire datasets into your apps via the Apify API or webhooks - Skip the proxy, retry, and parsing maintenance entirely
*** ### 🌟 Beyond business use cases Data like this powers more than commercial workflows. The same structured records support research, education, civic projects, and personal initiatives.
#### πŸŽ“ Research and academia - Empirical datasets for papers, thesis work, and coursework - Longitudinal studies tracking changes across snapshots - Reproducible research with cited, versioned data pulls - Classroom exercises on data analysis and ethical scraping #### 🎨 Personal and creative - Side projects, portfolio demos, and indie app launches - Data visualizations, dashboards, and infographics - Content research for bloggers, YouTubers, and podcasters - Hobbyist collections and personal trackers
#### 🀝 Non-profit and civic - Transparency reporting and accountability projects - Advocacy campaigns backed by public-interest data - Community-run databases for local issues - Investigative journalism on public records #### πŸ§ͺ Experimentation - Prototype AI and machine-learning pipelines with real data - Validate product-market hypotheses before engineering spend - Train small domain-specific models on niche corpora - Test dashboard concepts with live input
### πŸ€– Ask an AI assistant about this scraper Open a ready-to-send prompt about this ParseForge actor in the AI of your choice: - πŸ’¬ [**ChatGPT**](https://chat.openai.com/?q=How%20do%20I%20use%20the%20GOOGLE%20NEWS%20SCRAPER%20Scraper%20by%20ParseForge%20on%20Apify%3F%20Show%20me%20input%20examples%2C%20output%20fields%2C%20common%20use%20cases%2C%20and%20how%20to%20integrate%20it%20into%20a%20workflow.) - 🧠 [**Claude**](https://claude.ai/new?q=How%20do%20I%20use%20the%20GOOGLE%20NEWS%20SCRAPER%20Scraper%20by%20ParseForge%20on%20Apify%3F%20Show%20me%20input%20examples%2C%20output%20fields%2C%20common%20use%20cases%2C%20and%20how%20to%20integrate%20it%20into%20a%20workflow.) - πŸ” [**Perplexity**](https://perplexity.ai/search?q=How%20do%20I%20use%20the%20GOOGLE%20NEWS%20SCRAPER%20Scraper%20by%20ParseForge%20on%20Apify%3F%20Show%20me%20input%20examples%2C%20output%20fields%2C%20common%20use%20cases%2C%20and%20how%20to%20integrate%20it%20into%20a%20workflow.) - πŸ…’ [**Copilot**](https://copilot.microsoft.com/?q=How%20do%20I%20use%20the%20GOOGLE%20NEWS%20SCRAPER%20Scraper%20by%20ParseForge%20on%20Apify%3F%20Show%20me%20input%20examples%2C%20output%20fields%2C%20common%20use%20cases%2C%20and%20how%20to%20integrate%20it%20into%20a%20workflow.) *** ### ❓ Frequently Asked Questions **πŸ” How does it work?** The scraper uses Google News RSS feeds and advanced filtering to collect articles by search query, topic category, or custom topic ID. When you enable article details, it decodes Google's redirect URLs and fetches additional metadata from the original article pages. **πŸ“Š How accurate is the data?** Article titles, publication dates, and sources come directly from Google News RSS feeds. When article details are enabled, additional fields like author, category, and keywords are extracted from the original article pages using meta tags and JSON-LD structured data. **πŸ“… Can I schedule this to run automatically?** Yes, you can set up recurring tasks on Apify to collect articles daily, weekly, or monthly. Use Make or Zapier integrations to automate the workflow. **βš–οΈ Is scraping Google News allowed?** The scraper uses Google News' public RSS feeds, which are designed for data access. However, it's your responsibility to comply with Google's Terms of Service and local laws. The data collected is public information. **πŸ›‘οΈ Will Google block me?** Google News is designed to serve RSS feeds to bots, so standard requests work. However, when fetchArticleDetails is enabled and you're accessing individual article pages, enabling a residential proxy is recommended to avoid blocking by target websites. **⚑ How long does a run take?** Without article details, a run typically takes 5-30 seconds depending on the number of articles. With article details enabled, add 2-5 seconds per article for page fetching. A run of 50 articles with details takes roughly 2-3 minutes. **⚠️ Are there any limits?** Free users can collect up to 100 results per run. Paid users can collect up to 1,000,000 results per run. ### πŸ”— Integrate Google News Scraper with any app - [Make](https://docs.apify.com/platform/integrations/make) - Automate workflows - [Zapier](https://docs.apify.com/platform/integrations/zapier) - Connect 5000+ apps - [GitHub](https://docs.apify.com/platform/integrations/github) - Version control integration - [Slack](https://docs.apify.com/platform/integrations/slack) - Get notifications - [Airbyte](https://docs.apify.com/platform/integrations/airbyte) - Data pipelines - [Google Drive](https://docs.apify.com/platform/integrations/drive) - Export to spreadsheets ### πŸ”Œ Integrate with any app Google News Scraper connects to any cloud service via [Apify integrations](https://apify.com/integrations): - [**Make**](https://docs.apify.com/platform/integrations/make) - Automate multi-step workflows - [**Zapier**](https://docs.apify.com/platform/integrations/zapier) - Connect with 5,000+ apps - [**Slack**](https://docs.apify.com/platform/integrations/slack) - Get run notifications in your channels - [**Airbyte**](https://docs.apify.com/platform/integrations/airbyte) - Pipe results into your warehouse - [**GitHub**](https://docs.apify.com/platform/integrations/github) - Trigger runs from commits and releases - [**Google Drive**](https://docs.apify.com/platform/integrations/drive) - Export datasets straight to Sheets You can also use webhooks to trigger downstream actions when a run finishes. Push fresh data into your product backend, or alert your team in Slack. *** ### πŸ’‘ More ParseForge Actors - [Houzz Scraper](https://apify.com/parseforge/houzz-scraper) - Collect property listings, prices, and interior design ideas from Houzz - [LiveAuctioneers Scraper](https://apify.com/parseforge/liveauctioneers-scraper) - Extract auction listings, bidding history, and item details from LiveAuctioneers - [Justia Case Law Scraper](https://apify.com/parseforge/justia-case-law-scraper) - Download legal case documents, opinions, and case information from Justia - [NY Business Registry Scraper](https://apify.com/parseforge/apps-scraper) - Collect business registration data and company information from New York official records - [Asc Global Mro Scraper](https://apify.com/parseforge/asc-global-mro-scraper) - Extract aviation maintenance and repair organization data from ASC Global Browse our complete collection of [data extraction tools](https://apify.com/parseforge) for more. ### πŸš€ Ready to Start? [Create a free account with $5 credit](https://console.apify.com/sign-up?fpr=vmoqkp) and collect your first 100 articles for free. No coding, no setup. ### πŸ†˜ Need Help? - Check the FAQ section above for common questions - Visit the [Apify support page](https://docs.apify.com) for documentation and tutorials - Contact us to request a new scraper, propose a custom project, or report an issue at [Tally contact form](https://tally.so/r/BzdKgA) ### ⚠️ Disclaimer > This Actor is an independent tool and is not affiliated with, endorsed by, or sponsored by Google News or any of its subsidiaries. All trademarks mentioned are the property of their respective owners. *** ### πŸ”— Recommended Actors - [**πŸ” Google Search Scraper**](https://apify.com/parseforge/google-search-scraper) - Multi-engine SERP results with country and language targeting - [**πŸ—ΊοΈ Nominatim OSM Scraper**](https://apify.com/parseforge/nominatim-osm-scraper) - Geocode addresses via OpenStreetMap - [**πŸ“Š Indexmundi Scraper**](https://apify.com/parseforge/indexmundi-scraper) - Global demographic and economic indicators - [**πŸ“° RAG Web Browser**](https://apify.com/parseforge/rag-web-browser) - Crawl and extract clean text from any URL for AI retrieval - [**🌐 Website Content Crawler**](https://apify.com/parseforge/website-content-crawler) - Crawl entire sites and export structured content > πŸ’‘ **Pro Tip:** browse the complete [ParseForge collection](https://apify.com/parseforge) for more reference-data scrapers. # Actor input Schema ## `searchQuery` (type: `string`): Keyword or phrase to search Google News. Supports advanced operators like "site:bbc.com", "intitle:AI", exact match with quotes. Cannot be used together with Topics. ## `maxItems` (type: `integer`): Free users: Limited to 100. Paid users: Optional, max 1,000,000. When requesting more than 100 with a search query, results are fetched day by day automatically. ## `language` (type: `string`): Select the language and region for Google News results. ## `dateFrom` (type: `string`): Start date for filtering articles (YYYY-MM-DD). Only applies to search query mode. ## `dateTo` (type: `string`): End date for filtering articles (YYYY-MM-DD). Only applies to search query mode. ## `openEndedDateRange` (type: `string`): Relative date range for recent articles. Cannot be used together with Date From/To. Examples: 1h (last hour), 24h (last 24 hours), 7d (last 7 days), 1y (last year). ## `topics` (type: `array`): Select one or more Google News topic sections. Each topic is fetched separately and results are combined. Can be used together with Search Query. ## `topicsHashed` (type: `array`): Custom Google News topic IDs. Find these in Google News URLs when browsing a specific topic. Supports topic sections by using the format: TOPIC\_ID/sections/SECTION\_ID ## `fetchArticleDetails` (type: `boolean`): When enabled, each article URL is decoded to the real destination and additional data is collected: preview image, description, author, category, modification date, and keywords. Slower but provides much richer data. ## `proxyConfiguration` (type: `object`): Optional proxy settings. Useful when fetchArticleDetails is enabled and target sites are geo-restricted. ## Actor input object example ```json { "searchQuery": "web scraping", "maxItems": 10, "language": "en:US", "fetchArticleDetails": true } ``` # Actor output Schema ## `overview` (type: `string`): Overview table showing key fields for each article # 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 = { "searchQuery": "web scraping", "maxItems": 10, "fetchArticleDetails": true }; // Run the Actor and wait for it to finish const run = await client.actor("parseforge/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 = { "searchQuery": "web scraping", "maxItems": 10, "fetchArticleDetails": True, } # Run the Actor and wait for it to finish run = client.actor("parseforge/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 '{ "searchQuery": "web scraping", "maxItems": 10, "fetchArticleDetails": true }' | apify call parseforge/google-news-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=parseforge/google-news-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Google News Scraper", "description": "Monitor the news automatically with our Google News scraper. Track articles by keyword or topic with flexible date filtering and multi language support. Access structured data including headlines, publishers, links, and more. Built for teams that need reliable news insights without manual work.", "version": "1.0", "x-build-id": "5dANNRelQKFM9U8Sp" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/parseforge~google-news-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-parseforge-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/parseforge~google-news-scraper/runs": { "post": { "operationId": "runs-sync-parseforge-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/parseforge~google-news-scraper/run-sync": { "post": { "operationId": "run-sync-parseforge-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", "properties": { "searchQuery": { "title": "Search Query", "type": "string", "description": "Keyword or phrase to search Google News. Supports advanced operators like \"site:bbc.com\", \"intitle:AI\", exact match with quotes. Cannot be used together with Topics." }, "maxItems": { "title": "Max Items", "minimum": 1, "maximum": 1000000, "type": "integer", "description": "Free users: Limited to 100. Paid users: Optional, max 1,000,000. When requesting more than 100 with a search query, results are fetched day by day automatically." }, "language": { "title": "Language and Region", "enum": [ "en:US", "en:GB", "en:AU", "en:CA", "en:IN", "en:IE", "en:NZ", "en:SG", "en:ZA", "en:PH", "en:MY", "en:NG", "en:GH", "en:KE", "en:PK", "es:ES", "es:MX", "es:AR", "es:CL", "es:CO", "es:PE", "es:VE", "es:CU", "es:US", "fr:FR", "fr:CA", "fr:BE", "fr:CH", "fr:SN", "fr:MA", "de:DE", "de:AT", "de:CH", "pt:BR", "pt:PT", "it:IT", "nl:NL", "nl:BE", "ja:JP", "ko:KR", "zh-Hans:CN", "zh-Hant:TW", "zh-Hant:HK", "ru:RU", "ru:UA", "ar:SA", "ar:EG", "ar:AE", "ar:LB", "hi:IN", "ta:IN", "te:IN", "ml:IN", "bn:IN", "mr:IN", "kn:IN", "gu:IN", "th:TH", "vi:VN", "id:ID", "ms:MY", "tl:PH", "tr:TR", "pl:PL", "uk:UA", "ro:RO", "el:GR", "hu:HU", "cs:CZ", "sv:SE", "no:NO", "da:DK", "fi:FI", "sk:SK", "bg:BG", "sr:RS", "hr:HR", "lt:LT", "lv:LV", "et:EE", "sl:SI", "he:IL" ], "type": "string", "description": "Select the language and region for Google News results.", "default": "en:US" }, "dateFrom": { "title": "Date From", "type": "string", "description": "Start date for filtering articles (YYYY-MM-DD). Only applies to search query mode." }, "dateTo": { "title": "Date To", "type": "string", "description": "End date for filtering articles (YYYY-MM-DD). Only applies to search query mode." }, "openEndedDateRange": { "title": "Open-Ended Date Range", "type": "string", "description": "Relative date range for recent articles. Cannot be used together with Date From/To. Examples: 1h (last hour), 24h (last 24 hours), 7d (last 7 days), 1y (last year)." }, "topics": { "title": "Standard Topics", "type": "array", "description": "Select one or more Google News topic sections. Each topic is fetched separately and results are combined. Can be used together with Search Query.", "items": { "type": "string", "enum": [ "WORLD", "NATION", "BUSINESS", "TECHNOLOGY", "ENTERTAINMENT", "SPORTS", "SCIENCE", "HEALTH" ] } }, "topicsHashed": { "title": "Hashed Topic IDs", "type": "array", "description": "Custom Google News topic IDs. Find these in Google News URLs when browsing a specific topic. Supports topic sections by using the format: TOPIC_ID/sections/SECTION_ID", "items": { "type": "string" } }, "fetchArticleDetails": { "title": "Fetch Article Details", "type": "boolean", "description": "When enabled, each article URL is decoded to the real destination and additional data is collected: preview image, description, author, category, modification date, and keywords. Slower but provides much richer data.", "default": false }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Optional proxy settings. Useful when fetchArticleDetails is enabled and target sites are geo-restricted." } } }, "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 } } } } } } } } } } ```