📰 Google News Search API

The most powerful, reliable, and feature-rich Google News search API for Apify

This Google News API turns any keyword into structured Google News data: article titles, sources, links, snippets, and publication dates, returned as clean JSON. Use it for news monitoring, market research, and Google News scraping at scale, or wire it into an AI agent for real-time headlines. No Google Cloud key, no quotas, and no browser to babysit.

Python Quick Start Example

A complete Python example using the Apify client is available on GitHub:

github.com/johnisanerd/Apify-Google-News-Scraper

Clone the repo, run uv sync, add your API key, and you are scraping Google News in minutes.

---

🤖 AI Agent & MCP Integration

This actor is available as an MCP (Model Context Protocol) tool, making it instantly discoverable and runnable by AI assistants - no custom code required.

Claude Code & Claude Cowork

Claude Code and Claude Cowork both offer a free trial, so you can connect the Apify MCP server and start pulling Google News in a few minutes.

Add the Apify MCP server to your Claude configuration so Claude can discover and call this actor directly.

~/.claude/claude_desktop_config.json (or your Claude MCP settings):

{
  "mcpServers": {
    "apify": {
      "command": "npx",
      "args": ["-y", "@apify/actors-mcp-server"],
      "env": {
        "APIFY_TOKEN": "your_apify_token_here"
      }
    }
  }
}

Once connected, just prompt Claude: "Search Google News for the latest AI regulation headlines" - Claude will find and invoke this actor automatically via MCP. In a Claude Cowork session (free trial available), the actor shows up as a named tool (johnvc/GoogleNewsAPI) and can be called repeatedly across turns without re-discovery.

OpenAI ChatGPT

Use the Apify REST API to integrate with ChatGPT custom GPT actions or function calling:

curl -X POST \
  "https://api.apify.com/v2/acts/johnvc~GoogleNewsAPI/runs?token=YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"q": "AI news", "max_pages": 1}'

For custom GPTs, import the Apify OpenAPI spec as a custom action - this gives ChatGPT direct access to run, monitor, and retrieve results from any actor including this one.

📖 Full MCP setup guide: https://docs.apify.com/platform/integrations/mcp

---

💡 What is Google News Search API?

A Google News Search API is a smart automation tool that helps you extract news articles, headlines, sources, snippets, and publication dates from Google News - all in structured data formats like JSON, CSV, or Excel.

This API lets you turn Google News' vast database into a valuable dataset for news monitoring, market research, competitive analysis, or content aggregation. Whether you're building news aggregation platforms, monitoring industry trends, conducting media analysis, or creating news discovery applications, you'll gain actionable insights fast.

✅ SEO Benefit: By using structured Google News data, businesses can optimize news listing pages, monitor competition, and create data-rich content that boosts organic visibility.

---

📦 What Data Can You Extract with Google News Scraper?

🏷️ Data Type	📋 Description
📰 Article Details	Article title, link, source, snippet, and publication date
📍 Position	Ranking position of the article in search results
🔗 Article Links	Direct URLs to full news articles
📰 Source Information	News source/publisher name (e.g., BBC, Reuters, Forbes)
📝 Article Snippets	Brief summaries or excerpts from articles
📅 Publication Dates	Relative publication dates (e.g., "2 hours ago", "1 day ago")
🌍 Location Data	Geographic location for localized news results
🔍 Search Metadata	Total results, pages processed, pagination info
📊 Search Information	Query displayed and results state

This structured Google News dataset can be exported for analysis, visualization, or integration into your news monitoring and aggregation workflows.

---

⚙️ Key Features of Google News Scraper

✨ Comprehensive Data Coverage - Extract every essential data field: article titles, links, sources, snippets, and publication dates.

🔍 Advanced Filtering - Filter by safe search settings, exclude auto-corrected results, and filter duplicate content for precise results.

🌍 Localization Support - Search in different countries and languages with support for localized news results using country codes, language codes, and language restrictions.

🌐 Google Domain Selection - Choose specific Google domains (google.com, google.co.uk, google.fr, etc.) for region-specific results.

📄 Intelligent Pagination - Automatic handling of pagination with support for fetching multiple pages of results. Google News typically returns 10 articles per page.

💰 Cost-Effective Pricing - Pay only for what you use with transparent per-page pricing. Setup fee: $0.02, Per page: $0.01. No hidden fees or monthly subscriptions.

🛡️ Enterprise-Grade Reliability - Built for developers and businesses who demand reliability. Comprehensive error handling, robust logging, and production-ready code.

📦 Structured Output - Clean, structured JSON output ready for immediate use in your applications.

---

📖 Usage Examples

Example 1: Basic Search (Coffee News)

Search for news articles with a simple query.

{
  "q": "Coffee",
  "max_pages": 1
}

Example 2: Search with Location and Localization

Search for news with geographic location and language preferences.

{
  "q": "technology news",
  "location": "Austin, TX, Texas, United States",
  "google_domain": "google.com",
  "gl": "us",
  "hl": "en",
  "max_pages": 1
}

Example 3: Search with Filters

Search for news with safe search, exclude auto-corrected results, and filter duplicates.

{
  "q": "latest news",
  "location": "New York, NY",
  "safe": "active",
  "nfpr": "1",
  "filter": "1",
  "max_pages": 1
}

Example 4: Pagination (Multiple Pages)

Search across multiple pages to get more results.

{
  "q": "technology",
  "location": "California, United States",
  "gl": "us",
  "hl": "en",
  "max_pages": 2
}

Example 5: Comprehensive Search (All Parameters)

Search with all available parameters including location, localization, language restriction, safe search, and filters.

{
  "q": "artificial intelligence",
  "location": "San Francisco, CA",
  "google_domain": "google.com",
  "gl": "us",
  "hl": "en",
  "lr": "lang_en",
  "safe": "active",
  "nfpr": "1",
  "filter": "1",
  "max_pages": 2
}

---

🔍 Input Parameters

Parameter	Type	Required	Default	Description
q	string	✅ Yes	-	Search query string (e.g., "technology news", "coffee", "artificial intelligence"). Required.
location	string	❌	-	Geographic location for localized news results (e.g., "Austin, TX, Texas, United States", "New York, NY"). Optional. Helps narrow down news to a specific area.
google_domain	string	❌	google.com	Google domain to use for the search (e.g., "google.com", "google.co.uk", "google.fr"). Optional. Defaults to "google.com" if not specified.
gl	string	❌	-	Country code for localization (ISO 3166-1 alpha-2, lowercase). Optional. Defaults based on search context if not specified. See Country Codes section below for complete list.
hl	string	❌	-	Language code for localization (ISO 639-1, lowercase). Optional. Defaults based on country if not specified. See Language Codes section below for complete list.
lr	string	❌	-	Language restriction for search results (e.g., "lang_en", "lang_es", "lang_fr"). Optional.
safe	string	❌	off	Safe search setting to filter explicit content. Optional. Must be one of: "active" (filter explicit content) or "off" (no filtering). Default: "off".
nfpr	string	❌	"0"	Exclude results from auto-corrected queries when the original query is misspelled. Optional. Must be "0" (include auto-corrected results, default) or "1" (exclude auto-corrected results).
filter	string	❌	"0"	Enable or disable duplicate content filtering. Optional. Must be "0" (include duplicates, default) or "1" (filter duplicates).
max_pages	integer	❌	1	Maximum number of pages to fetch. Set to 0 for no limit (fetch all available pages). Default: 1. Each page is charged separately at $0.01 per page. Google News typically returns 10 news articles per page.
output_file	string	❌	Auto-generated	Optional filename to save results as JSON. If not provided, will auto-generate based on query and timestamp.

---

🌍 Country Codes (gl parameter)

The gl parameter accepts ISO 3166-1 alpha-2 country codes (lowercase). Here are the most common options:

Code	Country	Code	Country	Code	Country
us	United States	uk	United Kingdom	ca	Canada
au	Australia	de	Germany	fr	France
it	Italy	es	Spain	nl	Netherlands
be	Belgium	at	Austria	ch	Switzerland
se	Sweden	no	Norway	dk	Denmark
fi	Finland	pl	Poland	cz	Czech Republic
ie	Ireland	pt	Portugal	gr	Greece
hu	Hungary	ro	Romania	bg	Bulgaria
hr	Croatia	sk	Slovakia	si	Slovenia
ee	Estonia	lv	Latvia	lt	Lithuania
jp	Japan	kr	South Korea	cn	China
tw	Taiwan	hk	Hong Kong	sg	Singapore
my	Malaysia	th	Thailand	id	Indonesia
ph	Philippines	vn	Vietnam	in	India
pk	Pakistan	bd	Bangladesh	lk	Sri Lanka
nz	New Zealand	za	South Africa	br	Brazil
mx	Mexico	ar	Argentina	cl	Chile
co	Colombia	pe	Peru	ve	Venezuela

---

🌐 Language Codes (hl parameter)

The hl parameter accepts ISO 639-1 language codes (lowercase). Important: The Google News API only supports base language codes (e.g., en, es, fr), not regional variants (e.g., en-gb, en-us, es-mx). Use the base code for your language.

Here are the most common options:

Code	Language	Code	Language	Code	Language
en	English	es	Spanish	fr	French
de	German	it	Italian	pt	Portuguese
ru	Russian	ja	Japanese	ko	Korean
zh	Chinese	zh-cn	Chinese (Simplified)	zh-tw	Chinese (Traditional)
ar	Arabic	hi	Hindi	th	Thai
vi	Vietnamese	id	Indonesian	ms	Malay
tl	Filipino	nl	Dutch	pl	Polish
tr	Turkish	cs	Czech	sv	Swedish
da	Danish	fi	Finnish	no	Norwegian
hu	Hungarian	ro	Romanian	bg	Bulgarian
hr	Croatian	sk	Slovak	sl	Slovenian
et	Estonian	lv	Latvian	lt	Lithuanian
el	Greek	he	Hebrew	fa	Persian
ur	Urdu	bn	Bengali	ta	Tamil
te	Telugu	ml	Malayalam	kn	Kannada
gu	Gujarati	pa	Punjabi	mr	Marathi

---

🔒 Safe Search Parameter (safe)

The safe parameter controls filtering of explicit content:

Value	Description
"active"	Filter explicit content. Google will blur or exclude explicit content from results.
"off"	No filtering. All content is included regardless of explicitness. This is the default.

Example:

{
  "q": "news",
  "safe": "active"
}

---

🔍 Filter Parameters

Exclude Auto-corrected Results (nfpr)

The nfpr parameter controls whether to exclude results from auto-corrected queries:

Value	Description
"0"	Include auto-corrected results (default). If your query is misspelled, Google may auto-correct it and return results for the corrected query.
"1"	Exclude auto-corrected results. Only return results for the exact query as typed, even if misspelled.

Example:

{
  "q": "tecnology news",
  "nfpr": "1"
}

Filter Duplicates (filter)

The filter parameter controls duplicate content filtering:

Value	Description
"0"	Include duplicates (default). Show all results even if similar or duplicate content exists.
"1"	Filter duplicates. Hide similar or duplicate results to show only unique content.

Example:

{
  "q": "breaking news",
  "filter": "1"
}

---

📥 What You Get: Example Output from the Google News API

Every run of the Google News API returns structured Google News data, one dataset item per results page. Each item carries the search parameters you sent, the search metadata and pagination status, and a news_results array where each article includes its position, title, link, source, snippet, and date. The full field-by-field breakdown and a real example are below.

📊 Output Format

Dataset Item Structure

Each page of results is pushed as a separate dataset item with the following structure:

{
  "search_parameters": {
    "q": "Coffee",
    "location": null,
    "google_domain": null,
    "gl": null,
    "hl": null,
    "lr": null,
    "safe": null,
    "nfpr": null,
    "filter": null,
    "max_pages": 1
  },
  "search_metadata": {
    "total_results": 10,
    "news_count": 10,
    "pages_processed": 1,
    "max_pages_set": 1,
    "pagination_limit_reached": true
  },
  "search_information": {
    "query_displayed": "Coffee",
    "news_results_state": "Results for exact spelling"
  },
  "search_timestamp": "2026-01-12T10:30:00.123456",
  "page_number": 1,
  "news_results": [
    {
      "position": 1,
      "title": "I visited Nespresso's NYC flagship, with free coffee and a speakeasy. It showed me how brands want to be our identity.",
      "link": "https://www.businessinsider.com/nespresso-nyc-flagship-cafe-free-coffee-speakeasy-2026-1",
      "source": "Business Insider",
      "snippet": "The nearly 14000 square-foot store offers free coffee and a place to hang out, but I probably won't be back.",
      "date": "23 hours ago"
    },
    {
      "position": 2,
      "title": "Gastroenterologist says 'black coffee is poison that gives you life'; shares best way to drink it to reduce liver fat | Health",
      "link": "https://www.hindustantimes.com/lifestyle/health/gastroenterologist-says-black-coffee-is-poison-that-gives-you-life-shares-best-way-to-drink-it-to-reduce-liver-fat-101768125574599.html",
      "source": "Hindustan Times",
      "snippet": "Gastroenterologist Dr Vatsya recommends black coffee for its heart and liver health benefits, urging gradual intake increase.",
      "date": "1 day ago"
    }
  ]
}

Output Fields

• search_parameters: Complete search configuration used for the query
• search_metadata: Summary statistics about the search results including total results available, news count, pages processed, and pagination status
• search_information: Query information including displayed query and results state
• search_timestamp: ISO timestamp when the search was performed
• page_number: Current page number (1-indexed)
• news_results: Array of news articles with comprehensive details

News Article Fields

Each item in news_results contains:

• position: Ranking position of the article in search results (1-indexed)
• title: Article title/headline
• link: Direct URL to the full news article
• source: News source/publisher name (e.g., "BBC", "Reuters", "Forbes")
• snippet: Brief summary or excerpt from the article
• date: Relative publication date (e.g., "2 hours ago", "1 day ago", "3 days ago")

---

💰 Pricing

This Google News API uses simple pay-as-you-go pricing with no monthly subscription. There is a small setup fee of $0.02 per run, then $0.01 per results page fetched. Google News returns about 10 articles per page, so a single-page run costs $0.03 in total and a five-page pull costs $0.07. You are billed only for the pages you actually request through the max_pages parameter, with no hidden platform fees beyond your Apify plan. See the Actor page for the current live rates.

---

🚀 Getting Started

You can run the Google News API three ways:

1. Apify Console: open the Actor page, click Try for free, enter a query such as artificial intelligence, and run it. Results land in the dataset as JSON, CSV, or Excel.
2. API: call the Apify REST API or the apify-client package for Python or Node.js to run the Actor and fetch the dataset. See the Actor API tab.
3. MCP: add it as a tool to any MCP client, including Claude Code (free trial), so an AI agent can call it directly.

For a full working project, clone the Python quick-start repo linked at the top of this README.

---

🎯 Use Cases

• News Monitoring: Track news coverage on specific topics, brands, or keywords
• Market Research: Analyze news trends related to industries, companies, or products
• Competitive Analysis: Monitor competitor mentions and industry news
• News Aggregation: Build news discovery platforms and aggregators
• Data Analytics: Collect news data for business intelligence and analysis
• Content Creation: Gather news data for content marketing and SEO
• Media Monitoring: Track media coverage and sentiment analysis
• Academic Research: Collect news data for studies in journalism, sociology, or political science
• Lead Generation: Identify trending topics and news sources for business opportunities
• Crisis Management: Monitor breaking news and rapid response situations
• AI Context Injection: Feed real-time news into LLM prompts for grounded, up-to-date responses
• RAG Pipelines: Supply current news articles as retrieval context for AI chatbots and agents
• Automated News Briefings: Power AI agents that summarize daily headlines on any topic

---

🔌 Integrations: Automate News Monitoring with the Google News API

A single run answers one question. The real value of the Google News API comes from running it on a schedule so you build a history of coverage and get alerted the moment a story breaks. Everything below plugs into the Apify platform integrations.

Tasks and Schedules (the core recipe)

Save one task per thing you monitor (one for a brand name, one for a competitor, one for an industry keyword), each with its own query and localization. Then attach a schedule from the Actor's Actions, then Schedule menu. One schedule can trigger many tasks at once. Useful cron strings:

• 0 7 * * * runs every day at 7 AM for a morning news briefing
• 0 */6 * * * runs every six hours to catch breaking stories
• 0 9 * * 1 runs every Monday for a weekly media roundup

The Track Nvidia news headlines by keyword task shows this pattern end to end.

n8n

The Google News API is available as an n8n community node, n8n-nodes-google-news-api (see the n8n integration section below). A typical monitoring workflow is four nodes: a Schedule Trigger, then the Google News node, then a Filter on new links, then a Slack or email node for the alert. If you prefer not to install the node, call the Actor from an HTTP Request node using the Apify n8n integration.

Make and Zapier

The same pattern works on no-code platforms: trigger on a schedule, run the Actor, then route the results into your app. See Make and Zapier.

Store history in Supabase

To keep a running archive of headlines, push each run into a database. In n8n, chain the Actor node into a Supabase node. In Python, run the Actor and bulk-insert the flat article rows:

from apify_client import ApifyClient
from supabase import create_client

apify = ApifyClient("YOUR_APIFY_TOKEN")
supabase = create_client("YOUR_SUPABASE_URL", "YOUR_SUPABASE_KEY")

run = apify.actor("johnvc/GoogleNewsAPI").call(
    run_input={"q": "artificial intelligence", "max_pages": 2}
)

rows = []
for page in apify.dataset(run["defaultDatasetId"]).iterate_items():
    for article in page.get("news_results", []):
        rows.append({
            "position": article["position"],
            "title": article["title"],
            "link": article["link"],
            "source": article["source"],
            "snippet": article["snippet"],
            "date": article["date"],
        })

supabase.table("google_news").insert(rows).execute()

MCP and AI agents

Add the Google News API to any MCP client through the hosted Apify MCP server so an agent can pull live headlines on demand. It works with Claude Code (free trial), Cursor, and others. A question like "what are today's headlines about AI regulation, with sources and links?" is answered directly by the agent calling this API. Try the Pull Google News headlines into Claude via MCP task.

Webhooks

For anything custom, add an Apify webhook on the ACTOR.RUN.SUCCEEDED event to POST fresh results to your own endpoint the moment a run finishes.

---

🚀 Ready to Collect Google News Data?

Start using Google News Search Scraper today and transform public news listings into actionable insights. Whether you're building news aggregation platforms, monitoring industry trends, conducting market research, or creating news discovery applications, you'll have clean, structured data in minutes!

Made with ❤️

Transform your news search automation with the most reliable and feature-rich Google News API on Apify.

---

n8n integration

Available as an n8n community node, n8n-nodes-google-news-api. In n8n: Settings, Community Nodes, install n8n-nodes-google-news-api, then use it in any workflow (it also works as an AI Agent tool).

---

Featured Tasks

Ready-made use cases you can run in one click:

• Track Nvidia news headlines by keyword - track Nvidia headlines from Google News by API: title, source, link, snippet, and date for every article, as structured JSON for daily monitoring..
• Google News API for n8n workflows - plug Google News into n8n: call this API from an HTTP node and get article titles, sources, links, snippets, and dates back as clean JSON..
• Get Google News results by keyword as JSON - search Google News by keyword and export every article as JSON: title, source, link, snippet, and date.
• Monitor brand mentions in Google News for PR - monitor Google News for brand mentions: each article returns title, source, link, snippet, and date as JSON, ready for PR dashboards and alerts..
• Pull Google News headlines into Claude via MCP - connect this MCP-ready Google News API to Claude and pull current headlines with sources and links directly into your chat or agent workflow. (free trial available).
• Export Google News Results to CSV

---

🔗 Related Tools

Building a news and search intelligence pipeline? These related tools from the same portfolio pair well with the Google News API:

• Google News Lite API: a lighter, lower-cost sibling for high-volume headline pulls when you do not need the full parameter set.
• Google AI Overview API: track how a topic surfaces in Google's AI Overviews alongside the news coverage you collect here.
• Google Forums API: capture community discussion and sentiment around the same stories from forums and message boards.
• Naver Search API: extend news monitoring to the Korean market with web, news, and image results.

Older Google News scrapers on the Store exist too, but some carry noticeably lower ratings (under 4 stars across dozens of reviews) and declining monthly usage, such as this alternative Google News scraper. This API is actively maintained, documented field by field, and returns clean, consistent JSON.

---

❓ FAQ

Can I schedule the Google News API to run automatically?

Yes. Any run can be automated on a schedule. Create a saved task with your query and localization, then attach a schedule from the Actor's Actions, then Schedule menu. Use 0 7 * * * for a daily 7 AM briefing, 0 */6 * * * to check every six hours, or 0 9 * * 1 for a Monday roundup, and note that one schedule can drive many tasks at once. See the Integrations section above for the full monitoring recipe.

Should I use an official API or a web Scraper for Google News?

An official news API is usually rate limited, quota bound, and missing fields like the exact source or snippet. This Actor gives you the same public Google News data either as a no-code web scraper you run from a dashboard or as a clean endpoint you call yourself, with no quotas to manage. If you are new to the distinction, see API and web scraping for background.

Can I integrate this Google News Scraper with other apps?

Yes. It connects to almost any cloud service through Apify integrations, including Make, Zapier, Slack, and Google Sheets. For custom actions, add a webhook on ACTOR.RUN.SUCCEEDED. The Integrations section above has copy-paste recipes.

Can I use the Google News API with the Apify API?

Yes. The Apify API gives programmatic access to run the Actor, schedule it, and fetch datasets, and the apify-client package is available for both Python and Node.js. See the Actor's own API tab for ready-made snippets.

Can I use this Google News tool through an MCP server?

Yes. Add it as a tool to any MCP client, including Claude Code (free trial), Cursor, and others, through the hosted Apify MCP server. The Actor-specific MCP URL is https://mcp.apify.com/?tools=actors,docs,johnvc/GoogleNewsAPI. See the Apify MCP docs to get set up.

What is Google News and what data does this API cover?

Google News is Google's news aggregator, which groups articles from thousands of publishers by topic and recency. This API searches that public index by keyword and returns each article's title, source, link, snippet, and relative publication date, with localization by country, language, and Google domain.

How is Google News data used for market research and data analytics?

Teams pull structured Google News results to measure share of coverage, track competitor and brand mentions over time, and feed dashboards for market research and data analytics. Because every article comes back as a flat JSON row, it drops straight into a spreadsheet, a database, or a BI tool without extra parsing.

How can I monitor other search and news sources?

Pair the Google News API with related tools for broader coverage: the Google News Lite API for cheap bulk headlines, the Google AI Overview API to see how a story appears in AI answers, the Google Forums API for community discussion, and the Naver Search API for Korean-market news. See the Related Tools section above.

How many results can this Scraper return?

Google News returns about 10 articles per page. Set max_pages to fetch more, or 0 to page through all available results for a query. Deep pagination on Google News is naturally limited, so very high page counts may return fewer new articles near the end.

Is it legal to scrape Google News?

Scraping publicly available data is broadly established, though you are responsible for how you use the data you collect. For background, see Apify's overview of the legality of web scraping.

Last Updated: 2026.07.14