Jokes One API

Name: Jokes One API
Brand: Jokes One API
Availability: InStock

✓ Official Vendor SpecMediaContent DeliveryapiKey12 EndpointsREST

For Agents

Fetch the daily Joke of the Day, search and pull random jokes by category or keyword, and (for subscribers) manage joke entries and tags so agents can drop a joke into chat, email, or a UI surface.

Install Jentic One Beta

Connect the Jokes One API to your agent

Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Jokes One 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 Jokes One API.

Fetch the current Joke of the Day or filter it by category

List jokes from the catalogue with category and keyword filters

Pull a single random joke for chatbot or daily-message use

Search jokes by free-text keyword or by category metadata

GET STARTED

Start building with Jokes One API

Explore with Jentic

View OpenAPI Document

Use Cases

Patterns agents use Jokes One API for, with concrete tasks.

★ Daily-joke Slack bot

Workplace bots that post a daily light-hearted message can pull the Joke of the Day each morning and post it into a designated channel. GET /jod returns a single curated joke with category metadata, so the bot can format the message and choose an appropriate channel. The simple GET-only flow makes this a 10-minute integration for any chat bot.

Call GET /jod each weekday at 9:00, format the response title and body, and post it to the #general Slack channel

Chatbot small-talk filler

Conversational agents handling customer support or onboarding can lean on a random-joke endpoint to lighten queues and humanise small-talk moments. GET /joke/random returns a single joke per call with no parameters required. Categorical filters can keep the humour aligned with the product's brand voice.

Call GET /joke/random with category=clean to fetch a random joke and inject it into the chatbot's small-talk response slot

Themed content widget

Editorial sites or apps with topical content (e.g., a coffee blog, a sports site) can run keyword-driven joke widgets that pull a few jokes matching the page topic. GET /joke/search with a keyword returns a list which the front-end can rotate. Combined with category metadata, this surfaces relevant jokes alongside the main content without manual curation.

Call GET /joke/search?query=coffee to list matching jokes, then render the top three in the page's sidebar widget

Agent-driven daily humour via Jentic

An AI assistant configured to brighten user check-ins can call jokes.one through Jentic without requiring its own API key. The agent expresses intent ('tell me a joke'), Jentic resolves to GET /joke/random, injects the X-JokesOne-Api-Secret header from the vault, and returns the joke text. This keeps the subscriber key out of agent prompts and lets one credential serve many agent flows.

Use Jentic to search 'get a random joke', load GET /joke/random, and execute it to return a clean joke for the user's check-in

Key Endpoints

12 endpoints — jokes one is a content service that publishes a curated catalogue of jokes, including a daily joke of the day and a searchable archive across multiple categories.

METHOD

PATH

DESCRIPTION

GET

/jod

Get the Joke of the Day

GET

/jod/categories

List Joke of the Day categories

GET

/joke/random

Get a random joke

GET

/joke/search

Search jokes by keyword

GET

/joke/list

List jokes from the catalogue

GET

/joke/categories/search

Search jokes by category

POST

/joke/tags/add

Add tags to a joke (subscriber)

POST

/joke/tags/remove

Remove tags from a joke (subscriber)

GET

/jod

Get the Joke of the Day

GET

/jod/categories

List Joke of the Day categories

GET

/joke/random

Get a random joke

GET

/joke/search

Search jokes by keyword

GET

/joke/list

List jokes from the catalogue

GET

Why Jentic?

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

Credential isolation

The X-JokesOne-Api-Secret key is stored encrypted in the Jentic vault. The header is injected at request time and never appears in the agent's prompt, log, or chat history.

Intent-based discovery

Agents search Jentic with phrases like 'tell a joke' or 'joke of the day' and Jentic returns the matching jokes.one operation with its input schema, so the agent doesn't have to consult the developer portal.

Time to first call

Direct jokes.one integration: under an hour for a single endpoint. Through Jentic: a few minutes — search and execute, no key management needed.

FAQs

Specific to using Jokes One API through Jentic.

What authentication does the Jokes One API use?

The Jokes One API uses an API key passed in the X-JokesOne-Api-Secret header. Public endpoints like GET /jod are usable anonymously; the subscriber endpoints (joke management and tag operations) require a valid key. Jentic stores the key encrypted and injects it on each request.

Can I get the Joke of the Day for free?

GET /jod is the public Joke of the Day endpoint and is callable without a subscription. GET /jod/categories returns the available daily categories, so you can request a specific theme if the day's catalogue supports it.

What are the rate limits for the Jokes One API?

Rate limits are tied to subscription tier on jokes.one — the spec does not publish numeric limits. Treat the API as low-volume for free use; check the dashboard at jokes.one/api/joke/ for paid-tier throughput.

How do I get a random joke through Jentic?

Search Jentic for 'get a random joke', load GET /joke/random, and execute it. Jentic returns the joke title and body, and the X-JokesOne-Api-Secret header is injected automatically. Sign up at https://app.jentic.com/sign-up.

Can I add or remove tags on a joke?

Yes, but only for subscribers. POST /joke/tags/add and POST /joke/tags/remove modify the tag set on a joke entry. These endpoints reject unauthenticated requests, so the API key must be present.

How do I search jokes by category?

Use GET /joke/categories/search with a category name to pull jokes filtered by that taxonomy entry. For free-text search across joke bodies, use GET /joke/search with a query parameter instead.