# Google News Scraper & News Intelligence API (`dev00/google-news-scraper-api`) Actor Extract real-time Google News breaking headlines, categorized topic feeds, keyword search, local city news, full coverage clusters, and AI summaries. - **URL**: https://apify.com/dev00/google-news-scraper-api.md - **Developed by:** [dev00](https://apify.com/dev00) (community) - **Categories:** News - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing $3.00 / 1,000 news article / headline 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/actors/running/actors-in-store.md#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. - **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use). - **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`. - **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`. - **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`. - **Any other language** — 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 & News Intelligence API - Breaking Headlines, Topic Feeds, Local City News, Full Coverage & AI Summaries > 🚀 **The #1 Most Complete, Low-Latency Real-Time Google News Intelligence, Breaking Headlines, Categorized Feeds, Local City News, Full Coverage Story Clusters & AI Synthesis Scraper on Apify.** Looking for reliable, low-latency live global news intelligence, breaking headlines, topic-specific media feeds (World, Business, Technology, Science, Health, Sports), localized city coverage, and multi-perspective story clusters without paying thousands of dollars per month for legacy PR clipping services? The **Google News Scraper & News Intelligence API** extracts real-time breaking news stories, topic digests across 8 primary categories, natural language keyword search with precision time-decay filters (`1h`, `1d`, `7d`, `30d`, `1y`), local news for 5,000+ global cities, full coverage multi-publisher story clusters, dedicated news outlet feeds, and Gemini 3.1 High AI news briefings directly from Google News. *** ### 🌟 Institutional Comparison: Why This Actor Outperforms Competitors | Capability | NewsAPI.org | Bing News | MediaStack | 📰 Google News Scraper | | :--- | :---: | :---: | :---: | :---: | | **Real-Time Breaking Latency** | ⚠️ Up to 24h Delay (Free Tier) | ⚠️ 15-min Delay | ⚠️ 30-min Delay | ✅ **Live Real-Time Extraction (~180ms)** | | **Multi-Publisher Story Clusters** | ❌ No | ❌ No | ❌ No | ✅ **Full Coverage Multi-Source Perspectives** | | **Local / Geo-Targeted News** | ⚠️ Country Only | ⚠️ Limited Cities | ⚠️ Country Only | ✅ **City & Metropolitan Level (5,000+ Cities)** | | **Time-Decay Filters (`1h`, `1d`, `7d`)** | ⚠️ Enterprise Only | ⚠️ Basic Date | ⚠️ Basic Date | ✅ **Precision Time Filters (`1h`, `1d`, `7d`, `30d`)** | | **AI News Synthesis & Briefings** | ❌ No | ❌ No | ❌ No | ✅ **Gemini 3.1 High Executive Briefings** | | **Global Editions & Languages** | ⚠️ 30 Countries | ⚠️ 40 Countries | ⚠️ 50 Countries | ✅ **80+ Countries & 40+ Languages** | | **Dedicated Publisher Feeds** | ⚠️ Limited Sources | ⚠️ Domain Search | ⚠️ Limited Sources | ✅ **Any Major Global News Outlet** | | **Pricing Model** | 💸 High Monthly Subscriptions | 💸 Azure Enterprise | 💸 High Monthly Plans | ⚡ **Pay-Per-Event ($0.003 / article)** | *** ### ⚡ Comprehensive Feature & Endpoint Breakdown #### 1. 🚨 Top Breaking News Headlines (`TOP_HEADLINES`) Extract real-time top breaking news stories curated by Google News editorial algorithms across international, national, and regional editions. Filter by country (`US`, `GB`, `FR`, `DE`, `CA`, `AU`, `IN`, `JP`, etc.) and language (`en-US`, `fr`, `es`, `de`, `ar`, `ja`, etc.). #### 2. 📂 Categorized Topic Feeds (`TOPIC`) Instantly pull specialized topic feeds across 8 primary global news categories: - **`TECHNOLOGY`**: Artificial intelligence, enterprise software, semiconductors, mobile devices, cybersecurity, and startups. - **`BUSINESS`**: Financial markets, macroeconomic trends, M\&A, inflation, central banks, and corporate earnings. - **`WORLD`**: Global geopolitical affairs, international diplomacy, summits, and foreign policy. - **`SCIENCE`**: Space exploration, astronomy, climate research, quantum computing, and archaeology. - **`HEALTH`**: Medical breakthroughs, public health policy, pharmaceuticals, nutrition, and clinical trials. - **`SPORTS`**: Global athletics, Premier League, NBA, NFL, Champions League, Formula 1, tennis, and golf. - **`ENTERTAINMENT`**: Hollywood, box office, streaming media, film, television, music, and celebrity culture. - **`NATION` / `US`**: Domestic policy, election coverage, legislative affairs, and judicial rulings. #### 3. 🔍 Precision Keyword & Semantic Search (`SEARCH`) Search across millions of global news stories with natural language keywords and optional time-decay windows: - `when="1h"`: Stories published in the last hour (breaking developments). - `when="1d"`: Stories published in the last 24 hours. - `when="7d"`: Past week news recap. - `when="30d"`: Past month analysis. - `when="1y"`: Year-long historical search. #### 4. 📍 Geo-Targeted & Local City News (`LOCAL_NEWS`) Extract localized news feeds for over 5,000 global cities, metropolitan areas, and regions (e.g., *Paris, London, New York, Tokyo, Berlin, Sydney, Casablanca, Toronto, Chicago, Los Angeles, Dubai, Singapore*). #### 5. 🌐 Full Coverage Story Clusters (`FULL_COVERAGE`) Compare how different international news organizations report on the same breaking story. Returns the primary lead article alongside a cluster of reporting perspectives from major global publishers (*The New York Times, BBC News, Reuters, Associated Press, Bloomberg, The Guardian, CNN, The Wall Street Journal*). #### 6. 📰 Dedicated Publisher & Source Feeds (`PUBLISHER`) Filter and track all news stories published by a specific news outlet, domain, or media organization. #### 7. 🤖 Gemini 3.1 High AI News Intelligence & Synthesis (`AI_SUMMARY`) Generate instant AI-synthesized executive briefings for any query or topic, complete with core takeaways, multi-source narrative consensus, sentiment analysis scores, and stakeholder impact assessments. *** ### 📋 Comprehensive Input Parameters Matrix | Parameter | Type | Required | Default | Options / Valid Values | Description | | :--- | :---: | :---: | :---: | :--- | :--- | | `mode` | `string` | No | `TOP_HEADLINES` | `TOP_HEADLINES`, `TOPIC`, `SEARCH`, `LOCAL_NEWS`, `FULL_COVERAGE`, `PUBLISHER`, `AI_SUMMARY` | **Primary Operation Mode**: Determines which Google News extraction pipeline to use. | | `query` | `string` | Conditional | — | Any search keyword or phrase | Required for `SEARCH`, `FULL_COVERAGE`, `AI_SUMMARY` modes. | | `topic` | `string` | Conditional | `TECHNOLOGY` | `WORLD`, `BUSINESS`, `TECHNOLOGY`, `ENTERTAINMENT`, `SPORTS`, `SCIENCE`, `HEALTH`, `NATION` | Category topic for `TOPIC` mode. | | `location` | `string` | Conditional | — | City name (e.g. `Paris`, `Tokyo`, `New York`) | Required for `LOCAL_NEWS` mode. | | `publisher` | `string` | Conditional | — | Publisher name or domain (e.g. `reuters.com`) | Required for `PUBLISHER` mode. | | `country` | `string` | No | `US` | Two-letter ISO code (`US`, `GB`, `FR`, `DE`, `CA`, `AU`, etc.) | Country edition for localized results. | | `language` | `string` | No | `en-US` | BCP-47 locale code (`en-US`, `fr`, `es-419`, `de`, `ar`, `ja`, etc.) | Language for response synthesis. | | `when` | `string` | No | — | `1h`, `1d`, `7d`, `30d`, `1y` | Time-decay filter for `SEARCH` mode. | | `limit` | `integer` | No | `30` | 1–100 | Maximum number of articles to extract per request. | *** ### 📥 Input Examples #### Example 1: Top Breaking Headlines ```json { "mode": "TOP_HEADLINES", "country": "US", "limit": 30 } ``` #### Example 2: AI News Executive Briefing & Synthesis ```json { "mode": "AI_SUMMARY", "query": "Quantum Computing & Cybersecurity developments" } ``` #### Example 3: Keyword Search with 24-Hour Time Filter ```json { "mode": "SEARCH", "query": "Artificial Intelligence Nvidia", "when": "1d", "limit": 25 } ``` #### Example 4: Local City News (Paris) ```json { "mode": "LOCAL_NEWS", "location": "Paris", "limit": 20 } ``` #### Example 5: Technology Category News ```json { "mode": "TOPIC", "topic": "TECHNOLOGY", "country": "US", "limit": 30 } ``` #### Example 6: Publisher-Specific Feed ```json { "mode": "PUBLISHER", "publisher": "reuters.com", "limit": 20 } ``` #### Example 7: Full Coverage Multi-Publisher Story Cluster ```json { "mode": "FULL_COVERAGE", "query": "Federal Reserve interest rate decision", "limit": 15 } ``` *** ### 📤 Exhaustive JSON Output Schema Examples #### 1. Top Headlines / Search Result Article: ```json { "mode": "SEARCH_RESULT", "search_query": "Artificial Intelligence Nvidia", "title": "Nvidia adds more than $400 billion in value after blowout earnings boost AI confidence", "link": "https://news.google.com/rss/articles/CBMif0FVX3lxTE5SRU5FVmdMYXVFMUdxQWx3andleHVXazFfdlJqTS1KREsxSklsMWpQWDV4aFJYcmFMcDRFQV9ub0dfd3JZVFVPMmNsN3B2SkRpblZNRkhEUG9jNXdKR1RqejBpa2dzYnZKMXZwN3dsSGZEajlyY0xxYVp4V0lybkU", "article_id": "CBMif0FVX3lxTE5SRU5FVmdMYXVFMUdxQWx3andleHVXazFfdlJqTS1KREsxSklsMWpQWDV4aFJYcmFMcDRFQV9ub0dfd3JZVFVPMmNsN3B2SkRpblZNRkhEUG9jNXdKR1RqejBpa2dzYnZKMXZwN3dsSGZEajlyY0xxYVp4V0lybkU", "publisher": { "name": "Bloomberg", "domain": "bloomberg.com", "url": "https://www.bloomberg.com" }, "published_at": "2026-08-27T17:48:00.000Z", "published_at_human": "Thu, 27 Aug 2026 17:48:00 GMT", "time_ago": "2 hours ago", "has_full_coverage": true, "related_coverage_count": 4, "related_coverage": [ { "title": "Nvidia earnings show AI boom shows no signs of slowing down", "url": "https://news.google.com/rss/articles/CBMilAFBVV...", "publisher": "Reuters" }, { "title": "Tech stocks rally as semiconductor demand hits record highs", "url": "https://news.google.com/rss/articles/CBMirwFBVV...", "publisher": "The Wall Street Journal" } ], "google_news_url": "https://news.google.com/rss/articles/CBMif0FV..." } ``` #### 2. Gemini 3.1 High AI News Synthesis (`AI_SUMMARY`): ```json { "mode": "AI_SUMMARY_RESULT", "success": true, "query_or_topic": "Artificial Intelligence developments", "sources_analyzed_count": 10, "ai_synthesis": { "executive_brief": "Comprehensive intelligence briefing for 'Artificial Intelligence developments' synthesized from 10 breaking news publications. Recent reporting indicates accelerating momentum across enterprise compute infrastructure, major AI model releases, and emerging cross-border regulatory frameworks.", "key_takeaways": [ "Major breaking developments reported by top sources including Bloomberg, Reuters, and The Wall Street Journal.", "Cross-source narrative consensus centers on enterprise hardware scaling, datacenter efficiency, and software monetization.", "Sentiment remains constructive with active institutional focus on long-term implications and strategic scaling." ], "sentiment_analysis": { "overall": "POSITIVE / CONSTRUCTIVE", "score": 0.82, "bullish_indicators": [ "Accelerating enterprise AI adoption", "Record hardware demand" ], "risk_indicators": [ "Power grid infrastructure constraints", "Regional export compliance" ] }, "stakeholder_impact": "High strategic relevance for enterprise leadership, quantitative analysts, and institutional decision-makers." } } ``` *** ### 💻 Multi-Language Code Integration Suite #### Python (`apify-client`) — Real-Time News Search: ```python from apify_client import ApifyClient client = ApifyClient("YOUR_APIFY_TOKEN") run_input = { "mode": "SEARCH", "query": "Artificial Intelligence Nvidia", "when": "1d", "country": "US", "limit": 20 } run = client.actor("dev00/google-news-scraper-api").call(run_input=run_input) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(f"[{item['publisher']['name']}] {item['title']} ({item['time_ago']})") ``` #### JavaScript / Node.js (`apify-client`) — AI Executive Briefing: ```javascript import { ApifyClient } from 'apify-client'; const client = new ApifyClient({ token: 'YOUR_APIFY_TOKEN', }); const input = { mode: "AI_SUMMARY", query: "Quantum Computing & Cybersecurity developments" }; const run = await client.actor("dev00/google-news-scraper-api").call(input); const { items } = await client.dataset(run.defaultDatasetId).listItems(); console.log("Executive Briefing:", items[0].ai_synthesis.executive_brief); console.log("Sentiment Score:", items[0].ai_synthesis.sentiment_analysis.score); ``` #### cURL — Local City News (Paris): ```bash curl -X POST "https://api.apify.com/v2/acts/dev00~google-news-scraper-api/runs?token=YOUR_APIFY_TOKEN" \ -H "Content-Type: application/json" \ -d '{"mode": "LOCAL_NEWS", "location": "Paris", "limit": 15}' ``` *** ### 🎯 High-Growth Industry Use Cases 1. **AI Agents & Automated Newsletter Platforms**: Feed live top breaking headlines, topic digests, and AI syntheses into automated Substack or email newsletters. 2. **PR & Brand Reputation Monitoring**: Track brand mentions, product launches, executive statements, and competitor news with real-time alerts. 3. **Financial & Quantitative Sentiment Modeling**: Ingest breaking business and tech news to analyze real-time market sentiment and event-driven price movements. 4. **Local News Portals & City Guides**: Deliver live local city news to community apps, real estate portals, and travel guides. 5. **Academic & Media Research**: Extract multi-perspective story clusters to study media bias, journalistic framing, and cross-source reporting differences. *** ### ❓ Frequently Asked Questions (FAQ) ##### Q: How frequently is the news updated? All endpoints extract live data directly from Google News in real-time with sub-200ms latency and zero stale caching. ##### Q: Can I search news in languages other than English? Yes! Simply pass the `language` and `country` parameters (e.g. `language="fr"` and `country="FR"` for French news, or `language="es"` and `country="MX"` for Spanish news). ##### Q: How does the time-decay filter work? You can filter results using the `when` parameter (`1h` for past hour, `1d` for past day, `7d` for past week, `30d` for past month, `1y` for past year). ##### Q: What is Full Coverage mode? Full Coverage extracts multi-publisher story clusters, showing how different international news organizations report on the same breaking story from varying perspectives. ##### Q: How does the AI Summary work? The AI Summary mode uses Gemini 3.1 High to synthesize executive intelligence briefings from multiple news sources, delivering core takeaways, sentiment scores, and stakeholder impact assessments. *** ### 💰 Pay-Per-Event (PPR) Pricing This Actor operates under the transparent **Pay-Per-Event** monetization model: - **Price**: **$0.003 per extracted news article / record** ($3.00 per 1,000 articles). - **No Monthly Minimums**: Only pay for the exact volume of news records you extract. - **Includes AI Summaries**: Zero additional charge for Gemini 3.1 AI synthesis queries. *** ### 🏷️ Keywords & SEO Tags `google news api, google news scraper, breaking news api, live news feed, real-time news scraper, top headlines api, business news api, tech news api, world news scraper, local news api, keyword news search, full coverage story clusters, publisher news feed, ai news summarizer, news sentiment api, newsapi alternative, mediastack alternative, bing news api alternative, rss news scraper, rapidapi news api, automated media monitoring, pr clipping api, press release scraper, city news api, financial news api, artificial intelligence news feed, event driven trading news, media aggregator api, google news actor, apify news scraper` # Actor input Schema ## `mode` (type: `string`): Select the news intelligence operation to execute. ## `query` (type: `string`): Keywords, topic, or company for Search / AI Summary / Full Coverage mode (e.g. 'Artificial Intelligence Nvidia', 'SpaceX Starship', 'Federal Reserve'). ## `topic` (type: `string`): Select news topic category. ## `location` (type: `string`): Target city, metropolitan area, or state (e.g. 'Paris', 'London', 'New York', 'Tokyo', 'Berlin'). ## `publisher` (type: `string`): News publisher name or domain (e.g. 'The New York Times', 'Reuters', 'BBC News', 'Bloomberg', 'TechCrunch'). ## `when` (type: `string`): Filter stories published within a specific time window. ## `country` (type: `string`): Two-letter country code (e.g. 'US', 'GB', 'FR', 'DE', 'CA', 'AU', 'IN', 'JP', 'MA'). ## `language` (type: `string`): Language code (e.g. 'en-US', 'fr', 'es-419', 'de', 'ar', 'ja', 'zh-CN'). ## `limit` (type: `integer`): Maximum number of news articles to extract (1–100). ## Actor input object example ```json { "mode": "TOP_HEADLINES", "query": "Artificial Intelligence Nvidia", "topic": "TECHNOLOGY", "location": "London", "publisher": "The New York Times", "when": "all", "country": "US", "language": "en-US", "limit": 30 } ``` # Actor output Schema ## `results` (type: `string`): Direct link to the dataset items containing extracted news records ## `keyValueStoreResult` (type: `string`): Direct link to the key-value store output record # 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 = { "query": "Artificial Intelligence Nvidia", "location": "London", "publisher": "The New York Times", "country": "US", "language": "en-US" }; // Run the Actor and wait for it to finish const run = await client.actor("dev00/google-news-scraper-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 = { "query": "Artificial Intelligence Nvidia", "location": "London", "publisher": "The New York Times", "country": "US", "language": "en-US", } # Run the Actor and wait for it to finish run = client.actor("dev00/google-news-scraper-api").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}") for item in client.dataset(run.default_dataset_id).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "query": "Artificial Intelligence Nvidia", "location": "London", "publisher": "The New York Times", "country": "US", "language": "en-US" }' | apify call dev00/google-news-scraper-api --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "type": "http", "url": "https://mcp.apify.com/?tools=fetch-actor-details,dev00/google-news-scraper-api" } } } ``` The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer ` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations). ## OpenAPI specification Download the OpenAPI definition: https://api.apify.com/v2/actors/Ob3aFCouVBjk5Nsao/builds/kRxDKOiaMv2gzB2vv/openapi.json