Catalog / Social, content & reviews
SOCIAL, CONTENT & REVIEWS
Google News
Collect Google News headlines by search, topic, edition or location.
PER CALL · X402 / MPP
Not yet
Not available per call yet. Use the Apify actor meanwhile.
Ask for it per call
Input options
| Field | Type | Description | Default |
|---|---|---|---|
country |
string | Exact uppercase country code from a supported language/country pair; see README. Omitted: US. | |
dateFrom |
string | Inclusive UTC date YYYY-MM-DD. Supply both dates; queries only, at most 31 days. Search is split by day. | |
dateTo |
string | Inclusive UTC date YYYY-MM-DD. Supply both dates; queries only, at most 31 days. Search is split by day. | |
deduplicate |
boolean | Deliver an article once with every observed matched source in matchedQueries. Omitted: true. | |
excludeSites |
array | Exclude these lowercase domains and their subdomains. Max 20. | |
fetchArticleText |
boolean | Fetch resolved publisher HTML for article text and metadata. Enables URL resolution. Omitted: false. | |
language |
string | Exact language code from a supported language/country pair; see README. Omitted: en-US. | |
locations |
array | Place names for current local news, such as London. Max 20. | |
maxItemsPerQuery |
integer | Cap per original search, topic, headline or location source, across date slices. Omitted: 100, or 10 for sample. | |
maxResults |
integer | Maximum dataset rows. Omitted: 100, or 10 for sample. Bare-start sample always capped at 10. | |
onlyNewSinceLastRun |
boolean | Remember delivered IDs in a named store. Repeated runs with the same state key skip them. Omitted: false. | |
proxyConfiguration |
object | Optional explicit connection configuration on Apify. Omit for direct connections. Local runs allow only useApifyProxy=false. | |
publishedWithin |
string | Recent window, 1h..99h or 1d..31d, such as 6h. Search operator plus local UTC filtering; other feeds are filtered locally. | |
queries |
array | Search strings; quotes, OR, -term, site:, intitle:, when:, after: and before: pass through. Max 20. | |
resolvePublisherUrls |
boolean | Try to recover the original article URL. Failures retain the Google link and a reason. Omitted: false. | |
sites |
array | Only articles from these lowercase domains or their subdomains, without schemes or paths. Max 20. | |
stateKey |
string | Name up to 64 characters. Omitted: derived from source and edition filters. Retains 20,000 IDs for 90 days from delivery. | |
topHeadlines |
boolean | Include current top headlines for the selected edition. A bare start samples 10 headlines. | |
topics |
array | Choose WORLD, NATION, BUSINESS, TECHNOLOGY, ENTERTAINMENT, SPORTS, SCIENCE or HEALTH. Max 20. | |
Output schema
| Field | Type | Description |
|---|---|---|
article |
object, null | |
articleId |
string | |
collectedAt |
string | |
country |
string | |
description |
string | |
feedType |
string | |
googleNewsUrl |
string | |
language |
string | |
matchedQueries |
array | |
publishedAt |
string | |
publisher |
string, null | |
publisherUrl |
string, null | |
query |
string | |
relatedArticles |
array | |
resolutionReason |
string, null | |
resolutionStatus |
string | |
resolvedUrl |
string, null | |
title |
string | |
topic |
string, null |
About this data
Collect Google News headlines by search, topic, edition or location. Return publisher, publication time, story clusters and matched searches, with optional publisher links, article text and scheduled new-only delivery.
Run it on Apify
This data source is a public actor on the Apify Store: Google News Scraper. Run it with your Apify account and plan for larger, scheduled or exported runs.
Run command
# MCP prompt for Claude/Cursor/Muse
Use the Apify connector to run automatic/google-news-scraper with the input schema defined on Apify.
# Apify CLI / curl
apify call automatic/google-news-scraper -i '{"country":{"description":"Exact uppercase country code from a supported language/country pair; see README. Omitted: US.","editor":"textfield","prefill":"US","title":"Edition country","type":"string"},"dateFrom":{"description":"Inclusive UTC date YYYY-MM-DD. Supply both dates; queries only, at most 31 days. Search is split by day.","editor":"textfield","title":"Publication date from","type":"string"},"dateTo":{"description":"Inclusive UTC date YYYY-MM-DD. Supply both dates; queries only, at most 31 days. Search is split by day.","editor":"textfield","title":"Publication date to","type":"string"},"deduplicate":{"description":"Deliver an article once with every observed matched source in matchedQueries. Omitted: true.","prefill":true,"title":"Deduplicate across sources","type":"boolean"},"excludeSites":{"description":"Exclude these lowercase domains and their subdomains. Max 20.","editor":"stringList","items":{"type":"string"},"maxItems":20,"minItems":1,"title":"Exclude publisher domains","type":"array"},"fetchArticleText":{"description":"Fetch resolved publisher HTML for article text and metadata. Enables URL resolution. Omitted: false.","prefill":false,"title":"Extract article text","type":"boolean"},"language":{"description":"Exact language code from a supported language/country pair; see README. Omitted: en-US.","editor":"textfield","prefill":"en-US","sectionCaption":"Edition","title":"Edition language","type":"string"},"locations":{"description":"Place names for current local news, such as London. Max 20.","editor":"stringList","items":{"type":"string"},"maxItems":20,"minItems":1,"title":"News locations","type":"array"},"maxItemsPerQuery":{"description":"Cap per original search, topic, headline or location source, across date slices. Omitted: 100, or 10 for sample.","maximum":1000,"minimum":1,"prefill":10,"sectionCaption":"Result limits","title":"Articles per source","type":"integer"},"maxResults":{"description":"Maximum dataset rows. Omitted: 100, or 10 for sample. Bare-start sample always capped at 10.","maximum":5000,"minimum":1,"prefill":10,"title":"Total article limit","type":"integer"},"onlyNewSinceLastRun":{"description":"Remember delivered IDs in a named store. Repeated runs with the same state key skip them. Omitted: false.","prefill":false,"sectionCaption":"Scheduling and duplicates","title":"Only new articles","type":"boolean"},"proxyConfiguration":{"description":"Optional explicit connection configuration on Apify. Omit for direct connections. Local runs allow only useApifyProxy=false.","editor":"proxy","prefill":{"useApifyProxy":false},"sectionCaption":"Connections","title":"Optional connection configuration","type":"object"},"publishedWithin":{"description":"Recent window, 1h..99h or 1d..31d, such as 6h. Search operator plus local UTC filtering; other feeds are filtered locally.","editor":"textfield","sectionCaption":"Publication dates","title":"Published within","type":"string"},"queries":{"description":"Search strings; quotes, OR, -term, site:, intitle:, when:, after: and before: pass through. Max 20.","editor":"stringList","items":{"type":"string"},"maxItems":20,"minItems":1,"sectionCaption":"News sources","title":"Search queries","type":"array"},"resolvePublisherUrls":{"description":"Try to recover the original article URL. Failures retain the Google link and a reason. Omitted: false.","prefill":false,"sectionCaption":"Publisher URLs and text","title":"Resolve publisher URLs","type":"boolean"},"sites":{"description":"Only articles from these lowercase domains or their subdomains, without schemes or paths. Max 20.","editor":"stringList","items":{"type":"string"},"maxItems":20,"minItems":1,"sectionCaption":"Publisher filters","title":"Include publisher domains","type":"array"},"stateKey":{"description":"Name up to 64 characters. Omitted: derived from source and edition filters. Retains 20,000 IDs for 90 days from delivery.","editor":"textfield","title":"Scheduled feed state key","type":"string"},"topHeadlines":{"description":"Include current top headlines for the selected edition. A bare start samples 10 headlines.","prefill":true,"title":"Top headlines","type":"boolean"},"topics":{"description":"Choose WORLD, NATION, BUSINESS, TECHNOLOGY, ENTERTAINMENT, SPORTS, SCIENCE or HEALTH. Max 20.","editor":"select","items":{"enum":["WORLD","NATION","BUSINESS","TECHNOLOGY","ENTERTAINMENT","SPORTS","SCIENCE","HEALTH"],"enumTitles":["World","Nation","Business","Technology","Entertainment","Sports","Science","Health"],"type":"string"},"maxItems":20,"minItems":1,"title":"News topics","type":"array"}}'
Machine-readable: openapi.json · llms.txt