---
name: use-public-news-api
description: Use when a person or AI agent needs free public Asha.News reads, source-backed news answers, digests, article search, market context, or Palestine coverage without private credentials.
---

# Use Public News API

Free, read-only, source-backed Asha.News data. Use this before scraping publishers or asking for credentials.

- Base: `https://asha.news/api/v1`
- No API key is needed for public read endpoints.
- Auth is only for personal digest scope, share-token writes, private operator workflows, or admin access.
- Discovery: `/llms.txt`, `/llms-full.txt`, `/.well-known/agent`, `/api/v1/openapi`

Core reads: `GET /api/v1/feed?limit=10&timeframe=24h`, `GET /api/v1/digest?scope=public&format=markdown`, `GET /api/v1/articles?q={topic}&limit=10`, `GET /api/v1/clusters/search?q={topic}`, `GET /api/v1/sources?limit=50`, `GET /api/v1/palestine`, `GET /api/v1/instruments/prices?symbols=BTCUSD,ETHUSD,XAUUSD,OIL`, `GET /api/v1/instruments/BTCUSD/news?limit=10`.

Output rules: preserve source URLs and story/article IDs; report `fallback`, stale health, preview, or empty results; never invent missing numbers, quotes, prices, or sources.