API Documentation
Getting Started
The JokeToday API provides programmatic access to our daily jokes. All API requests require an API key that you can request below.
Rate Limit: 100 requests per day per API key
Authentication
Include your API key in the request header:
x-api-key: YOUR_API_KEYEndpoints
GET /api/joke
Get today's joke for a specific category
Query Parameters: category (optional, default: safe-for-work)
curl -H "x-api-key: YOUR_API_KEY" \ https://joketoday.com/api/joke?category=dad-jokes
GET /api/joke/random
Get a random joke
Query Parameters: category (optional)
curl -H "x-api-key: YOUR_API_KEY" \ https://joketoday.com/api/joke/random
GET /api/joke/:date
Get joke for a specific date (YYYY-MM-DD)
Query Parameters: category (optional, default: safe-for-work)
curl -H "x-api-key: YOUR_API_KEY" \ https://joketoday.com/api/joke/2025-10-05
GET /api/categories
List all available joke categories
curl https://joketoday.com/api/categories
GET /api/health
Check API health status
curl https://joketoday.com/api/health
Categories
- elementaryKid-friendly jokes with simple vocabulary
- middle-schoolPre-teen appropriate humor
- high-schoolTeen appropriate jokes
- dad-jokesClassic dad humor
- safe-for-workOffice-appropriate humor
- not-safe-for-workAdult humor (not vulgar)
- marriage-jokesRelationship and marriage humor
- your-mom-jokesClassic "your mom" insult comedy
- your-sister-jokesPlayful "your sister" humor
- knock-knock-jokesTraditional knock-knock format