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, snippet, thumbnail, article URL, and absolute UTC publish time. Combines Google's main news ranking and the Top Stories carousel into one list (`placement` distinguishes them). Localize with `location_name`/`location_code`/`location_coordinate` + `language_code` (non-Latin scripts supported). Filter by recency with `time_range`. 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`. Sourced live from DataForSEO's Google News SERP — an ordinary synchronous request (~1-3s).
Last updated July 2026Maintained by the SocialCrawl team
Searching 46 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. (hour | day | week | month | year) |
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://api.dataforseo.com/cdn/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://api.dataforseo.com/cdn/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 46 platforms covering 10B+ monthly active users.
One schema, every platform
Query 46 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.
