API Reference

Access daily nomination digests programmatically. Base URL: https://nominaday.com/api/v1

Authentication

All /api/v1 endpoints require an API key in the Authorization header. Generate your key from your dashboard.

Authorization: Bearer nd_your_api_key_here

Rate limits: 60 req/min per key. Daily quota: 1,000 req/day (free) · 10,000 req/day (Pro). Responses include Retry-After when rate-limited.

Digests

GET/api/v1/digest/{country}/todayAPI KEYPRO

Returns today's nomination digest for the specified country. Pro subscribers receive full content and parsed nominations array; free accounts receive gated: true with null content.

{
  "object": "digest",
  "country": { "slug": "fr", "name": "France", "language": "fr" },
  "date": "2026-06-12",
  "title": "Nominations du jour — Vendredi 12 juin",
  "nominations": [
    { "name": "Jean Dupont", "role": "Directeur général", "organization": "Ministère de l'Économie" }
  ],
  "content_md": "## Nominations du jour\n...",
  "gated": false,
  "cached_at": "2026-06-12T07:00:00Z"
}

GET/api/v1/digest/{country}/{date}API KEYPRO

Returns archived digest for a specific date (YYYY-MM-DD). Requires Pro subscription — returns 403 for free accounts.

{
  "object": "digest",
  "country": { "slug": "it", "name": "Italia", "language": "it" },
  "date": "2026-06-10",
  "title": "Nomine del giorno — Martedì 10 giugno",
  "content_md": "## Nomine del giorno\n...",
  "cached_at": "2026-06-10T07:00:00Z"
}

Entities

GET/api/v1/entities?q={query}&limit={n}API KEY

Search available countries/editions. q is optional (returns all if omitted). limit defaults to 20, max 100.

{
  "object": "list",
  "data": [
    { "type": "country", "slug": "fr", "name": "France", "language": "fr", "active": true },
    { "type": "country", "slug": "it", "name": "Italia", "language": "it", "active": true }
  ],
  "count": 2
}

API Key Management

GET/api/apikeysAPI KEY

List all API keys for your account (authenticated via session cookie, use from dashboard).

POST/api/apikeysAPI KEY

Generate a new API key. Optionally pass { "name": "My integration" } in the body. The plaintext key is shown only once.

{
  "id": 1,
  "name": "My integration",
  "key": "nd_abc123...",
  "created_at": "2026-06-12T10:00:00Z",
  "note": "Save this key — it will not be shown again."
}

DELETE/api/apikeys?id={id}API KEY

Delete an API key by ID. The key is immediately revoked.

Error codes

400Bad request — invalid parameters

401Unauthorized — missing or invalid API key

403Forbidden — Pro subscription required

404Not found — country or digest not available

422Unprocessable — limit reached (e.g. max 5 keys)

429Rate limit exceeded — check Retry-After header

502Upstream error — Sentinel unavailable

Supported countries

fr France — Nominations du Jour

it Italia — Nomine del Giorno

More countries coming soon. Query /api/v1/entities for the live list.

Quick start

# Get today's digest for France
curl -H "Authorization: Bearer nd_your_key" \
  https://nominaday.com/api/v1/digest/fr/today

# Search entities
curl -H "Authorization: Bearer nd_your_key" \
  "https://nominaday.com/api/v1/entities?q=ital"

Questions? api@nominaday.com — Get your API key →