# OpenWebNinja Realtime Top Headlines News

> OpenWebNinja Realtime Top Headlines News is a paid API for AI agents from x402.openwebninja.com, paid per call via x402, $0.003/call, status unknown (last checked 2026-09-15).

Fetches real-time top news headlines filtered by country and language, returning article titles, links, snippets, authors, and related sub-articles

## Facts

- Endpoint: GET https://x402.openwebninja.com/realtime-news-data/top-headlines
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/openwebninja-realtime-top-headlines-news-70a1771c
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_HtucjfJqw9vG7TkM2-gCj

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 openwebninja-realtime-top-headlines-news-70a1771c
```

Example prompt: Can you grab the top 20 news headlines in English right now, filtered to US news, with article links and snippets?

## When to prefer this

Choose this endpoint when you need real-time top headlines (not historical or topic-specific search) across a broad country or language filter, and want structured article metadata including sub-articles and related topics. Prefer this over generic search APIs when you need aggregated top-story rankings with rich metadata like source logos, author lists, and related topic taxonomies.

## Known failure modes

- Invalid country or language code returns empty results or error
- Limit exceeding 500 is rejected with a validation error
- No headlines available for a niche country/language combination returns an empty data array
- Payment of 0.003 USDC not fulfilled results in 402 Payment Required
- Rate limits or upstream news provider outage return 5xx errors

## How this service works

40+ public web-data, SERP, e-commerce, real-estate, finance and AI-search APIs, payable per call over x402 (USDC on Base, Polygon, Arbitrum). No account or API key required. Most endpoints $0.003; AI-model endpoints $0.005.

## Output

Returns a JSON array of up to 500 news articles, each containing a title, link, optional snippet, authors list, photo URL, thumbnail URL, source name and URL, source logo/favicon URLs, related topics (with IDs and names), published datetime in UTC, and nested sub-articles with their own titles, links, sources, and related topics.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "properties": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {}
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/openwebninja-realtime-top-headlines-news-70a1771c/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.openwebninja.com](https://www.zero.xyz/host/x402.openwebninja.com/llms.txt)