← All features
SetupIn the app: /app/einstellungen?tab=public-api

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

  1. 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.

  2. 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.

  3. 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.

  4. Swagger docs behind the production path

    “Try it out” in the Swagger docs also works behind the path production runs under.

  5. 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.

  6. Key as a URL parameter

    The key can also be passed as a URL parameter, for a quick test in the browser.

  7. Output API v2

    One format for all articles, approval state, sync by change time and a preview in the app.

  8. 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.

Send feedback by emailOpens your mail app with a message to info@storyfab.de.

Or write to us right here:

What is this about?

Only needed if you want an answer.