{"uid":"cap_f8lh68PAgnAYSkFJDTN6Z","slug":"library-forgemesh-io-poetry-shelf-dea751f4","name":"library.forgemesh.io Poetry Shelf","description":"Curated shelf of public-domain poetry collections, ranked by historical popularity. Returns title, author, year, book_id, and drill-down routes for full-text retrieval of individual poems and passages. No license, no API key required.","url":"https://library.forgemesh.io/poetry","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":"1998","title":"The Raven","author":"Poe, Edgar Allan, 1809-1849","book_id":1065,"subjects":["American poetry"],"download_count":8000}],"count":5,"shelf":"Poetry","coverage":{"target":1000,"indexed":865},"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_zHs0eVA-JvxZnPCGOILZN","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 public-domain poetry collections with title, author, year, book ID, and drill-down routes for full-text retrieval.","exampleAgentPrompt":"Can you pull up a list of the top 20 most popular public-domain poetry collections available on the forgemesh library — I want the titles, authors, and years so I can pick one to explore?","exampleUseCases":[{"title":"Curating poetry reading list","prompt":"Show me up to 30 classic poetry collections available in the public domain, ranked by popularity — I want the titles, authors, and years so I can put together a reading list."},{"title":"Building poetry exploration tool","prompt":"Give me the top 10 public-domain poetry books along with their IDs and any links I can use to drill down into individual poems — I'm building a reading app."},{"title":"Discovering classic poetry authors","prompt":"What are the most historically popular public-domain poetry collections? Show me up to 25 so I can see which poets come up most often."}],"resultDescription":"A ranked list of public-domain poetry collections, each including the book title, author name, publication year, a unique book_id, and drill-down routes that can be used to retrieve individual poems or passages from that collection.","failureModes":["limit exceeds maximum of 50 — API may return an error or cap silently at 50","network or payment failure via x402 protocol results in no response","empty result set if the indexed poetry corpus is unavailable or being reindexed","malformed request body returns a validation error"],"whenToPreferThis":"Choose this endpoint when you need a curated, ranked catalog of public-domain poetry books with identifiers that enable further full-text retrieval. It is ideal for discovery workflows where you want to browse available poetry titles before drilling into individual poems. Prefer this over general web search when you need structured, machine-readable metadata (title, author, year, book_id) rather than raw HTML pages.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:44:55.336Z","isFirstParty":false}