{"uid":"cap_cvwbImU0csIQyXPnCqSpZ","slug":"x402-fun-joke-api-b7396a34","name":"x402 Fun Joke API","description":"A random family-friendly joke with setup and punchline as separate fields, written for this service (133 jokes), optionally from one category: dad, programming, ai, science, math, animals, food, work, crypto. Give id to get one joke again.","url":"https://fun.kagurazaka.dev/v1/joke?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","properties":{"id":{"type":"string","description":"a joke's id, such as programming-1, to get it again"},"category":{"enum":["dad","programming","ai","science","math","animals","food","work","crypto"],"type":"string","description":"only this category"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"id":{},"text":{},"setup":{},"category":{},"punchline":{}}}}}}},"responseSchema":{"type":"json","example":{"id":"programming-1","text":"Why do programmers prefer dark mode? Because light attracts bugs.","setup":"Why do programmers prefer dark mode?","category":"programming","punchline":"Because light attracts bugs."}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","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.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_HzOoybhNz4YEKblfZCG-x","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a random family-friendly joke with separate setup and punchline fields, optionally filtered by category or fetched by ID","exampleAgentPrompt":"Tell me a random programming joke — give me the setup and punchline separately.","exampleUseCases":[{"title":"Dad joke for daily newsletter","prompt":"Grab me a random dad joke with the setup and punchline split out — I want to drop it into today's newsletter."},{"title":"Repeat a specific joke","prompt":"Can you fetch that programming joke with ID programming-1 again from the joke service? I want to reuse it."},{"title":"Category joke for chatbot response","prompt":"I need a funny AI-themed joke with a setup and punchline to inject into the chatbot's welcome message — pull one from the ai category."}],"resultDescription":"A JSON object containing a unique joke ID (e.g. 'programming-1'), the full joke text, the setup line, the punchline, and the category it belongs to.","failureModes":["Invalid category value returns an error — only the nine specified enum values are accepted","Invalid or non-existent joke ID returns an error or empty result","No jokes available matching filters (unlikely given fixed pool of 133)","Payment failure results in 402 response before any joke is returned"],"whenToPreferThis":"Choose this endpoint when you need a structured joke with setup and punchline as separate fields — ideal for templated displays, chatbot responses, or newsletters. Prefer it over generic joke APIs when you want category filtering across niche topics like crypto, AI, or programming, or when you need to reliably re-fetch a specific joke by ID. Best for lightweight, family-friendly humor in agentic or automated workflows.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-31T18:38:58.168Z","isFirstParty":false,"canonicalSlug":"x402-fun-joke-api-b7396a34"}