{"uid":"cap_E-xkIfB-GP1BOSROS6ksk","slug":"forgemesh-library-full-text-search-dbfe10fa","name":"ForgeMesh Library Full-Text Search","description":"Search the indexed public-domain corpus for complete source passages with title, author, section, passage indices, and Gutenberg links. Results rank up to 400 matching candidates, not every corpus match. Retrieval only, no generated answer. Common question words are removed; remaining terms must match together.","url":"https://library.forgemesh.io/literature-search?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"limit":{"type":"integer","description":"Max results (default 10, max 30)"},"query":{"type":"string","description":"Free-text search query, e.g. \"the nature of justice\""}}},"responseSchema":{"type":"json","example":{"count":1,"query":"whale hunting","results":[{"title":"Frankenstein; or, the modern prometheus","author":"Shelley, Mary Wollstonecraft, 1797-1851","book_id":84,"passage":"…I accompanied the [whale]-fishers on several expeditions…","citation":"Frankenstein; or, the modern prometheus by Shelley, Mary Wollstonecraft, 1797-1851 — passage #1201"}],"coverage":{"target":1000,"indexed":865}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","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.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_8B7n7DULRUidnDy4q0CUB","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Full-text search across an indexed public-domain book corpus, returning ranked relevant passages with title and author citations — no LLM generation, real excerpts only.","exampleAgentPrompt":"Search the ForgeMesh public-domain library for the best passages about the nature of justice — give me up to 15 results with the book title and author for each excerpt.","exampleUseCases":[{"title":"Literary research on a theme","prompt":"I'm writing an essay on the concept of fate in classical literature — can you search the public-domain library for the most relevant passages about fate and destiny, and give me up to 20 results with their sources?"},{"title":"Finding a half-remembered quote","prompt":"I vaguely remember a passage from a classic novel about a man standing at the edge of the sea feeling completely alone — can you search the public-domain book corpus for something matching that and show me the top 10 results?"},{"title":"Gathering philosophical excerpts","prompt":"Pull the most relevant passages from classic public-domain books on the idea of virtue and moral character — I need real excerpts with author and title citations, up to 25 results."}],"resultDescription":"A ranked list of up to 30 relevant text passages from indexed public-domain books, each accompanied by the book title and author name, ordered by relevance to the query. No AI-generated text — all results are real excerpts from the source texts.","failureModes":["Query too vague returns low-relevance or unrelated passages","Limit exceeds maximum of 30 — clamped or rejected","Missing or empty query field causes a validation error","Payment of $0.02 USDC not sent or rejected — returns 402 Payment Required","No matching passages found for a highly specific or obscure query — empty results returned"],"whenToPreferThis":"Choose this endpoint when you need real, sourced text excerpts from classic public-domain literature rather than AI-generated summaries or paraphrases. It is ideal for citation-heavy research, literary analysis, or finding authentic quotes across a broad corpus. Prefer it over title/author search endpoints when the user knows a theme or concept but not the specific book, and over curated shelf endpoints when the query spans multiple genres or domains.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-30T06:32:08.088Z","isFirstParty":false,"canonicalSlug":"forgemesh-library-full-text-search-dbfe10fa"}