Approved articles straight into your CMS, one format for all.
The output API delivers every approved article as JSON with text blocks, HTML or Markdown, from the morning format to the analysis. With sync by change time, Swagger docs and key protection.
What you can do with it
- Fetch all approved articles, filtered by format, format family, symbol, ISIN and time range.
- Pull only what changed since the last call, and recognise withdrawn articles so you can unpublish them.
- Get the text as structured blocks, as HTML or as Markdown, price widgets and instruments included.
- Request images at the width you need, with credit and alt text.
- Hand developers the docs as a Swagger page and let them try calls right there.
- See in the preview what a consumer receives, without a key.
- As an admin, create keys with a label and revoke them one by one. A new key is shown exactly once.
The thinking behind it
The first version only knew running text. A structured format like the DAX pre-market report arrived empty, and tables didn’t arrive at all. Instead of building an endpoint per format, there is now one contract: every article is a sequence of blocks, and the receiving system decides whether it wants blocks, HTML or Markdown.
A CMS doesn’t ask “give me everything”, it asks “what changed since a moment ago?”. So the API pages through a cursor by change time, and withdrawn articles stay visible as withdrawn, so they disappear from the website too.
Only reading goes out, deliberately, through lean fields of its own rather than the internal documents. That keeps the contract stable even when things change inside.
A CMS doesn’t ask “give me everything”, it asks “what changed since a moment ago?”
Improvements
Create keys instead of typing them
In the settings you create a key with a label and copy it straight away, because it is shown only this once. The list shows label, the start of the key and creation date, and each key can be revoked on its own.
Version 1 delivers approved articles only
The older version 1 now also hands out news only after approval; withdrawn articles are missing from list and detail. Analyses flagged by the follow-up check no longer appear in its list. The news list names the instrument with name and ISIN, like the detail.
The settings describe version 2
The “Public API” tab walks through version 2 with base URL, Swagger link and a sample call. Version 1 sits alongside as the legacy version, for calendar events, earnings and directors' dealings, which only it offers.
Swagger docs behind the production path
“Try it out” in the Swagger docs also works behind the path production runs under.
Time range and format filters
Time range by date, time or Unix time. Formats and families can be included or excluded. The Swagger docs are available in production too.
Key as a URL parameter
The key can also be passed as a URL parameter, for a quick test in the browser.
Output API v2
One format for all articles, approval state, sync by change time and a preview in the app.
Articles with an archive image
Articles come with a matching archive image at a width of your choice, with credit and alt text.
Give feedback or ask a question
Missing something, bothered by something, unsure about something? Write it down here — it goes straight to the people working on this feature.
Or write to us right here: