# NewsAPI Top Headlines

> NewsAPI Top Headlines is a paid API for AI agents from gateway.apiosk.com, paid per call via x402, $0.03/call, status unknown (last checked 2026-09-14).

Fetches top news headlines filtered by keyword, country, and/or category via the NewsAPI service

## Facts

- Endpoint: GET https://gateway.apiosk.com/newsapi/top-headlines
- Price: $0.03/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/newsapi-top-headlines-af5e4e36
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_oIEbYt5D0dEXztHY5NDH-

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 newsapi-top-headlines-af5e4e36
```

Example prompt: Can you get me the top news headlines in the US for the technology category right now?

## When to prefer this

Use this endpoint when you need current, real-time top news headlines filtered by country, topic keyword, or category. Prefer it over general web search when you specifically want structured news article metadata (title, source, URL, date) from established news outlets rather than raw web results.

## Known failure modes

- Invalid or unsupported country code returns empty results or error
- Category value not in accepted enum list causes bad request
- No results found for very niche keyword queries
- Rate limiting or payment failure returns 402 or 429 error
- API key or gateway authentication issues return 401/403

## How this service works

Breaking headlines by country, category or keyword.

## Output

Returns a list of top news headline articles matching the query, country, and/or category filters. Each article typically includes a title, source name, description, publication date, and URL to the full article.

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/newsapi-top-headlines-af5e4e36/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from gateway.apiosk.com](https://www.zero.xyz/host/gateway.apiosk.com/llms.txt)