# OpenWebNinja Local Headlines API

> OpenWebNinja Local Headlines API 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 local news headlines filtered by keyword query, country, and language

## Facts

- Endpoint: GET https://x402.openwebninja.com/realtime-news-data/local-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-local-headlines-api-e87ad692
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_PlzNOxF-jE7oyx4r_n6If

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-local-headlines-api-e87ad692
```

Example prompt: Can you pull up to 10 recent local news headlines from the US about wildfires in English? I need the title, source, and a short snippet for each.

## When to prefer this

Choose this endpoint when you need real-time local news headlines filtered by a keyword query, optionally scoped to a specific country and language. It is best suited for agents building news feeds, monitoring local coverage of a topic, or summarizing current events in a particular locale. It returns rich metadata including images and related topics, making it suitable for display-ready news aggregation. Prefer it over generic web search when structured news article metadata is required.

## Known failure modes

- Empty results array when query matches no recent local articles
- HTTP 402 if payment header is missing or USDC balance is insufficient
- Rate limiting or throttling if called too frequently
- Truncated results if limit exceeds 500
- Missing optional fields (authors, snippet, photo_url) for some articles when not available from source

## 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 an array of news article objects each containing a headline title, canonical article URL, optional snippet/excerpt, author names, source publisher name and URL, lead photo and thumbnail image URLs, and related Google News topic IDs and names.

## Request schema (JSON Schema)

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

## Response schema (JSON Schema)

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

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/openwebninja-local-headlines-api-e87ad692/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)
