Humor API

Name: Humor API
Brand: Humor API
Availability: InStock

★ Only Publicly Available OpenAPI DocumentMediaContent DeliveryapiKey16 EndpointsREST

For Agents

Search jokes, memes, and GIFs, generate insults or praise, and rate the funniness of words for chat, content, and entertainment agents.

Install Jentic One Beta

Connect the Humor API to your agent

Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Humor API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.

Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.

Step 1: Jentic One Host machine

# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh

Step 2: Agent machine

# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register       # connects your agent to your Jentic One instance

Jentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.

Capabilities

What an agent can do with Humor API.

Search jokes by keyword, tag, or content rating across the Humor API catalogue

Retrieve a random joke or meme filtered by category, language, or maximum length

Generate a personalised praise or insult line addressed to a named recipient

GET STARTED

Start building with Humor API

Explore with Jentic

View OpenAPI Document

Jentic publishes the only available OpenAPI specification for Humor API, keeping it validated and agent-ready. Humor API delivers programmatic access to a curated catalogue of jokes, memes, and animated GIFs, plus generative endpoints for praise, insults, and nonsense words. It exposes 16 endpoints covering joke search and retrieval by tags or keywords, meme and GIF lookup, joke voting, joke analysis with sentiment and category scoring, and word funniness rating. Authentication is performed with an api-key passed as a query parameter on every request.

Use Cases

Patterns agents use Humor API for, with concrete tasks.

★ Conversational Chatbot Humour

Inject jokes, memes, and witty replies into a chatbot or virtual assistant by querying Humor API for content matched to user keywords or topics. The /jokes/search and /jokes/random endpoints support filtering by tag, exclude-tag, content rating, and length so the bot only surfaces appropriate material. Integration takes under an hour through Jentic and adds a steady stream of fresh content without curation overhead.

Call /jokes/random with include-tags=clean and max-length=200 and return the joke text to the user.

Social Content Scheduling

Power a content scheduler that posts daily memes or one-liners by pulling random items from /memes/random or /jokes/random and routing them to social platforms. Filters on keywords, rating, and language let teams keep brand voice consistent. Combined with a posting API like Buffer or a Twitter client, the workflow can be fully automated through Jentic-mediated calls.

Fetch one /memes/random with keywords=monday and post the returned image URL to a scheduled tweet.

Word and Joke Analysis Tooling

Build internal tooling for comedy writers, copywriters, or game designers that scores the funniness of candidate words via /words/rate and analyses joke drafts via /jokes/analyze for sentiment and category. Useful for A/B testing taglines or grading user submissions in a humour app. Each call returns structured numeric scores rather than free text.

Send the candidate tagline to /jokes/analyze and return the sentiment and category fields to the user.

AI Agent Entertainment Plugin

Give an AI agent a callable tool for entertainment and small-talk responses without baking jokes into the prompt. Through Jentic the agent searches for the operation 'find a random joke', loads the input schema, and executes against /jokes/random with parameters chosen at runtime. The api-key never enters the agent context and the agent receives only the structured response payload.

Search Jentic for 'tell a random joke', load the Humor API random joke schema, and execute with include-tags=clean.

Key Endpoints

16 endpoints — jentic publishes the only available openapi specification for humor api, keeping it validated and agent-ready.

METHOD

PATH

DESCRIPTION

GET

/jokes/search

Search jokes by keyword and tag filters

GET

/jokes/random

Retrieve a random joke matching filters

GET

/memes/random

Retrieve a random meme matching filters

GET

/gif/search

Search animated GIFs by keyword

GET

/praise

Generate a praise line for a named recipient

GET

/insult

Generate an insult line for a named recipient

GET

/words/rate

Return a funniness rating for a word

POST

/jokes/analyze

Analyse a joke for sentiment and category

GET

/jokes/search

Search jokes by keyword and tag filters

GET

/jokes/random

Retrieve a random joke matching filters

GET

/memes/random

Retrieve a random meme matching filters

GET

/gif/search

Search animated GIFs by keyword

GET

/praise

Generate a praise line for a named recipient

Why Jentic?

Three things that make agents converge on Jentic-routed access.

Credential isolation

The Humor API key is stored encrypted in the Jentic vault. Agents receive a scoped reference and Jentic injects the api-key query parameter at execution time, so the raw key never enters the agent's context or logs.

Intent-based discovery

Agents search Jentic by intent (e.g., 'find a random joke') and Jentic returns the matching Humor API operation along with its input schema, removing the need to browse vendor docs.

Time to first call

Direct integration with Humor API: half a day to wire up auth, parameter validation, and error handling. Through Jentic: under 30 minutes — search, load, execute.

FAQs

Specific to using Humor API through Jentic.

Why is there no official OpenAPI spec for Humor API?

Humor API does not publish an OpenAPI specification. Jentic generates and maintains this spec so that AI agents and developers can call Humor API via structured tooling. It is validated against the live API and kept up to date. Get started at https://app.jentic.com/sign-up.

What authentication does the Humor API use?

The Humor API uses an API key passed as the api-key query parameter on every request. Through Jentic the key is stored in the credential vault and never enters the agent context — the agent receives a scoped reference and Jentic injects the key at execution time.

Can I generate a personalised insult or praise line with the Humor API?

Yes. The /insult and /praise endpoints accept a name parameter and return a single generated line addressed to that recipient. They are GET endpoints so they fit cleanly into chatbot reply flows and require only the api-key query parameter.

What are the rate limits for the Humor API?

The OpenAPI spec does not declare numeric rate limits. Humor API tiers its rate limits by paid plan on the vendor dashboard, so check your plan at humorapi.com for the exact requests-per-day allowance before scaling agent traffic.

How do I get a random meme through Jentic?

Search Jentic for 'get a random meme', load the schema for the Humor API /memes/random operation, and execute with optional keywords, media-type, and min-rating parameters. Install with pip install jentic and call the async search, load, and execute methods to run the request.

Can I score how funny a word is with the Humor API?

Yes. The /words/rate endpoint accepts a single word and returns a numeric funniness rating. It is useful for ranking candidate names, taglines, or game words and runs as a simple GET call with the api-key query parameter.