For Tinkerers Developer Reference

The Thiccctionary

For Tinkerers ยท Developer Reference

Developer API

Programmatic access to Thiccctionary entries. Build a Slack bot, a Discord notifier, a desk display, an RPi e-paper sign, a daily Stripe internal-tools widget, anything. Free, CORS-open, no auth required.

Endpoints

GET /api/today

Returns today's entry as JSON. Updates once per day around 13:00 UTC when the cron pipeline ships a new entry.

curl https://thiccctionary.com/api/today

{
  "date": "2026-05-04",
  "word": "Sofa, Chesterfield",
  "pronunciation": "/CHOOS-ter-feeld/",
  "partOfSpeech": "n.",
  "definitions": [
    "A capacious upholstered seating apparatus..."
  ],
  "etymology": "From the Earl of Chesterfield...",
  "example": "...",
  "image": {
    "url": "https://thiccctionary.com/images/2026-05-04.jpg",
    "caption": "...",
    "credit": "..."
  },
  "tags": ["furniture", "upholstery", "opulence"],
  "url": "https://thiccctionary.com/entries/2026-05-04.html"
}

GET /api/random

Returns one random entry from the archive as JSON. Same shape as /api/today. Cache-Control: no-store.

curl https://thiccctionary.com/api/random

GET /data/entries.json

The full archive as a single JSON array, sorted descending by date. This is the source of truth, both /api/today and /api/random read from it. Use this if you want to mirror the catalog or run analytics over it.

POST /api/rate

Image-rating classifier. POST a JSON body with either imageUrl (remote URL) or imageDataUrl (base64 data URL). Returns a verdict with rating, commentary, and closest archive match. Refuses photographs of people.

curl -X POST https://thiccctionary.com/api/rate \
  -H 'content-type: application/json' \
  -d '{"imageUrl": "https://example.com/fire-hydrant.jpg"}'

RSS feeds

Per-tag feeds appear automatically when a tag reaches 2+ entries. Stale feeds are cleaned up when their tags drop below threshold.

Rate limits and fair use

The read endpoints (/api/today, /api/random, RSS, and /data/entries.json) are cached aggressively at the edge. Hammer them all you want, they cost us nothing.

The classifier (/api/rate) hits OpenAI's API, which we pay for per call. Browser-side users are capped at 5 ratings per day in localStorage. Programmatic clients should self-limit similarly. We may impose server-side limits later if abuse appears.

Embed widget

If you don't want to call the API yourself, drop our iframe widget on your site and let it render today's entry for you.

Show us what you build

If you ship something interesting, tag @thiccctionary on X or DM @ogthiccctionary on Instagram. We will plausibly retweet or repost.

All endpoints stable and free. Strictly things, never people.