News

List recent headlines

Changed on

Newest-first headlines, optionally filtered by category. Cursor-paginate by passing the previous response's next_before + next_before_id back as before + before_id. The last 14 days for every caller; with API Pro, paging on with the cursor keeps going back through the archive.

get/api/articles

Request

Query parameters

categorystring

Category slug (see /api/categories). Omit for all categories.

limitinteger

Items to return; clamped to 1–100.

group'article' | 'story'

story lists each story once, at its newest article, with story_size. Omit to list every article.

afterstring date-time

Only articles published after this time. Within the last 14 days for every caller; earlier needs API Pro (403 otherwise).

beforestring date-time

ISO 8601 cursor; pass next_before from the previous page.

before_idstring uuid

Tuple-cursor companion to before (pass next_before_id).

Response

OK

countinteger required
next_beforestring date-time nullable

Pass as before for the next page; null at the tail.

next_before_idstring uuid nullable
noticestring

No longer sent: it was on answers to requests without a key, which were answered until 2 October 2026.

Changes