Google News API

Extract structured Google News search results via a clean, fast API. Get headlines, sources, URLs, snippets, and publication dates - with support for date filtering, regional domains, and advanced search parameters.

Pricing: $1.00 per 1,000 results (~$0.001 per result). Pay only for what you extract.

---

Why use this Actor?

• True API, not a scraper - built on a real search API, not browser automation. No Playwright, no proxies, no bot detection headaches. Results are fast and reliable.
• Direct article URLs - every result contains the real article URL, not a Google redirect link. No extra decoding step needed - the URL is ready to use immediately.
• Rich date filtering - filter by past hour, day, week, month, year, or any custom date range (e.g. 2024-01-01:2024-01-31). Most competitors only support preset options.
• Regional search via seDomain - search on any Google regional version: google.de, google.co.uk, google.fr, and more. Combine with language and location codes for truly localized results.
• Advanced searchParam for power users - pass raw Google URL parameters directly (e.g. tbs=qdr:w, safe=active). Full control over search behavior without waiting for new features.
• Pay per result - you only pay for data extracted, not for compute time or idle runs.
• Up to 200 results per query - suitable for monitoring, research, and aggregation at scale.

---

Monitoring & scheduling

This Actor is well suited for continuous news monitoring. Run it on a schedule to track any topic, brand, or keyword over time.

How to set up monitoring:

1. Open the Actor and click Schedule to set a recurring run (hourly, daily, weekly).
2. Use dateFilter: "past_day" (or past_hour) so each run only fetches fresh articles.
3. Connect to downstream tools via Apify integrations: send results to Google Sheets, trigger a Slack notification, post to a webhook, or pipe data into Make / Zapier.

This gives you a lightweight media monitoring system - no additional infrastructure required.

---

What you get

Each result includes:

• type - news_search or top_stories_element
• title - article headline
• source / domain - publisher name and domain
• url - direct link to the article
• snippet - article summary
• publishedText - relative time (e.g. "2 hours ago", "3 days ago")
• timestamp - publication timestamp
• imageUrl - thumbnail image URL (when available)
• keyword, locationCode, languageCode, searchDatetime - search metadata
• rankAbsolute, rankGroup - position in search results

---

Input parameters

Parameter	Type	Default	Description
keyword	string	required	Search query. Max 500 characters.
languageCode	string	en	Language code (ISO 639-1). E.g. en, de, fr, es.
locationCode	integer	2840	Location code. 2840 = USA, 2826 = UK, 2276 = Germany. See Supported locations below.
depth	integer	100	Number of results to retrieve. Min 10, max 200.
dateFilter	string	-	Filter results by date. See Date Filtering below.
searchParam	string	-	Advanced: raw Google search parameter string (e.g. tbs=qdr:d). Overrides dateFilter if both set.
seDomain	string	-	Google domain to use (e.g. google.de, google.co.uk). Useful for region-specific results.
maxWaitSeconds	integer	600	Max time to wait for results. Range: 60-1800 seconds.
pollIntervalSeconds	integer	10	How often to check for results. Range: 5-60 seconds.

---

Date Filtering

Use dateFilter to restrict results to a specific time period.

Preset values

Value	Description
past_hour	Results published in the past hour
past_day	Results published in the past 24 hours
past_week	Results published in the past 7 days
past_month	Results published in the past month
past_year	Results published in the past year

Custom date range

Use ISO format: YYYY-MM-DD:YYYY-MM-DD

dateFilter: "2024-01-01:2024-01-31"

This returns news articles published between January 1 and January 31, 2024.

---

Advanced: searchParam

For power users, searchParam passes raw Google URL parameters directly to the search engine. This gives full control over search filters.

Examples:

searchParam	Effect
tbs=qdr:h	Past hour
tbs=qdr:d	Past 24 hours
tbs=qdr:w	Past week
tbs=qdr:m	Past month
tbs=qdr:y	Past year
tbs=cdr:1,cd_min:01/01/2024,cd_max:01/31/2024	Custom date range
safe=active	SafeSearch on

Note: searchParam takes priority over dateFilter if both are provided.

---

Regional search with seDomain

Use seDomain to search on a specific regional Google version.

seDomain	Region
google.com	Global (default)
google.de	Germany
google.co.uk	United Kingdom
google.fr	France
google.es	Spain
google.it	Italy
google.com.br	Brazil
google.co.jp	Japan
google.com.au	Australia

Combine with locationCode and languageCode for best results. For example, German news: seDomain: "google.de", languageCode: "de", locationCode: 2276.

---

Use cases

• Media monitoring - track brand mentions, competitor coverage, or industry topics in real-time
• Market research - collect news about specific companies, markets, or trends for analysis
• Content aggregation - build news feeds or newsletters from curated topics and sources
• Sentiment analysis - feed article headlines and snippets into NLP pipelines
• Academic research - gather news datasets filtered by date, region, and topic
• AI/LLM training data - extract structured news data at scale

---

Example inputs

Basic: top AI news from the past 24 hours (USA)

{
  "keyword": "artificial intelligence",
  "languageCode": "en",
  "locationCode": 2840,
  "depth": 100,
  "dateFilter": "past_day"
}

German news about Bundesliga

{
  "keyword": "Bundesliga",
  "languageCode": "de",
  "locationCode": 2276,
  "depth": 50,
  "seDomain": "google.de",
  "dateFilter": "past_week"
}

Bitcoin news for a custom date range

{
  "keyword": "bitcoin",
  "languageCode": "en",
  "locationCode": 2840,
  "depth": 200,
  "dateFilter": "2024-01-01:2024-01-31"
}

Advanced raw search param

{
  "keyword": "climate change",
  "languageCode": "en",
  "locationCode": 2840,
  "depth": 100,
  "searchParam": "tbs=qdr:w"
}

---

Pricing

• $1.00 per 1,000 results ($0.001 per result)
• Billing is per extracted result item
• A run with depth: 100 costs $0.10
• A run with depth: 10 costs $0.01

---

Supported languages

Top 30 most common language codes:

Language	Code	Language	Code
English	en	Arabic	ar
German	de	Korean	ko
French	fr	Turkish	tr
Spanish	es	Swedish	sv
Portuguese	pt	Danish	da
Italian	it	Finnish	fi
Dutch	nl	Norwegian	no
Polish	pl	Czech	cs
Russian	ru	Hungarian	hu
Japanese	ja	Romanian	ro
Chinese (Simplified)	zh-CN	Ukrainian	uk
Chinese (Traditional)	zh-TW	Hindi	hi
Indonesian	id	Vietnamese	vi
Thai	th	Greek	el
Hebrew	he	Bulgarian	bg

Full list of all 129 supported languages: languages.md

---

Supported locations

Top 30 most common location codes (countries):

Code	Country	Code	Country
2840	United States	2356	India
2826	United Kingdom	2392	Japan
2276	Germany	2124	Canada
2250	France	2036	Australia
2724	Spain	2643	Russia
2380	Italy	2484	Mexico
2528	Netherlands	2410	South Korea
2616	Poland	2040	Austria
2752	Sweden	2756	Switzerland
2056	Belgium	2702	Singapore
2620	Portugal	2764	Thailand
2076	Brazil	2818	Egypt
2792	Turkey	2710	South Africa
2566	Nigeria	2682	Saudi Arabia
2032	Argentina	2458	Malaysia

Full list of all 213 supported countries: locations.md