Overview
Humor API provides jokes, memes, and humorous content across dozens of categories, making it easy to add comedy to apps, bots, and games. You need a free API key from humorapi.com to make requests. It supports filtering by type, category, and content safety flags like minRating.
Beginner Tip
Use the minRating parameter (0-10) to filter out low-quality jokes, and set the include-tags or exclude-tags parameters to keep content appropriate for your audience.
Available Data
The kind of data this API exposes, based on its documentation. We could not call the endpoint to confirm the exact field names.
Example Response
Illustrative shape only — we were not able to call this endpoint (it requires credentials or exposes no public sample URL), so the fields below show the kind of data this API returns rather than a recorded response.
{
"error": false,
"category": "Programming",
"type": "twopart",
"setup": "Why do programmers prefer dark mode?",
"delivery": "Because light attracts bugs.",
"id": 42,
"lang": "en"
} Field Reference
id Unique numeric identifier for the joke. joke The full joke text; for two-part jokes this includes both setup and punchline. rating Community rating from 0 to 10 indicating joke quality. type Format of the joke, such as single or twopart. setup The setup part of a two-part joke (present when type is twopart). punchline The punchline of a two-part joke (present when type is twopart). Implementation Example
Calls a real endpoint of this API. Replace any placeholder credentials with your own key.
const url = "https://api.humorapi.com/jokes/random?api-key=YOUR_API_KEY&minRating=7";
// Replace headers or query params with the values required by this API.
const response = await fetch(url, {
headers: {
"X-API-Key": "YOUR_API_KEY"
}
});
if (!response.ok) throw new Error(`Request failed: ${response.status}`);
const data = await response.json();
console.log(data); What Can You Build?
Note: These code examples are AI-generated and unverified. Always refer to the official API documentation for accurate usage.
Common Errors & Troubleshooting
Generated guidance based on this API's documentation, not observed by us. Treat it as a starting point and check against the provider's own error reference.
Metadata Score Breakdown
Estimated from metadata — endpoint not independently tested
Metadata estimate · endpoint not independently tested
Technical Specifications
Related Tags
Similar APIs
View All →Brawl Stars
The Brawl Stars API provides official game data including player profiles, club info, battle logs, and brawler statistics.
Clash of Clans
The Clash of Clans API provides official data on players, clans, clan wars, leagues, and rankings from Supercell's hit mobile strategy game.
Clash Royale
The Clash Royale API offers official data on players, clans, cards, battles, and tournaments from Supercell's card-battle mobile game.
Destiny The Game
The Destiny The Game API (Bungie Platform API) gives developers access to data from the popular Destiny franchise, including player stats, character info, and game content.
Dota 2
The Dota 2 API (OpenDota) provides detailed match history, hero statistics, player rankings, and game data for the popular MOBA game Dota 2.