{"uid":"cap_E-xkIfB-GP1BOSROS6ksk","slug":"forgemesh-library-full-text-search-dbfe10fa","name":"ForgeMesh Library Full-Text Search","description":"Full-text search across the entire indexed public-domain corpus. Returns the most relevant passages from any book with title/author citations, ranked by relevance. The premium cross-corpus retrieval route — no LLM generation, real excerpts with sources. No license, no API key required.","url":"https://library.forgemesh.io/literature-search","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-09-15T12:33:23.122Z","isFirstParty":false}