Slangora API v1

Read-only HTTP/JSON API over slangora's 37,000+ curated EN slang terms. Free tier: 1,000 requests/day per key. All responses cached at the edge for 5 minutes.

Authentication

Every request must carry an API key. Get one at /admin/api-keys (admin login required for now; self-serve registration ships v100).

Pass the key via header (preferred) or query string:

# Header (preferred)
curl -H "X-Slangora-Key: <your_key>" https://slangora.com/api/v1/terms?page=1

# Query string
curl "https://slangora.com/api/v1/terms?api_key=<your_key>&page=1"

Rate limits

Free tier: 60 requests/minute, 1,000 requests/day
Daily counter resets at 00:00 UTC
Exceeding the daily cap returns 429 Too Many Requests
Every response includes X-Slangora-Daily-Remaining + X-Slangora-Tier headers so you can monitor usage

Endpoints

GET/api/v1/terms?page=1&page_size=20&letter=r&category=&generation=&platform=&sort=top

Paginated list of EN terms. Filters mirror /explore.

GET/api/v1/term/<slug>

Full term JSON: word, audio_url, definitions ranked by score, metadata.

GET/api/v1/search?q=<query>&limit=20

Prefix + substring search across slug and word.

GET/api/v1/random?count=1

N random EN terms. count capped at 50.

GET/api/v1/word-of-day

Today's Word of the Day.

GET/api/v1/trending?limit=20

Top trending terms by recent view velocity.

Example response

{
  "slug": "rizz",
  "word": "rizz",
  "url": "https://slangora.com/word/rizz",
  "pronunciation": "/rɪz/",
  "audio_url": "https://.../rizz.mp3",
  "first_attestation_year": 2021,
  "generation_tag": "gen-z",
  "platform_origin": "twitch",
  "category": { "slug": "internet", "name": "Internet & Memes" },
  "definitions": [
    { "definition": "...", "register": "informal", "score": 27, ... }
  ]
}