{"uid":"cap_4Aop_aBl3a0BwTShqHIYP","slug":"random-joke-by-category-and-language-25847113","name":"Random Joke by Category and Language","description":"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.","url":"https://flat-rate-llm.kikoribera03.workers.dev/v1/content/joke","method":"POST","headers":{},"bodySchema":{"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."}}},"responseSchema":{"type":"object","properties":{"id":{"type":"string"},"joke":{"type":"string"},"total":{"type":"number"},"category":{"type":"string"},"language":{"type":"string"}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.0025","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.0025/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0025","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0025","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_2yNlq1_irNUovuP-DoaZ4","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.0025","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"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.","exampleAgentPrompt":"Give me a random programming joke in English — and skip IDs 'j001' and 'j002' since I've already seen those.","exampleUseCases":[{"title":"Crypto humor for a newsletter bot","prompt":"Fetch me a random crypto joke in English — I need something fresh for today's newsletter, so exclude IDs 'c101', 'c102', and 'c103' that I used before."},{"title":"Spanish programming joke for a Slack bot","prompt":"Get me a random programming joke in Spanish so I can post it to my team's Slack channel."},{"title":"Reproducible joke for a daily digest","prompt":"Give me today's general joke using the seed 'monday-digest-2024-06-10' so it's the same for everyone who opens the digest today."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T18:56:39.827Z","isFirstParty":false}