canonical: https://jentic.com/apis/humorapi.com/humorapi

# Humor API

The Humor API searches and generates humorous content, covering jokes, memes, and gifs. It can search or return random jokes and memes, search gifs, create and analyze jokes, generate insults and praise, rate how funny a word is, and produce nonsense words. Requests authenticate with an API key passed as the 'api-key' query parameter.

## For AI agents

Search or generate jokes, memes, and gifs through the Humor API, plus create and analyze jokes, generate insults and praise, and rate word funniness.

## Scope

Does not host user accounts or moderate submitted content beyond upvote and downvote counts. Use for searching and generating jokes, memes, gifs, and related humor content only.

## Capabilities

- Search for jokes or return a random joke
- Search memes or return a random meme
- Search gifs by keyword
- Create a new joke or analyze an existing one
- Generate an insult or a praise line
- Rate how funny a word is or generate a nonsense word

## Use cases

### Agent-Generated Humor in Conversations

A chat or social agent drops a joke, meme, or gif into a conversation to keep it light. The Humor API returns random or keyword-matched jokes, memes, and gifs, so an agent can pull relevant humorous content on demand through Jentic rather than shipping a static list.

Example prompt: Search for a meme matching a keyword and return its image URL

### Playful Insult and Praise Generation

A game or bot needs a lighthearted insult or a compliment on demand. The Humor API generates an insult or praise line, optionally personalized with a name, so an agent can produce a one-off quip without a content library.

Example prompt: Generate a playful insult addressed to a given name

### Joke Analysis and Curation

A content tool wants to vet or classify jokes before posting them. The Humor API analyzes a joke and rates word funniness, so an agent can screen submitted jokes and keep the funniest ones.

Example prompt: Analyze a submitted joke and return its rating and detected type

## Key endpoints

| Method | Path | Description |
| --- | --- | --- |
| GET | `/jokes/random` | Get a random joke |
| GET | `/jokes/search` | Search jokes |
| POST | `/jokes/analyze` | Analyze a joke |
| GET | `/memes/search` | Search memes |
| GET | `/gif/search` | Search gifs |
| GET | `/insult` | Generate an insult |
| GET | `/praise` | Generate praise |
| GET | `/words/rate` | Rate a word's funniness |

## Key resources

- **Jokes** — Search, retrieve, create, analyze, and vote on jokes
- **Memes** — Search or return random memes and vote on them
- **Gifs** — Search gifs by keyword
- **Text Generators** — Generate insults, praise, and nonsense words and rate word funniness

## Why Jentic

- **Setup:** Wiring the Humor API by hand means appending your api-key to every request as a query parameter and mapping its search, generation, and voting endpoints yourself. Through Jentic you install once, import the Humor API from the Directory, store the key once, and your agent calls it.
- **Permission scoping:** The Humor API carries the key in the query string rather than a resource path, so rules govern which operations your agent may call, not which content. You choose those operations, so you can allow searching jokes and memes while leaving out submitting or voting on them.
- **Credential handling:** Your Humor API key is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context.
- **Discovery method:** Agents search Jentic by intent such as 'get a random joke' or 'search for memes', and Jentic returns the matching operation with its input schema so the agent calls the right endpoint.

## Related APIs

- **Jokes One API** — Jokes One serves a curated joke-of-the-day and categorized jokes, an alternative when the agent needs jokes but not memes or gifs.
- **GIPHY API** — GIPHY offers a large gif search and trending library, complementing the Humor API when an agent needs richer gif results.
- **Memegen API** — Memegen generates custom meme images from templates and captions, pairing with the Humor API's meme search for creating rather than finding memes.

## FAQ

### What authentication does the Humor API use?

The Humor API authenticates with an API key passed as the 'api-key' query parameter, per its OpenAPI spec. Through Jentic the key is stored encrypted by your own Jentic One instance and injected when your agent calls the API.

### Is there a Humor API MCP server?

You don't need an MCP server to give your agent the Humor API. Jentic connects it directly from the API Directory: import it, store your key once, and your agent searches jokes, memes, and gifs as it needs to. Nothing extra is loaded into the agent's context until a call is made.

### Can I limit what my agent is allowed to do with the Humor API?

Yes. You choose which of the 16 operations your agent may call, so you can allow the search and random endpoints while leaving out the ones that submit or vote on content. Every call it makes is logged for review.

### Can I generate a personalized insult with the Humor API?

Yes. The insult operation returns a playful insult and can take a name and a reason, so an agent can address the quip to a specific person.

### How do I get a random joke through Jentic?

Search Jentic for 'get a random joke', which returns the random-joke operation with its input schema. Add the Humor API from the Jentic API Directory, store your api-key once, and your agent can pull jokes, memes, and gifs. To run it on your own infrastructure, install Jentic One from its GitHub repo.