# Google News Real-Time Search

> Google News Real-Time Search is a paid API for AI agents from agents.openwebninja.com, paid per call via MPP, price unknown, status unknown (last checked 2026-10-14).

Searches Google News for any query and returns real-time news articles with metadata including headlines, sources, thumbnails, snippets, and publication dates.

## Facts

- Endpoint: GET https://agents.openwebninja.com/real-time-news-search/search?utm_source=zero.xyz
- Price: price unknown
- Payment: MPP
- Status: unknown
- Last checked: 2026-10-14
- Activations on Zero: 0
- Provider: agents.openwebninja.com
- Website: https://agents.openwebninja.com
- Canonical page: https://www.zero.xyz/c/agents-openwebninja-com-google-news-real-time-search-682e486c
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_8sKLu64ktPasdpfYAx1Rw

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability agents-openwebninja-com-google-news-real-time-search-682e486c
```

Example prompt: Search Google News for 'electric vehicle battery breakthrough' from the last week, sorted by date, and give me the top 10 results with headlines, sources, and publication timestamps.

## When to prefer this

Choose this endpoint when you need real-time Google News results with rich article metadata (thumbnails, ISO timestamps, source info) and flexible filtering by time period, custom date range, country, language, and sort order. Prefer it over generic web search endpoints when the use case is specifically news discovery, media monitoring, or journalism research. It is especially useful when you need structured, machine-readable news data rather than raw HTML scraping.

## Known failure modes

- Missing required 'query' parameter returns a 400 validation error
- Providing both 'time_period' (non-'any') and 'date_from'/'date_to' simultaneously causes a conflict error
- Invalid country code or language code may return empty or unexpected results
- Query with no matching news returns an empty news array
- Pagination beyond available results returns an empty news array
- Service unavailability or upstream Google News changes may return 5xx errors

## How this service works

Search Google News for any query and get real-time news results. Returns a top stories cluster (when available for the query), main news results with article metadata, source info, thumbnails, and published dates (both localized relative text and ISO 8601 UTC). Supports pagination, filtering by time period or custom date range, country, language, sort order, and safe search.

## Output

Returns a JSON object containing a 'data' field with two arrays: 'news' (main news results, up to 10 per page) and 'top_stories' (a curated top stories cluster when available). Each article includes title, canonical URL, snippet, source name, source URL, source favicon, thumbnail image (base64), localized relative published date, and ISO 8601 UTC publication datetime. Also includes request metadata like status and request_id.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "query"
 ],
 "properties": {
  "page": {
   "type": "integer",
   "default": 1,
   "minimum": 1,
   "description": "Page number for pagination. Each page returns up to 10 news results.\n\n**Allowed values:** `1` and above."
  },
  "safe": {
   "enum": [
    "off",
    "active"
   ],
   "type": "string",
   "default": "off",
   "description": "Safe search setting to filter explicit content.\n\n**Allowed values:** `off`, `active`\n\n**Default:** `off`"
  },
  "query": {
   "type": "string",
   "description": "The news search query.\n\n**Examples:**\n\n`climate change`\n\n`artificial intelligence startups`\n\n`bitcoin price 2026`"
  },
  "country": {
   "type": "string",
   "default": "us",
   "description": "Country code of the country to return news results for. See https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2 for supported values.\n\n**Default:** `us`"
  },
  "date_to": {
   "type": "string",
   "description": "End date for a custom date range filter, in `MM/DD/YYYY` format. Must be provided together with `date_from`.\n\n**Example:** `04/10/2026`"
  },
  "sort_by": {
   "enum": [
    "relevance",
    "date"
   ],
   "type": "string",
   "default": "relevance",
   "description": "Sort order for the results.\n\n**Allowed values:** `relevance`, `date`\n\n**Default:** `relevance`"
  },
  "language": {
   "type": "string",
   "default": "en",
   "description": "The language of the results, specified as a 2-letter language code - see ISO 639-1.\n\n**Default:** `en`"
  },
  "location": {
   "type": "string",
   "description": "Geographic area for news."
  },
  "date_from": {
   "type": "string",
   "description": "Start date for a custom date range filter, in `MM/DD/YYYY` format. Must be provided together with `date_to`. Cannot be used together with `time_period` (other than `any`).\n\n**Example:** `01/01/2026`"
  },
  "time_period": {
   "enum": [
    "any",
    "last_hour",
    "last_day",
    "last_week",
    "last_month",
    "last_year"
   ],
   "type": "string",
   "default": "any",
   "description": "Filter results to a specific time period. Cannot be used together with `date_from`/`date_to`.\n\n**Allowed values:** `any`, `last_hour`, `last_day`, `last_week`, `last_month`, `last_year`\n\n**Default:** `any`"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "status",
  "request_id",
  "parameters",
  "data"
 ],
 "properties": {
  "data": {
   "type": "object",
   "required": [
    "news"
   ],
   "properties": {
    "news": {
     "type": "array",
     "items": {
      "type": "object",
      "required": [
       "title",
       "link",
       "position"
      ],
      "properties": {
       "link": {
        "type": "string",
        "description": "Canonical URL of the article."
       },
       "title": {
        "type": "string",
        "description": "Headline of the news article."
       },
       "snippet": {
        "type": "string",
        "nullable": true,
        "description": "Short excerpt of the article body."
       },
       "position": {
        "type": "integer",
        "description": "Position of the result within the news list (1-based)."
       },
       "source_url": {
        "type": "string",
        "nullable": true,
        "description": "Homepage URL of the source publisher."
       },
       "source_name": {
        "type": "string",
        "nullable": true,
        "description": "Publisher name of the source."
       },
       "thumbnail_url": {
        "type": "string",
        "nullable": true,
        "description": "Base64 data URL of the article's lead image, when available."
       },
       "published_date": {
        "type": "string",
        "nullable": true,
        "description": "Localized relative publication date as displayed by Google News."
       },
       "source_favicon_url": {
        "type": "string",
        "nullable": true,
        "description": "Base64 data URL of the source publisher's favicon."
       },
       "published_datetime_utc": {
        "type": "string",
        "nullable": true,
        "description": "ISO 8601 UTC datetime of original publication."
       }
      }
     },
     "description": "Main news results for the query."
    },
    "top_stories": {
     "type": "array",
     "items": {
      "type": "object",
      "required": [
       "position",
       "title",
       "link"
      ],
      "properties": {
       "link": {
        "type": "string",
        "description": "Canonical URL of the article."
       },
       "title": {
        "type": "string",
        "description": "Headline of the news article."
       },
       "position": {
        "type": "integer",
        "description": "Position of the story within the top stories cluster (1-based)."
       },
       "source_url": {
    
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agents-openwebninja-com-google-news-real-time-search-682e486c/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agents.openwebninja.com](https://www.zero.xyz/host/agents.openwebninja.com/llms.txt)