Jokes API
Around 680 English jokes — general, programming, puns, knock-knock, Christmas and more — as one-liners or setup and punchline. Jokes flagged as unsafe or offensive are excluded.
Quick start
curl "https://jokes.quiply.net/v1/random?category=programming" \
-H "X-API-Key: YOUR_KEY"Authentication
Every request must include your key in the X-API-Key header. You get your key instantly on the pricing section. Keep it secret — don't put it in public front-end code.
Base URL: https://jokes.quiply.net
GET/v1/random
Random jokes, optionally filtered.
| Parameter | Type | Description |
|---|---|---|
category | string | e.g. general, programming, pun (see /v1/categories) |
type | string | single (one line) or twopart (setup and punchline) |
count | integer | 1–20 (default 1) |
{ "count": 1, "jokes": [ { "id": 48, "category": "general", "type": "twopart",
"setup": "Why do chicken coops only have two doors?", "punchline": "Because if they had four, they would be chicken sedans." } ] }Single-line jokes have a joke field instead of setup and punchline.
GET/v1/jokes
Browse jokes by category and/or type.
| Parameter | Type | Description |
|---|---|---|
category | string | e.g. general, programming, pun (see /v1/categories) |
type | string | single (one line) or twopart (setup and punchline) |
limit | integer | 1–100 (default 25) |
offset | integer | Skip this many results |
GET/v1/search
Search joke text (q required, minimum 2 characters; optional category, type, limit, offset).
GET/v1/categories
Categories with joke counts by type.
GET/v1/health
Service status and dataset size. No key needed.
Errors
| Status | Meaning |
|---|---|
| 401 | Missing or invalid X-API-Key |
| 403 | Subscription inactive (cancelled or payment failed) |
| 404 | No jokes match the filters |
| 422 | Bad parameter (e.g. invalid type) |
| 429 | Quota reached for your plan |
Pricing
Free trial: 5 requests/day. All APIs plan: $9.95/month gives you every Quiply API, 250,000 requests a month.
Get your API key