# Perigon News API – Stories Search

> Perigon News API – Stories Search is a paid API for AI agents from gateway.apiosk.com, paid per call via x402, $0.12/call, status unknown (last checked 2026-09-15).

Search AI-clustered news stories and summaries filtered by topic, entity, location, and time via the Apiosk pay-per-call gateway.

## Facts

- Endpoint: GET https://gateway.apiosk.com/perigon/stories/all
- Price: $0.12/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/perigon-news-api-stories-search-eeeee608
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_MP-qgqyQNip4XcsE8XP-N

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 perigon-news-api-stories-search-eeeee608
```

Example prompt: Find me AI-clustered news stories about the US-China trade war from the past week, grouped by story so I can see how each narrative is developing.

## When to prefer this

Prefer this endpoint when you need news already grouped into coherent story clusters with AI-generated summaries, rather than raw individual articles. It is especially valuable when tracking how a story evolves across multiple sources or when you need a quick narrative overview rather than raw article feeds. Choose it over generic NewsAPI when you specifically want the clustering and summarization layer that Perigon provides.

## Known failure modes

- Missing or invalid API key / payment failure via x402 returns 402 Payment Required
- Overly broad query returns too many clusters with low relevance
- Time range too narrow returns empty result set
- Unsupported entity or location format returns zero matches
- Rate limiting or gateway timeout on high-traffic queries

## How this service works

Search AI-clustered news stories and summaries by topic, entity, location and time filters.

## Output

Returns a collection of AI-clustered news story groups, each containing a summary, related articles, entities mentioned, publication timestamps, source metadata, and topic/location tags relevant to the search filters applied.

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/perigon-news-api-stories-search-eeeee608/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)