Developer API

Authentication

Create a key on the API keys page (requires a Supporter subscription or an API plan). Send it with every request:

curl -H "Authorization: Bearer <key>" \
  "https://objective-news.org/api/v1/stories?scope=WORLD&take=20"

# or: -H "x-api-key: <key>"

Endpoints

GET /api/v1/stories                     ?scope=WORLD|NATIONAL  &country=SI  &order=recent|sources|views  &take (<=100)  &offset
GET /api/v1/stories/{slug}              ?locale=en|sl|de|hr|it|es|fr   — detail: synthesis, outlets, claims
GET /api/v1/stories/{slug}/spectrum     ?locale=…                      — left/center/right framing of the event
GET /api/v1/stories/{slug}/crossborder  ?locale=…                      — the same event covered in other countries
GET /api/v1/sources                     ?country=SI                    — outlet directory: ownership type + editorial lean

Plans, limits & headers

The monthly quota is per account (across all keys, calendar month, UTC); the per-minute limit is per key. Subscribe or upgrade on the pricing page. Every response carries the current limits:

X-RateLimit-Limit:      requests/minute for your plan
X-RateLimit-Remaining:  remaining this minute
X-Quota-Limit:          requests/month for your plan
X-Quota-Remaining:      remaining this month
Retry-After:            seconds to wait (on 429 rate_limited only)

Errors

Errors are JSON: { "error": "...", "code": "..." } — match on code, the message text may change.