# Random Joke by Category and Language

> Random Joke by Category and Language is a paid API for AI agents from flat-rate-llm.kikoribera03.workers.dev, paid per call via x402, $0.0025/call, status unknown (last checked 2026-09-15).

Returns a single random joke in English or Spanish, filterable by category (programming, crypto, or general), with deduplication support via seen-ID exclusion and a seed for reproducibility.

## Facts

- Endpoint: POST https://flat-rate-llm.kikoribera03.workers.dev/v1/content/joke
- Price: $0.0025/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/random-joke-by-category-and-language-25847113
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_4Aop_aBl3a0BwTShqHIYP

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability random-joke-by-category-and-language-25847113 -d '<json body>'
```

Example prompt: Give me a random programming joke in English — and skip IDs 'j001' and 'j002' since I've already seen those.

## When to prefer this

Choose this endpoint when you need jokes with fine-grained control: category filtering (programming, crypto, or general), bilingual support (English or Spanish), deduplication via ID exclusion, and reproducibility via seed. It is better than generic one-liner APIs when you need to avoid repeating jokes across sessions or guarantee the same joke for a given key.

## Known failure modes

- Invalid category value returns an error or empty result
- Invalid language code falls back to 'en' or returns an error
- Excluding all available IDs for a category may return no joke or an error
- Malformed exclude list (bad format for GET) may cause a 400 error
- Network timeout from the Cloudflare Workers runtime
- Payment not included or invalid x402 payment header results in 402 response

## How this service works

60 paid endpoints with no metering, no API key and no account. Each endpoint has one flat price per call, whatever the size of the request: LLM completions with automatic failover across several large models, read-only EVM tooling over Base, Ethereum, Polygon, Arbitrum and Optimism, and pure crypto utilities that touch no network.

## Output

Returns a JSON object containing the joke's unique ID, the joke text, the category it belongs to, the language it's in, and the total number of jokes available in that category — allowing the caller to track seen jokes and paginate through the collection.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "seed": {
   "type": "string",
   "description": "Same seed always returns the same joke."
  },
  "exclude": {
   "type": "array",
   "description": "Ids already seen, comma-separated in a GET."
  },
  "category": {
   "type": "string",
   "description": "programming | crypto | general. Omit for any."
  },
  "language": {
   "type": "string",
   "description": "en | es. Defaults to en."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "id": {
   "type": "string"
  },
  "joke": {
   "type": "string"
  },
  "total": {
   "type": "number"
  },
  "category": {
   "type": "string"
  },
  "language": {
   "type": "string"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/random-joke-by-category-and-language-25847113/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from flat-rate-llm.kikoribera03.workers.dev](https://www.zero.xyz/host/flat-rate-llm.kikoribera03.workers.dev/llms.txt)