INDB API
Free, read-only JSON. No key needed. Please cache what you fetch and link back to INDB.
Endpoints
| Path | What it returns |
|---|---|
/api/v1/stories | Top stories. Parameters: edition, category, page, size (up to 60), blindspot (left or right), min_sources, order (rank or newest). |
/api/v1/stories/{id} | One story with every article, its outlets' ratings, the timeline, people and places, and related stories. |
/api/v1/sources | Every outlet with lean, reliability, owner and country. Parameters: q, lean, country. |
/api/v1/sources/{slug} | One outlet, with where each rating came from. |
/api/v1/trending | Names and sections that are rising right now. |
/api/v1/search?q= | Stories matching a search. |
/api/v1/meta | The section and edition codes. |
/rss, /rss?c=world | RSS feed of top stories, or of one section. |
Example
curl "https://indb.co/api/v1/stories?edition=uk&category=politics&size=5"
Lean bands, blind spots and reliability follow the rules on How we score.