Google News Endpoint
Search a single Google News RSS feed for headlines, sources, publication dates, and Google RSS redirect URLs.
Getting Started
Send your API key as a bearer token. Start with the smallest request below.
Run Google News
Send the smallest useful request and read the structured response.
curl -X POST "https://api.datablue.dev/v1/data/google/news" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"query": "artificial intelligence regulation",
"num_results": 2,
"time_range": "week",
"sort_by": "date",
"language": "en",
"country": "us"
}'Example response
{
"success": true,
"query": "artificial intelligence regulation",
"total_results": "2",
"time_taken": 0.74,
"articles": [
{
"position": 1,
"rank": 1,
"title": "Artificial intelligence regulation: a policy roundup",
"url": "https://news.google.com/rss/articles/EXAMPLE_ARTICLE_TOKEN_1?oc=5",
"source": "Example News",
"source_url": "https://news.example.com",
"date": "Wed, 16 Sep 2026 09:00:00 GMT",
"published_date": "2026-09-16T09:00:00+00:00"
},
{
"position": 2,
"rank": 2,
"title": "Businesses prepare for artificial intelligence rules",
"url": "https://news.google.com/rss/articles/EXAMPLE_ARTICLE_TOKEN_2?oc=5",
"source": "Example Journal",
"source_url": "https://journal.example.com",
"date": "Tue, 15 Sep 2026 14:30:00 GMT",
"published_date": "2026-09-15T14:30:00+00:00"
}
],
"related_searches": []
}Options
Query and Target
Set the search term, identifier, or source URL that defines the request.
curl -X POST "https://api.datablue.dev/v1/data/google/news" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"query": "web scraping tools",
"num_results": 2,
"time_range": "week",
"sort_by": "date",
"language": "en",
"country": "us"
}'Example response
{
"success": true,
"query": "artificial intelligence regulation",
"total_results": "2",
"time_taken": 0.74,
"articles": [
{
"position": 1,
"rank": 1,
"title": "Artificial intelligence regulation: a policy roundup",
"url": "https://news.google.com/rss/articles/EXAMPLE_ARTICLE_TOKEN_1?oc=5",
"source": "Example News",
"source_url": "https://news.example.com",
"date": "Wed, 16 Sep 2026 09:00:00 GMT",
"published_date": "2026-09-16T09:00:00+00:00"
}
],
"related_searches": []
}Results and Pagination
Control how many records or pages are returned.
curl -X POST "https://api.datablue.dev/v1/data/google/news" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"query": "artificial intelligence regulation",
"num_results": 100,
"time_range": "week",
"sort_by": "date",
"language": "en",
"country": "us"
}'Example response
{
"success": true,
"query": "artificial intelligence regulation",
"total_results": "2",
"time_taken": 0.74,
"articles": [
{
"position": 1,
"rank": 1,
"title": "Artificial intelligence regulation: a policy roundup",
"url": "https://news.google.com/rss/articles/EXAMPLE_ARTICLE_TOKEN_1?oc=5",
"source": "Example News",
"source_url": "https://news.example.com",
"date": "Wed, 16 Sep 2026 09:00:00 GMT",
"published_date": "2026-09-16T09:00:00+00:00"
}
],
"related_searches": []
}Location and Language
Localize results with country, language, coordinates, or delivery-location fields.
curl -X POST "https://api.datablue.dev/v1/data/google/news" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"query": "artificial intelligence regulation",
"num_results": 2,
"time_range": "week",
"sort_by": "date",
"language": "en",
"country": "us"
}'Example response
{
"success": true,
"query": "artificial intelligence regulation",
"total_results": "2",
"time_taken": 0.74,
"articles": [
{
"position": 1,
"rank": 1,
"title": "Artificial intelligence regulation: a policy roundup",
"url": "https://news.google.com/rss/articles/EXAMPLE_ARTICLE_TOKEN_1?oc=5",
"source": "Example News",
"source_url": "https://news.example.com",
"date": "Wed, 16 Sep 2026 09:00:00 GMT",
"published_date": "2026-09-16T09:00:00+00:00"
}
],
"related_searches": []
}Filters and Sorting
Narrow or order the returned records.
curl -X POST "https://api.datablue.dev/v1/data/google/news" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"query": "artificial intelligence regulation",
"num_results": 2,
"time_range": "hour",
"sort_by": "relevance",
"language": "en",
"country": "us"
}'Example response
{
"success": true,
"query": "artificial intelligence regulation",
"total_results": "2",
"time_taken": 0.74,
"articles": [
{
"position": 1,
"rank": 1,
"title": "Artificial intelligence regulation: a policy roundup",
"url": "https://news.google.com/rss/articles/EXAMPLE_ARTICLE_TOKEN_1?oc=5",
"source": "Example News",
"source_url": "https://news.example.com",
"date": "Wed, 16 Sep 2026 09:00:00 GMT",
"published_date": "2026-09-16T09:00:00+00:00"
}
],
"related_searches": []
}Additional Options
Set endpoint-specific options for this request.
curl -X POST "https://api.datablue.dev/v1/data/google/news" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"query": "artificial intelligence regulation",
"num_results": 2,
"time_range": "week",
"sort_by": "date",
"language": "en",
"country": "us",
"topic_token": "example",
"publication_token": "example",
"section_token": "example",
"so": "example"
}'Example response
{
"success": true,
"query": "artificial intelligence regulation",
"total_results": "2",
"time_taken": 0.74,
"articles": [
{
"position": 1,
"rank": 1,
"title": "Artificial intelligence regulation: a policy roundup",
"url": "https://news.google.com/rss/articles/EXAMPLE_ARTICLE_TOKEN_1?oc=5",
"source": "Example News",
"source_url": "https://news.example.com",
"date": "Wed, 16 Sep 2026 09:00:00 GMT",
"published_date": "2026-09-16T09:00:00+00:00"
}
],
"related_searches": []
}Response
Read success first, then consume the endpoint-specific records and pagination fields shown below.
Error Handling
Handle 401 for authentication, 422 for invalid input, 429 for limits, and retry only transient failures.