{"openapi":"3.1.0","info":{"title":"Acutis Reader","version":"1.1.0","description":"Extract a readable article from supplied HTML, including title, author, language, metadata, clean Markdown, links and tables. Uses Mozilla Readability with a fallback for short pages. No remote fetches or script execution; URLs resolve relative links. Price: 0.02 USDC per operation on Base mainnet via x402 v2. Empty unsigned POSTs inspect payment and discovery metadata only; empty signed requests are rejected before verification or settlement. Docs and one fixed example are free. No API key or wallet private key is sent to this service. JSON artifact envelopes carry base64 bytes, MIME type, size and SHA-256; decode bytes to save the file."},"servers":[{"url":"https://reader.acutisignatius.com"}],"paths":{"/v1/articles/extract":{"post":{"operationId":"readerWork","summary":"Clean article text, Markdown and tables.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"html":{"type":"string","minLength":1,"maxLength":250000},"url":{"default":"https://example.com/article","type":"string","format":"uri"},"include_tables":{"default":true,"type":"boolean"}},"required":["html"],"additionalProperties":false},"example":{"url":"https://example.com/notes/launch","html":"<!doctype html><html lang=\"en\"><head><title>Launch notes</title><meta name=\"description\" content=\"Release handoff notes\"></head><body><nav>Home | Pricing | Contact</nav><article><h1>Launch notes</h1><p>The release is ready for review. The deployment checklist includes payment verification, public documentation, and customer support handoff.</p><p>Each service has a clear contract and a working example. The team will monitor errors, latency, and successful settlement receipts throughout the first week.</p><h2>Milestones</h2><table><tr><th>Task</th><th>Status</th></tr><tr><td>Payment verification</td><td>Complete</td></tr></table><p>Read the <a href=\"/checklist\">full checklist</a> before approving the release.</p></article><footer>Copyright Example</footer></body></html>"}}}},"responses":{"200":{"description":"Markdown + text + tables + links; only released after successful settlement","content":{"application/json":{"schema":{"type":"object","properties":{"title":{"type":["string","null"]},"author":{"type":["string","null"]},"description":{"type":["string","null"]},"language":{"type":["string","null"]},"source_url":{"type":"string"},"extraction":{"enum":["readability","article-or-body-fallback"]},"markdown":{"type":"string"},"text":{"type":"string"},"word_count":{"type":"integer","minimum":0},"estimated_reading_minutes":{"type":"integer","minimum":0},"links":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string"},"url":{"type":"string"}},"required":["text","url"],"additionalProperties":true}},"tables":{"type":"array","items":{"type":"object","properties":{"caption":{"type":["string","null"]},"rows":{"type":"array","items":{"type":"array","items":{"type":"string"}}}},"required":["caption","rows"],"additionalProperties":true}}},"required":["title","author","description","language","source_url","extraction","markdown","text","word_count","estimated_reading_minutes","links","tables"],"additionalProperties":true},"examples":{"fixed":{"summary":"Actual fixed example response","externalValue":"/v1/example"}}}}},"402":{"description":"x402 payment required. Retry exact input with PAYMENT-SIGNATURE."},"409":{"description":"Proof bound to another request or already processing"},"422":{"description":"Input, schema or processing limit invalid; no payment requested"},"429":{"description":"Instance capacity exhausted; Retry-After; no payment requested"},"503":{"description":"Work or facilitator unavailable; no protected result"}}}},"/v1/example":{"get":{"summary":"One fixed free example; query parameters do not customize it","responses":{"200":{"description":"Markdown + text + tables + links","content":{"application/json":{"schema":{"type":"object","properties":{"title":{"type":["string","null"]},"author":{"type":["string","null"]},"description":{"type":["string","null"]},"language":{"type":["string","null"]},"source_url":{"type":"string"},"extraction":{"enum":["readability","article-or-body-fallback"]},"markdown":{"type":"string"},"text":{"type":"string"},"word_count":{"type":"integer","minimum":0},"estimated_reading_minutes":{"type":"integer","minimum":0},"links":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string"},"url":{"type":"string"}},"required":["text","url"],"additionalProperties":true}},"tables":{"type":"array","items":{"type":"object","properties":{"caption":{"type":["string","null"]},"rows":{"type":"array","items":{"type":"array","items":{"type":"string"}}}},"required":["caption","rows"],"additionalProperties":true}}},"required":["title","author","description","language","source_url","extraction","markdown","text","word_count","estimated_reading_minutes","links","tables"],"additionalProperties":true}}}}}}},"/health":{"get":{"responses":{"200":{"description":"Service, network and price"}}}}}}