ssh.autos

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
APIFY STORE Public actor From $0.0025 per item. Open on Apify

Input options

FieldTypeDescriptionDefault
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

FieldTypeDescription
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"}}'

Open on Apify

Machine-readable: openapi.json · llms.txt

Some links to Apify are affiliate links. We may earn a commission if you sign up and become a paying customer.