Docs / API reference

POST/v1/data/google/news

Google News

Search Google News and return normalized article metadata.

Execution model

Live request

Runtime depends on endpoint, target, pagination, rendering mode, and active plan limits.

Credit weight

Live catalog

Current weights are managed from the Data API Weights admin table and shown on pricing before use.

Google News Endpoint

Search Google News and return normalized article metadata.

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": 10,
  "time_range": "week",
  "language": "en",
  "country": "us"
}'
Example response
{
  "success": true,
  "query": "artificial intelligence regulation",
  "total_results": "10",
  "time_taken": 2.14,
  "articles": [
    {
      "position": 1,
      "title": "EU AI Act Enforcement Begins: What Companies Need to Know",
      "url": "https://www.reuters.com/technology/eu-ai-act-enforcement-2026-04-01",
      "source": "Reuters",
      "source_url": "reuters.com",
      "date": "3 hours ago",
      "published_date": "2026-04-03T09:00:00Z",
      "snippet": "The European Union's AI Act enters its enforcement phase today, requiring all AI systems classified as high-risk to undergo compliance assessments...",
      "thumbnail": "https://static.reuters.com/image/ai-regulation.jpg"
    },
    {
      "position": 2,
      "title": "US Senate Proposes Comprehensive AI Safety Bill",
      "url": "https://www.washingtonpost.com/technology/2026/04/02/ai-safety-bill",
      "source": "The Washington Post",
      "source_url": "washingtonpost.com",
      "date": "1 day ago",
      "snippet": "Bipartisan legislation would create a federal AI licensing framework for frontier models..."
    }
  ],
  "related_searches": [
    {
      "query": "AI regulation news today"
    },
    {
      "query": "EU AI Act requirements"
    }
  ]
}

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": 10,
  "time_range": "week",
  "language": "en",
  "country": "us"
}'
Example response
{
  "success": true,
  "query": "artificial intelligence regulation",
  "total_results": "10",
  "time_taken": 2.14,
  "articles": [
    {
      "position": 1,
      "title": "EU AI Act Enforcement Begins: What Companies Need to Know",
      "url": "https://www.reuters.com/technology/eu-ai-act-enforcement-2026-04-01",
      "source": "Reuters",
      "source_url": "reuters.com",
      "date": "3 hours ago",
      "published_date": "2026-04-03T09:00:00Z",
      "snippet": "The European Union's AI Act enters its enforcement phase today, requiring all AI systems classified as high-risk to undergo compliance assessments...",
      "thumbnail": "https://static.reuters.com/image/ai-regulation.jpg"
    }
  ],
  "related_searches": [
    {
      "query": "AI regulation news today"
    }
  ]
}

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",
  "language": "en",
  "country": "us"
}'
Example response
{
  "success": true,
  "query": "artificial intelligence regulation",
  "total_results": "10",
  "time_taken": 2.14,
  "articles": [
    {
      "position": 1,
      "title": "EU AI Act Enforcement Begins: What Companies Need to Know",
      "url": "https://www.reuters.com/technology/eu-ai-act-enforcement-2026-04-01",
      "source": "Reuters",
      "source_url": "reuters.com",
      "date": "3 hours ago",
      "published_date": "2026-04-03T09:00:00Z",
      "snippet": "The European Union's AI Act enters its enforcement phase today, requiring all AI systems classified as high-risk to undergo compliance assessments...",
      "thumbnail": "https://static.reuters.com/image/ai-regulation.jpg"
    }
  ],
  "related_searches": [
    {
      "query": "AI regulation news today"
    }
  ]
}

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": 10,
  "time_range": "week",
  "language": "en",
  "country": "us"
}'
Example response
{
  "success": true,
  "query": "artificial intelligence regulation",
  "total_results": "10",
  "time_taken": 2.14,
  "articles": [
    {
      "position": 1,
      "title": "EU AI Act Enforcement Begins: What Companies Need to Know",
      "url": "https://www.reuters.com/technology/eu-ai-act-enforcement-2026-04-01",
      "source": "Reuters",
      "source_url": "reuters.com",
      "date": "3 hours ago",
      "published_date": "2026-04-03T09:00:00Z",
      "snippet": "The European Union's AI Act enters its enforcement phase today, requiring all AI systems classified as high-risk to undergo compliance assessments...",
      "thumbnail": "https://static.reuters.com/image/ai-regulation.jpg"
    }
  ],
  "related_searches": [
    {
      "query": "AI regulation news today"
    }
  ]
}

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": 10,
  "time_range": "hour",
  "language": "en",
  "country": "us",
  "sort_by": "relevance"
}'
Example response
{
  "success": true,
  "query": "artificial intelligence regulation",
  "total_results": "10",
  "time_taken": 2.14,
  "articles": [
    {
      "position": 1,
      "title": "EU AI Act Enforcement Begins: What Companies Need to Know",
      "url": "https://www.reuters.com/technology/eu-ai-act-enforcement-2026-04-01",
      "source": "Reuters",
      "source_url": "reuters.com",
      "date": "3 hours ago",
      "published_date": "2026-04-03T09:00:00Z",
      "snippet": "The European Union's AI Act enters its enforcement phase today, requiring all AI systems classified as high-risk to undergo compliance assessments...",
      "thumbnail": "https://static.reuters.com/image/ai-regulation.jpg"
    }
  ],
  "related_searches": [
    {
      "query": "AI regulation news today"
    }
  ]
}

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": 10,
  "time_range": "week",
  "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": "10",
  "time_taken": 2.14,
  "articles": [
    {
      "position": 1,
      "title": "EU AI Act Enforcement Begins: What Companies Need to Know",
      "url": "https://www.reuters.com/technology/eu-ai-act-enforcement-2026-04-01",
      "source": "Reuters",
      "source_url": "reuters.com",
      "date": "3 hours ago",
      "published_date": "2026-04-03T09:00:00Z",
      "snippet": "The European Union's AI Act enters its enforcement phase today, requiring all AI systems classified as high-risk to undergo compliance assessments...",
      "thumbnail": "https://static.reuters.com/image/ai-regulation.jpg"
    }
  ],
  "related_searches": [
    {
      "query": "AI regulation news today"
    }
  ]
}

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.

Parameters

NameTypeRequirementDescription
querystringRequiredNews search query (1-2048 characters).
num_resultsnumberOptionalNumber of articles to return (1-500).
languagestringOptionalLanguage code (hl parameter).
countrystringOptionalCountry code for geo-targeting (gl parameter, e.g. us, uk, in).
time_rangestringOptionalTime filter: "hour", "day", "week", "month", "year".
sort_bystringOptionalSort order: "relevance", "date".
topic_tokenstringOptionalGoogle News topic token for topic mode.
publication_tokenstringOptionalGoogle News publication token for publication mode.
section_tokenstringOptionalGoogle News section token for section mode.
sostringOptionalGoogle News sort or filter token when supported.

Request and 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": 10,
  "time_range": "week",
  "language": "en",
  "country": "us"
}'
Example response
{
  "success": true,
  "query": "artificial intelligence regulation",
  "total_results": "10",
  "time_taken": 2.14,
  "articles": [
    {
      "position": 1,
      "title": "EU AI Act Enforcement Begins: What Companies Need to Know",
      "url": "https://www.reuters.com/technology/eu-ai-act-enforcement-2026-04-01",
      "source": "Reuters",
      "source_url": "reuters.com",
      "date": "3 hours ago",
      "published_date": "2026-04-03T09:00:00Z",
      "snippet": "The European Union's AI Act enters its enforcement phase today, requiring all AI systems classified as high-risk to undergo compliance assessments...",
      "thumbnail": "https://static.reuters.com/image/ai-regulation.jpg"
    },
    {
      "position": 2,
      "title": "US Senate Proposes Comprehensive AI Safety Bill",
      "url": "https://www.washingtonpost.com/technology/2026/04/02/ai-safety-bill",
      "source": "The Washington Post",
      "source_url": "washingtonpost.com",
      "date": "1 day ago",
      "snippet": "Bipartisan legislation would create a federal AI licensing framework for frontier models..."
    }
  ],
  "related_searches": [
    {
      "query": "AI regulation news today"
    },
    {
      "query": "EU AI Act requirements"
    }
  ]
}