{ "opencollection": "1.0.0", "info": { "name": "Joke Jokes API", "version": "2.3.3" }, "items": [ { "info": { "name": "Jokes", "type": "folder" }, "items": [ { "info": { "name": "JokeAPI Get Joke by Category", "type": "http" }, "http": { "method": "GET", "url": "https://v2.jokeapi.dev/joke/:category", "params": [ { "name": "category", "value": "Programming", "type": "path", "description": "Category or comma-separated list of categories. Use `Any` to draw from all categories." }, { "name": "format", "value": "json", "type": "query", "description": "Response format. Defaults to `json`." }, { "name": "lang", "value": "en", "type": "query", "description": "ISO 639-1 language code for the joke language. Supported jokes languages include `en`, `de`, `cs`, `es`, `fr`, `pt`. Defaults to `en`." }, { "name": "blacklistFlags", "value": "nsfw,racist,sexist", "type": "query", "description": "Comma-separated list of flags to exclude (`nsfw`, `religious`, `political`, `racist`, `sexist`, `explicit`). Any joke carrying at least one listed flag is filtered out." }, { "name": "type", "value": "twopart", "type": "query", "description": "Restrict results to a single joke type." }, { "name": "contains", "value": "developer", "type": "query", "description": "URL-encoded substring that must appear in the joke text (or the setup/delivery of a twopart joke)." }, { "name": "idRange", "value": "0-50", "type": "query", "description": "Inclusive ID range (e.g. `0-50`) or a single ID (e.g. `42`) to constrain results." }, { "name": "amount", "value": "1", "type": "query", "description": "Number of jokes to retrieve (1-10). Defaults to 1." }, { "name": "safe-mode", "value": "", "type": "query", "description": "When present (no value required), exclude any joke that carries any flag and any joke categorised as Dark." } ] }, "docs": "Retrieve one or more jokes from a single category, a comma-separated list of categories, or the special value `Any`. Supports filtering by blacklist flags, joke type, language, ID range, contains-text search, amount, and safe-mode." }, { "info": { "name": "JokeAPI Submit Joke", "type": "http" }, "http": { "method": "POST", "url": "https://v2.jokeapi.dev/submit", "params": [ { "name": "format", "value": "json", "type": "query", "description": "Response format. Defaults to `json`." }, { "name": "dry-run", "value": "", "type": "query", "description": "When present, the submission is validated for shape but not persisted. No value is required." } ], "body": { "type": "json", "data": "{}" } }, "docs": "Submit a joke for moderator review. Submissions are rate-limited separately at 5 per minute per IP. Pass `?dry-run` to validate the payload structure without persisting the submission." } ] } ], "bundled": true }