▶ API DOCUMENTATION

DEVELOPER API

Access daily oddities programmatically.

⚠️ COMING SOON · NOT YET LIVE

PLANNED ENDPOINTS

GET/api/oddities

Returns paginated list of all oddities.

{
  "oddities": [...],
  "total": 1247,
  "page": 1,
  "per_page": 20
}

GET/api/oddities/today

Returns today's featured oddity.

GET/api/oddities/random

Returns a random oddity from the archive.

GET/api/categories

List all available categories with counts.

GET/api/oddities/:id

Get a specific oddity by ID.

▶ AUTHENTICATION

The API will require an API key passed in the Authorization header:

curl -H "Authorization: Bearer YOUR_API_KEY" \
     https://discordantnote.com/api/oddities

Free tier: 100 requests/hour, 1,000/day. Higher limits available.

WANT EARLY ACCESS?

The API isn't live yet, but we're building a waitlist for early access.

Loved by the curious.