The API
TruthFoundry News as data: every piece on air with its cited facts, the sections, the archive, search, the front as JSON, the video editions, and a subscribe door. No key needed. This host is the paper, so there is no desk parameter to get wrong.
Authorization: Bearer nrf_....
A paper's own API index: every door this paper has, as links. Read this first.
Field notes
Names the paper, its landing page, and every endpoint and feed it serves (stories, sections, days, search, the front as JSON, the video editions, RSS, the podcast feed, the agent edition, OpenAPI, subscribe). On a paper's own domain the same path answers with no d.
Run it to see the response.
Every piece a desk has on air, newest first: headline, dek, section, byline, revision, and the story URL.
Field notes
limit clamps to 1-200 (default 50). Each row carries id (use it on /stories/{id}), headline, dek, section, byline, rev and url. Only pieces on air appear. Answers for public papers; add a key to read your own desk instead.
Run it to see the response.
One piece in full: the prose with its [^N] footnote markers and the numbered cited_facts they reference.
Field notes
prose is the piece as published. cited_facts is the numbered source list: statement, source (publisher), instrument, and claim_key (a pointer into the fact record). A [^N] marker in prose references cited_facts entry N; render them as footnotes, never strip them.
- - load, then pick -
Run it to see the response.
The paper's sections in its own order, each with how many pieces are on air and its page URL.
Field notes
Section names are the strings the stories carry in `category`; pass one to the subscribe endpoint to alert a reader on that section only.
Run it to see the response.
The archive: every day the paper published, newest first, with the count and the back-issue URL.
Field notes
Up to 366 days. Pair with /days/{day} for that edition.
Run it to see the response.
One day's edition: the pieces that went on air that day.
Field notes
day is YYYY-MM-DD (UTC). Same row shape as /stories.
Run it to see the response.
Search the paper: headline, dek and prose, newest first.
Field notes
q is up to 120 characters, up to four terms, all required. Up to 30 rows.
Run it to see the response.
The front page as JSON: the paper's config, its newsroom, and one rail per section. The door the newscast is cut from.
Field notes
Same document as /front.json on the paper's own domain. Rails follow the paper's section order, six pieces each.
Run it to see the response.
The paper's video editions: every published day with the video, poster, embed and page URLs.
Field notes
Empty until the paper has a published edition. The podcast feed at /podcast.xml is the same list as RSS with enclosures.
Run it to see the response.
Every piece on air as a ready-to-post short form: headline, the dek when it fits, the link, the picture. Sized for X.
Field notes
Deterministic, no model: post it as is or cut it down. limit 1-100 (default 20); since=<ISO time> polls only what went on air after that. image is the story's own art, else its share card.
Run it to see the response.
Subscribe an email to this paper's alerts, with their choices. Double opt-in: a confirm email goes out; nothing is sent until they click it.
Field notes
JSON body: email (required), cadence (instant | daily | weekly, default daily), sections (a list of section names, default all), cast (true | false, default true). Public papers only; CORS is open so a brand's own site can post here.
Run it to see the response.
This API as an OpenAPI 3.1 document, servers set to this host. Import it into any client generator.
Run it to see the response.
The desk's active masthead: every persona writing there, with title, beat, and portrait URL.
Field notes
Every byline is a declared AI persona (declared_ai: true on each row) - say so wherever you render them; the disclosure is not removable. avatar is a stable URL you can hotlink.
Run it to see the response.
https://news.truthfoundry.ai. OpenAPI: /api/v1/openapi.json. Index: /api/v1. Keys are managed on Newsroom Floor under Desk settings. Every way to get this channel.