Google News Search API
Scrape Google News Search data with one API call. Returns a unified NewsArticleList of the top Google News results for a keyword, right now — headline, source outlet, thumbnail, article URL, and absolute UTC publish time (a text snippet may be present on some results). Ranked results land in one list (`placement` distinguishes a Top Stories block when present). The keyword supports quoted phrases and boolean operators (AND, OR, NOT). Localize with `location_name`/`location_code`/`location_coordinate` + `language_code` (non-Latin scripts supported). Filter by recency with `time_range`, by an exact date window with `from`/`to` (YYYY-MM-DD or Unix timestamp; overrides `time_range` when present), or by outlet with `publisher` (a bare domain like bbc.com). `publisher`/`from`/`to` cannot be combined with `location_coordinate` or `time_range=hour` (clear 400, never billed). There is no pagination beyond `depth` — Google News exposes at most 200 articles per query (default 10, max 100 on this surface). For the full article body, scrape the returned `url`. Served live from Google News — an ordinary synchronous request.
Last updated August 2026Maintained by the SocialCrawl team
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.
Searching 48 platforms in parallel
What can you do with the Search API?
The Search endpoint gives you structured Google News data with computed fields in a single request. No scraping infrastructure to build or maintain.
Example Request
curl -H "x-api-key: YOUR_API_KEY" \
"https://www.socialcrawl.dev/v1/google_news/search?keyword=openai"import requests
response = requests.get(
"https://www.socialcrawl.dev/v1/google_news/search",
params={
'keyword': 'openai',
},
headers={"x-api-key": "YOUR_API_KEY"},
)
data = response.json()const response = await fetch(
"https://www.socialcrawl.dev/v1/google_news/search?keyword=openai",
{
headers: { "x-api-key": "YOUR_API_KEY" },
},
);
const data = await response.json();Parameters
| Parameter | Required | Description |
|---|---|---|
| keyword | Yes | Search query (e.g. 'openai'). Supports any language; pass the matching language_code. Advanced operators (site:, intitle:, cache:, …) are not supported. |
| depth | No | Number of articles to retrieve (default 10, multiples of 10, max 100). No pagination beyond depth. |
| location_code | No | Google location code (e.g. 2840 = United States). Use one of location_code / location_name / location_coordinate. |
| location_name | No | Google location name (e.g. 'South Korea'). |
| location_coordinate | No | GPS target as 'latitude,longitude,radius_mm' (e.g. '40.7128,-74.0060,200') for local-news radius queries. |
| language_code | No | Google language code (e.g. 'en', 'ko'). Default 'en'. |
| time_range | No | Only return articles published within this window: hour, day, week, month, or year. Ignored when from/to is present. (hour | day | week | month | year) |
| publisher | No | Limit results to a single outlet's domain (e.g. 'bbc.com'). Bare domain only — no scheme, no path. Not combinable with location_coordinate or time_range=hour. |
| from | No | Start of an exact publish-date window, as YYYY-MM-DD or a Unix timestamp. Overrides time_range. Not combinable with location_coordinate or time_range=hour. |
| to | No | End of the publish-date window (inclusive), as YYYY-MM-DD or a Unix timestamp. Defaults to now when only from is set. |
What does the Google News Search API return?
Every response follows one unified schema. Here is a real, unmodified response body, so you can see the exact fields you get back before spending a credit.
Example response
{
"success": true,
"platform": "google_news",
"endpoint": "/v1/google_news/search",
"data": {
"items": [
{
"article": {
"id": "gn_b3d9c4e2",
"title": "Nvidia, SpaceX, Microsoft launch AI safety initiative as OpenAI cyberattack fallout continues",
"url": "https://www.cnbc.com/2026/07/27/nvidia-ai-initiative-openai-cyber-attack.html",
"source": "www.cnbc.com",
"domain": "www.cnbc.com",
"snippet": "Microsoft, SpaceX, Palantir, alongside dozens of other tech companies from the U.S. and Europe, have joined the Open Secure AI Alliance.",
"image_url": "https://news.example-cdn.com/i/07271738-8736-0139-0000-7fd649c7bc5a:0",
"published_at": "2026-07-27 10:38:07 +00:00",
"rank": 1,
"placement": "news_search"
}
},
{
"article": {
"id": "gn_9a58edc0",
"title": "How AI is expanding what people do at work",
"url": "https://openai.com/index/how-ai-is-expanding-what-people-do-at-work/",
"source": "openai.com",
"domain": "openai.com",
"snippet": "New OpenAI research shows how AI is expanding what workers do, with ChatGPT users taking on tasks across roles and reshaping job boundaries.",
"image_url": "https://news.example-cdn.com/i/07271738-8736-0139-0000-7fd649c7bc5a:1",
"published_at": "2026-07-27 10:38:07 +00:00",
"rank": 2,
"placement": "news_search"
}
}
],
"total": 20,
"dropped": 0
},
"credits_used": 1,
"credits_remaining": 9999,
"request_id": "req_example000000",
"cached": false,
"pagination": {
"next_cursor": null,
"has_more": false,
"page_size": 20
}
}Live sample illustrating the unified response shape. Field values reflect the record you query.
How does the Google News Search API work?
Send a GET request with your API key and get back clean, structured JSON in our unified schema. Supported computed fields are populated when the source provides the required inputs.
Method
GET
Response
JSON
How do you scrape social media data in seconds?
The fastest social media scraping API for developers. Scrape profiles, posts, comments, and analytics from 48 platforms covering 10B+ monthly active users.
One schema, every platform
Query 48 platforms with identical response structures. Write your integration once.
Computed fields, not just scraped
When an endpoint supports these metrics and the source provides the required inputs, the normalized record includes engagement_rate, estimated_reach, content_category, and language — ready to use.
See your data before you code
Visual Data Explorer — paste any URL, get rich result cards, sortable tables, CSV export.
import requests
response = requests.get(
'https://www.socialcrawl.dev/v1/tiktok/profile',
params={'handle': 'charlidamelio'},
headers={'x-api-key': 'sc_YOUR_API_KEY'}
)
data = response.json(){
"success": true,
"platform": "tiktok",
"data": {
"author": {
"username": "charlidamelio",
"followers": 152400000
},
"engagement": {
"likes": 12400000000,
"engagement_rate": 0.087
},
"metadata": {
"language": "en",
"content_category": "lifestyle"
}
}
}Have a question? We got answers
Find answers to frequently asked questions about SocialCrawl's API, pricing, and capabilities.
Contact usHow do I get Google News results with an API?
What fields does the Google News Search API return?
How do I filter Google News by recency?
Can I control how many news articles come back?
How much does the Google News Search API cost?
Ask AI about SocialCrawl
Ready to scrape Google News Search data?
Get your API key and start pulling Google News data in under 60 seconds.
