Google News APISearch Google News as structured JSON with one SocialCrawl API key. Multi-locale, time windows, and publisher filters. Cache about five minutes. Reads cost 1 credit.
1 active endpoint. NewsArticle list.
One live search endpoint for Google News headlines. Keyword in, NewsArticle list out. Optional location, language, time_range, publisher, and from/to windows. Used as a leg by broader search/news surfaces. Data API only.
/v1/google_news/searchHeadlines for a keyword: title, url, source, published_at, media when present. depth defaults to 10 (max 100). location_name, language_code, time_range, publisher, from, and to narrow the window.
keyword, depth, location_name, language_code, time_range, publisher, from, to
Returns current Google News results for a keyword: headline, source outlet, thumbnail, article URL, and the exact publish time in UTC.
Use it for news coverage of a topic, narrowed by country, language, date window, or a single publisher domain.
1 credit
keyword · Search query (e.g. 'openai'). Supports any language; pass the matching language_code. Advanced operators (site:, intitle:, cache:, …) are not supported.
$ curl https://www.socialcrawl.dev/v1/google_news/search?keyword=openai&depth=20&language_code=en&time_range=day&publisher=bbc.com&from=2026-07-01&to=2026-07-15 \
-H "x-api-key: sc_YOUR_API_KEY"// Running this live needs your own API key. Hit "Try it" to see an example responseGoogle News is a normal SocialCrawl surface. You call GET /v1/google_news/search with an API key, spend 1 credit on a live miss, and get a single JSON envelope back. No Google News OAuth. No second SDK.
Send your key in the x-api-key header. No publisher portal tokens. The same key works for Google SERP, Finance, and the rest of the catalog.
The route is GET. Pass keyword plus optional depth, location_name or location_code, language_code, time_range, publisher, from, and to. Advanced operators like site: are not supported. We validate before charging.
Live miss costs 1 credit. Cache hit costs 0 (TTL about five minutes). Empty or hard failures refund. Bad params return 400 with no charge.
Every response is the same shape: success, data, credits_used, credits_remaining, request_id, cached. data holds a NewsArticle list under items.
Most products run one search shape and vary locale or time. Composite search/news can reuse this route as a leg when you need multi-country news fan-out.
GET /v1/google_news/search?keyword=…&time_range=dayNewsArticle items[] for the keyword and depth
Baseline headline pull. Default language en, depth 10.
GET /v1/google_news/search?keyword=…&location_name=…Same shape scoped by location_name and language_code
Local or non-English news without a second product integration.
GET /v1/search/news?query=…&countries=…Windowed results, or search/news fan-out using this leg
time_range or from/to for recency. Broader news jobs call the metered search/news composite.
GET /v1/google_news/search
?keyword=federal+reserve
&time_range=day
&depth=20
Host: www.socialcrawl.dev
x-api-key: sc_your_api_key_here{
"success": true,
"data": {
"items": [
{
"title": "Example headline",
"url": "https://news.example.com/…",
"source": "Example Outlet",
"published_at": "2026-08-03T12:00:00Z"
}
]
},
"credits_used": 1,
"credits_remaining": 9999,
"request_id": "req_…",
"cached": false
}Articles use the shared NewsArticle leaf so news parsers stay consistent across locales and composite legs.
items[] with title, url, source, published_at, media thumb when present
same fields; location_name / language_code change which SERP Google News returns
same fields; time_range or from/to filters publish time; publisher limits to one domain
Same request lifecycle as every other /v1 platform endpoint. Google News is not a sidecar.
Next.js catch-all routes into the Hono social API. We mint a request_id, authenticate the key, then enforce rate limit (600/min) and concurrency (50 in flight per key).
Registry lookup finds google_news/search. Required keyword and optional filter rules run first. Invalid input returns 400 with no charge. Valid calls debit 1 credit atomically before upstream work.
A deterministic cache key is built from platform + resource + params. Hit: return immediately, credits_used = 0 (about five minutes). Miss: the primary Google News path runs, with an automatic fallback when policy allows. Retries on empty or network errors within budget.
Upstream JSON is mapped to NewsArticle items, validated against the canonical Zod schema, then wrapped in the success envelope and logged for billing audit.
Billing rules that matter in production
Google News is a public-read news SERP. We normalize headlines into NewsArticle so your code does not learn a second news SDK.
Keyword news search with locale, language, time window, and optional publisher filter. Read-only headlines and links. Not a full-text article scrape. Not Google Alerts management.
The primary path is a dedicated Google News integration, with an automatic fallback when exclusive filters are absent. Single-page depth fan-out, no cursor pagination beyond depth.
A unified JSON envelope: success, data, credits_used, request_id, cached. Headlines become NewsArticle rows with title, url, source, and published_at.
No site: or intitle: operators. No full article body extraction on this route. No write endpoints. Multi-country fan-out belongs on search/news, which reuses this surface as a leg.
The jobs this API is most often used for.
Brand and topic news monitoring
Callers concentrate on keyword plus time_range or language_code. Composite search/news appears when one query needs several countries in one metered job. Flat 1 credit news search with multi-locale params and ~5 minute cache. Same key as SERP and finance. No separate news vendor contract.
Live misses are typically a few seconds. Empty-retry ladders and fallback can stretch toward the route budget on sparse queries.
The jobs Google News data is most often used for. Each one is a full recipe with the endpoint chain and pricing.
Common ways teams put this data to work, and the stack each one tends to run.
Poll search with brand keywords and time_range=day. Alert when new outlet URLs appear. Cache hits keep quiet hours free.
Locale passes with language_code and location_name for regional coverage. Export title, source, published_at into sheets or warehouses.
Use google_news/search directly for one market, or call search/news when multiple countries share one metered fan-out. Same SocialCrawl key.
Live search is one credit. Cache hits are free for about five minutes. Empty and hard failures refund.
curl "https://www.socialcrawl.dev/v1/google_news/search?keyword=federal+reserve&time_range=day&depth=20" \
-H "x-api-key: sc_your_api_key_here"Same key as the rest of the catalog
Every endpoint returns structured JSON in a unified envelope. Computed fields such as engagement rate and content category are included only where the endpoint supports them and the required source inputs are present.
Same Google News data, two very different paths. Auth, rate limits, schema, and cost, side by side.
| Feature | SocialCrawl | NewsAPI.org |
|---|---|---|
| Source | Current Google News snapshot: exact repeats may use the 5-minute cache | Its own crawled index of news publishers |
| Authentication | One x-api-key, sign up and call | API key, but free tier blocks production and recent articles |
| Response schema | Unified NewsArticleList JSON shared across every SocialCrawl platform | Its own article shape, separate from your other data sources |
| Localization | language_code + location_name / code / coordinate, non-Latin scripts verified | Language and country params, but smaller non-English coverage |
| Recency filter | time_range: hour, day, week, month, or year | from / to dates, with the recent window paywalled on free tier |
| Pricing | 1 credit per search, any depth; 100 free credits, no card | Free tier is dev-only; production needs a paid monthly plan |
Source
Authentication
Response schema
Localization
Recency filter
Pricing
Find answers to frequently asked questions about SocialCrawl's API, pricing, and capabilities.
Contact usAsk AI about SocialCrawl