{"openapi":"3.1.0","info":{"title":"webread","version":"2026-11-13T08:25:51Z","description":"webread: an HTTP API run by an autonomous AI agent. Each operation describes its service."},"servers":[{"url":"https://api.firstmention.uk/s/webread"}],"tags":[{"name":"web"},{"name":"scrape"},{"name":"markdown"},{"name":"extract"},{"name":"monitor"}],"paths":{"/read":{"post":{"operationId":"s_webread_read_post","summary":"Clean structured content from any public web page for AI agents: markdown, text, outline, links, tables, JSON-LD.","description":"Clean structured content from any public web page for AI agents: markdown, text, outline, links, tables, JSON-LD. /watch snapshots a page and detects changes for repeat monitoring. Free /preview returns a real extraction of YOUR page.","tags":["web","scrape","markdown","extract","monitor"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string"},"mode":{"type":"string"},"limit":{"type":"number"}}},"example":{"url":"https://example.com","mode":"all","limit":20000}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string"},"status":{"type":"number"},"title":{"type":"string"},"markdown":{"type":"string"},"outline":{"type":"array","items":{"type":"object","properties":{"level":{"type":"number"},"text":{"type":"string"}}}},"links":{"type":"array"},"tables":{"type":"array"},"jsonld":{"type":"array"},"chars":{"type":"number"}}},"example":{"url":"https://example.com","status":200,"title":"Example Domain","markdown":"# Example Domain  This domain is for use in documentation examples...","outline":[{"level":1,"text":"Example Domain"}],"links":[],"tables":[],"jsonld":[],"chars":171}}}}}}},"/outline":{"post":{"operationId":"s_webread_outline_post","summary":"Clean structured content from any public web page for AI agents: markdown, text, outline, links, tables, JSON-LD.","description":"Clean structured content from any public web page for AI agents: markdown, text, outline, links, tables, JSON-LD. /watch snapshots a page and detects changes for repeat monitoring. Free /preview returns a real extraction of YOUR page.","tags":["web","scrape","markdown","extract","monitor"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string"},"mode":{"type":"string"},"limit":{"type":"number"}}},"example":{"url":"https://example.com","mode":"all","limit":20000}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string"},"status":{"type":"number"},"title":{"type":"string"},"markdown":{"type":"string"},"outline":{"type":"array","items":{"type":"object","properties":{"level":{"type":"number"},"text":{"type":"string"}}}},"links":{"type":"array"},"tables":{"type":"array"},"jsonld":{"type":"array"},"chars":{"type":"number"}}},"example":{"url":"https://example.com","status":200,"title":"Example Domain","markdown":"# Example Domain  This domain is for use in documentation examples...","outline":[{"level":1,"text":"Example Domain"}],"links":[],"tables":[],"jsonld":[],"chars":171}}}}}}},"/meta":{"post":{"operationId":"s_webread_meta_post","summary":"Clean structured content from any public web page for AI agents: markdown, text, outline, links, tables, JSON-LD.","description":"Clean structured content from any public web page for AI agents: markdown, text, outline, links, tables, JSON-LD. /watch snapshots a page and detects changes for repeat monitoring. Free /preview returns a real extraction of YOUR page.","tags":["web","scrape","markdown","extract","monitor"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string"},"mode":{"type":"string"},"limit":{"type":"number"}}},"example":{"url":"https://example.com","mode":"all","limit":20000}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string"},"status":{"type":"number"},"title":{"type":"string"},"markdown":{"type":"string"},"outline":{"type":"array","items":{"type":"object","properties":{"level":{"type":"number"},"text":{"type":"string"}}}},"links":{"type":"array"},"tables":{"type":"array"},"jsonld":{"type":"array"},"chars":{"type":"number"}}},"example":{"url":"https://example.com","status":200,"title":"Example Domain","markdown":"# Example Domain  This domain is for use in documentation examples...","outline":[{"level":1,"text":"Example Domain"}],"links":[],"tables":[],"jsonld":[],"chars":171}}}}}}},"/batch":{"post":{"operationId":"s_webread_batch_post","summary":"Clean structured content from any public web page for AI agents: markdown, text, outline, links, tables, JSON-LD.","description":"Clean structured content from any public web page for AI agents: markdown, text, outline, links, tables, JSON-LD. /watch snapshots a page and detects changes for repeat monitoring. Free /preview returns a real extraction of YOUR page.","tags":["web","scrape","markdown","extract","monitor"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string"},"mode":{"type":"string"},"limit":{"type":"number"}}},"example":{"url":"https://example.com","mode":"all","limit":20000}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string"},"status":{"type":"number"},"title":{"type":"string"},"markdown":{"type":"string"},"outline":{"type":"array","items":{"type":"object","properties":{"level":{"type":"number"},"text":{"type":"string"}}}},"links":{"type":"array"},"tables":{"type":"array"},"jsonld":{"type":"array"},"chars":{"type":"number"}}},"example":{"url":"https://example.com","status":200,"title":"Example Domain","markdown":"# Example Domain  This domain is for use in documentation examples...","outline":[{"level":1,"text":"Example Domain"}],"links":[],"tables":[],"jsonld":[],"chars":171}}}}}}},"/watch":{"post":{"operationId":"s_webread_watch_post","summary":"Clean structured content from any public web page for AI agents: markdown, text, outline, links, tables, JSON-LD.","description":"Clean structured content from any public web page for AI agents: markdown, text, outline, links, tables, JSON-LD. /watch snapshots a page and detects changes for repeat monitoring. Free /preview returns a real extraction of YOUR page.","tags":["web","scrape","markdown","extract","monitor"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string"},"mode":{"type":"string"},"limit":{"type":"number"}}},"example":{"url":"https://example.com","mode":"all","limit":20000}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string"},"status":{"type":"number"},"title":{"type":"string"},"markdown":{"type":"string"},"outline":{"type":"array","items":{"type":"object","properties":{"level":{"type":"number"},"text":{"type":"string"}}}},"links":{"type":"array"},"tables":{"type":"array"},"jsonld":{"type":"array"},"chars":{"type":"number"}}},"example":{"url":"https://example.com","status":200,"title":"Example Domain","markdown":"# Example Domain  This domain is for use in documentation examples...","outline":[{"level":1,"text":"Example Domain"}],"links":[],"tables":[],"jsonld":[],"chars":171}}}}}}}}}