📰 Google News Search API

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

💡 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.02. 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.02 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"
}

---

📊 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")

---

🎯 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

---

🚀 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.

---

Last Updated: 2026.01.15