# OpenWeb Ninja Real-Time News Search

> OpenWeb Ninja Real-Time News 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 real-time news articles by keyword query with optional filters for time range, source domain, country, and language.

## Facts

- Endpoint: GET https://agents.openwebninja.com/realtime-news-data/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-openweb-ninja-real-time-news-search-1ba5da78
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_IFTbCvuXx0qBq86XoRsRx

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-openweb-ninja-real-time-news-search-1ba5da78
```

Example prompt: Search for the latest news articles about artificial intelligence regulation published in the last 24 hours, give me up to 20 results in English from US sources.

## When to prefer this

Choose this endpoint when you need real-time, keyword-searchable news articles with rich metadata (authors, snippets, images, related topics) and need to filter by time range, country, language, or specific publisher domain. It is ideal for news monitoring, media research, or feeding current events into an AI pipeline. Prefer it over generic web search APIs when you specifically need structured news article data rather than general web results.

## Known failure modes

- Missing required 'query' parameter returns a validation error
- Invalid country code or language code may return empty results or an error
- Requesting more than 500 articles (limit maximum) returns a validation error
- Source domain filter with no matching articles returns an empty data array
- Service unavailability or upstream Google News issues may return a non-200 status

## How this service works

Search news articles by query with an option to limit the results to a specific time range.

## Output

Returns an array of news article objects, each containing the article headline, canonical URL, short snippet, author list, publication datetime in UTC, source publisher name and URL, related Google News topics, and image URLs (photo and thumbnail). Also includes a request status string and unique request ID.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "query"
 ],
 "properties": {
  "limit": {
   "type": "integer",
   "default": 10,
   "maximum": 500,
   "minimum": 1,
   "description": "Maximum number of news articles to return."
  },
  "query": {
   "type": "string",
   "example": "Elon Musk",
   "description": "Search query for which to get news."
  },
  "source": {
   "type": "string",
   "description": "Domain of the source from which to return news articles."
  },
  "country": {
   "type": "string",
   "default": "us",
   "description": "Country code. See all available country codes."
  },
  "language": {
   "type": "string",
   "default": "en",
   "description": "The language to use for the results, specified as a 2-letter language code - see ISO 639-1 alpha-2."
  },
  "time_published": {
   "type": "string",
   "default": "anytime",
   "description": "Find news articles published in a specific time range."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "data": {
   "type": "array",
   "items": {
    "type": "object",
    "required": [
     "title",
     "link"
    ],
    "properties": {
     "link": {
      "type": "string",
      "description": "Canonical URL of the article."
     },
     "title": {
      "type": "string",
      "description": "Headline of the news article."
     },
     "authors": {
      "type": "array",
      "items": {
       "type": "string",
       "description": "A single author name."
      },
      "nullable": true,
      "description": "Author names credited on the article."
     },
     "snippet": {
      "type": "string",
      "nullable": true,
      "description": "Short excerpt of the article body."
     },
     "photo_url": {
      "type": "string",
      "nullable": true,
      "description": "URL of the article's lead image."
     },
     "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": "URL of the article's thumbnail image."
     },
     "related_topics": {
      "type": "array",
      "items": {
       "type": "object",
       "required": [
        "topic_id",
        "topic_name"
       ],
       "properties": {
        "topic_id": {
         "type": "string",
         "description": "Google News topic ID."
        },
        "topic_name": {
         "type": "string",
         "description": "Topic display name."
        }
       }
      },
      "nullable": true,
      "description": "Related Google News topics surfaced for the article."
     },
     "source_logo_url": {
      "type": "string",
      "nullable": true,
      "description": "URL of the source publisher's logo."
     },
     "source_favicon_url": {
      "type": "string",
      "nullable": true,
      "description": "URL of the source publisher's favicon."
     },
     "source_publication_id": {
      "type": "string",
      "nullable": true,
      "description": "Google News publication ID of the source."
     },
     "published_datetime_utc": {
      "type": "string",
      "nullable": true,
      "description": "ISO 8601 UTC datetime of original publication."
     }
    }
   },
   "description": "News article results matching the search query."
  },
  "stat
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agents-openwebninja-com-openweb-ninja-real-time-news-search-1ba5da78/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)