{"uid":"cap_FpSMtihEBWp9G576NWeOo","slug":"library-forgemesh-io-humor-shelf-2c3df056","name":"library.forgemesh.io Humor Shelf","description":"Curated shelf: Humor — 161 public-domain books including The Man Upstairs and Other Stories, Miss Mapp, Comic History of the United States. Returns a ranked list with drill-down routes for full-text retrieval. No license, no API key required.","url":"https://library.forgemesh.io/humor","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"limit":{"type":"integer","description":"Max books to return (default 20, max 50)"}}},"responseSchema":{"type":"json","example":{"books":[{"year":null,"title":"The Man Upstairs and Other Stories","author":"Wodehouse, P. G. (Pelham Grenville)","book_id":6768,"subjects":[],"download_count":26011}],"count":5,"shelf":"Humor","coverage":{"target":61015,"indexed":61015},"drill_down":["/book-metadata","/book-chapter","/book-quotes","/literature-search"]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.003","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.003/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_9P__afWNr97ha3hBdi8ly","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.003","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a ranked list of up to 161 public-domain humor books with drill-down routes for full-text retrieval","exampleAgentPrompt":"Can you pull up a list of classic humor books from the public domain library — give me the top 30 titles with links to read the full text?","exampleUseCases":[{"title":"Curating a humor reading list","prompt":"I'm putting together a reading list of classic public-domain comedy books — can you fetch me up to 40 titles from the humor shelf so I can pick the best ones?"},{"title":"Finding vintage American comedy writing","prompt":"I want to read some old American humor writing that's free and out of copyright — can you show me what's on the humor shelf, up to 25 books?"},{"title":"Populating a library app with comedy titles","prompt":"I'm building a reading app and need a catalog of public-domain humor books with their full-text routes — grab me the top 50 from the humor shelf."}],"resultDescription":"A ranked list of up to 161 public-domain humor books (default 20, max 50 per call), each with metadata and drill-down routes that can be used to retrieve the full text of individual titles. Titles include works like The Man Upstairs and Other Stories, Miss Mapp, and Comic History of the United States.","failureModes":["limit parameter exceeds 50 — likely returns an error or is clamped","payment not processed (x402) — request blocked without valid USDC payment","server unavailable — no results returned","empty response if shelf index is temporarily unavailable"],"whenToPreferThis":"Choose this endpoint when you need a curated, ranked list of public-domain humor and comedy books with navigation routes for full-text access. Prefer it over a general full-text search when the user wants to browse or discover humor titles rather than search for a specific passage or topic. It is especially useful for building reading lists, populating catalogs, or exploring the humor genre in public-domain literature.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T19:02:24.676Z","isFirstParty":false}