{"uid":"cap_-nTDgPVOIu59GkwRArdRZ","slug":"library-forgemesh-io-book-metadata-lookup-309bac70","name":"library.forgemesh.io Book Metadata Lookup","description":"Look up full metadata for one indexed book by book_id: title, author, year, subjects, bookshelves, download rank, chunk count, and detected chapter range. Use book_id from /book-search or a category shelf. No license, no API key required.","url":"https://library.forgemesh.io/book-metadata","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"book_id":{"type":"integer","description":"Gutenberg book id, e.g. 1342 for Pride and Prejudice"}}},"responseSchema":{"type":"json","example":{"year":"1998","title":"Pride and Prejudice","author":"Austen, Jane, 1775-1817","book_id":1342,"subjects":["Courtship -- Fiction","England -- Fiction"],"bookshelves":["Category: Novels","Best Books Ever Listings"],"chunk_count":973,"chapter_range":[0,61],"download_count":59636,"chapter_detection":"heading","chapters_available":62}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","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.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_EBPfc8qn4eQCnldyXXw0z","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns full metadata for a single indexed public-domain book by its Gutenberg book ID, including title, author, year, subjects, bookshelves, download rank, chunk count, and chapter range.","exampleAgentPrompt":"Can you pull up the full metadata for Gutenberg book 1342 — I want to see the title, author, year, subjects, download rank, and how many chapters it has?","exampleUseCases":[{"title":"Bibliographic enrichment before citation","prompt":"I'm building a reading list and I need the author, publication year, subjects, and bookshelves for Gutenberg book 84 — can you fetch that metadata so I can cite it correctly?"},{"title":"Pre-fetch chunk planning for full-text retrieval","prompt":"Before I start pulling text passages from Gutenberg book 2701, can you get its metadata so I know the chunk count and chapter range to plan my queries?"},{"title":"Book discovery follow-up after search","prompt":"I got book ID 11 back from a search — can you look up its full details including title, author, download rank, and what subjects and bookshelves it belongs to?"}],"resultDescription":"A structured object containing the book's title, author name, publication year, list of subjects, list of bookshelves, historical download rank, total chunk count (for text retrieval planning), and the detected chapter range (start and end chapter numbers).","failureModes":["book_id not found in indexed corpus — returns error or empty result","book_id is not an integer — schema validation failure","book exists on Gutenberg but has not been indexed by this service — no result returned","payment not processed (x402) — request blocked before reaching lookup logic"],"whenToPreferThis":"Use this endpoint when you have a specific Gutenberg book_id (from /book-search or a category shelf) and need full bibliographic metadata before reading or citing the book. Prefer this over a general web search when you need structured fields like chunk count, bookshelves, and download rank that are specific to this indexed corpus.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:40:42.422Z","isFirstParty":false}