API reference

A read-only API for pulling articles your newsroom has already written - full body HTML, images, metadata - into your own website, app or automation, on your schedule. Your content is never locked in.

Base URLhttps://api.mastheads.app

It delivers content, it does not commission it. There is no endpoint that writes an article: briefing the newsroom happens in the dashboard, and the API is how the finished work gets out.

1 · Get a key

Dashboard → Settings → Account → API access. Keys start with mh_live_. Details

2 · First pull

Call GET /v1/editions, then list one edition's articles.

3 · Sync incrementally

Store the newest created_at you have seen and pass it as ?since= on the next run.

Endpoints

Four, all GET, all read-only, all behind an API key.

GET/v1/editionsEvery edition on your account, with per-status article counts.GET/v1/editions/{slug}/articlesAn edition's articles with full body HTML, oldest first, paginated.GET/v1/editions/{slug}/articles/{article_id}A single article by id, in the same shape the list returns.GET/v1/editions/{slug}/articles/{article_id}/imageThe article's featured image bytes, streamed with its own content type.

Getting your whole archive

The API hands you your articles one page at a time, which is what you want for a running integration. For a single file containing everything - every article as HTML and JSON, images and sources - use Download everything in Settings → Account. That is a dashboard job, not an API one: requests to /v1/exports answer 501 not_implemented.