{"openapi":"3.1.0","info":{"title":"WebExtract API","version":"1.2.0","contact":{"email":"duckbeijing518@gmail.com","url":"https://webextract.dev"},"x-guidance":"GET /v1/extract?url=<page> returns clean Markdown plus fixed-schema JSON (product/price, tables, article metadata). GET /v1/markdown?url=<page> returns Markdown only and is cheaper. Pay per call with x402 (USDC on Base) or use a prepaid Bearer key. MCP: POST /mcp.","description":"Web page to clean Markdown + fixed-schema structured JSON for AI agents. robots.txt respected. Credits never expire. No charge on failed fetches (404, timeout, blocked, robots.txt disallowed). Structured JSON at no extra cost: /v1/extract = 1 credit, /v1/markdown = 0.4 credit. If structured fields come back empty, you're only charged the Markdown rate. x402: /v1/extract $0.005, /v1/markdown $0.002 (USDC on Base; x402 settles at the quoted price). 50 free calls/day per IP without a key; prepaid packs $5=1000 calls, $20=5000 calls, $50=15000 calls via https://api.webextract.dev/#pricing. Or pay per call without an account via x402 ($0.005 USDC, eip155:8453; send PAYMENT-SIGNATURE header). Respects robots.txt."},"servers":[{"url":"https://api.webextract.dev"}],"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer"}}},"security":[{"bearer":[]},{}],"paths":{"/v1/extract":{"get":{"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.005"},"protocols":[{"x402":{}}]},"x-payment":{"protocol":"x402","scheme":"exact","price":"$0.005","network":"eip155:8453","asset":"USDC"},"operationId":"extractUrl","summary":"URL → clean Markdown + structured JSON","parameters":[{"name":"url","in":"query","required":true,"schema":{"type":"string","format":"uri"}}],"responses":{"200":{"description":"Extraction result (X-Credits-Remaining header)","content":{"application/json":{"schema":{"type":"object","required":["url","final_url","fetched_at","schema_version","markdown","metadata","product","tables"],"properties":{"url":{"type":"string"},"final_url":{"type":"string"},"fetched_at":{"type":"string"},"schema_version":{"type":"string"},"markdown":{"type":"string"},"markdown_truncated":{"type":"boolean"},"word_count":{"type":"integer"},"metadata":{"type":"object","properties":{"title":{"type":["string","null"]},"description":{"type":["string","null"]},"authors":{"type":"array","items":{"type":"string"}},"published_at":{"type":["string","null"]},"modified_at":{"type":["string","null"]},"site_name":{"type":["string","null"]},"language":{"type":["string","null"]},"canonical_url":{"type":["string","null"]},"image":{"type":["string","null"]},"type":{"type":["string","null"]}}},"product":{"type":["object","null"],"properties":{"name":{"type":["string","null"]},"brand":{"type":["string","null"]},"sku":{"type":["string","null"]},"gtin":{"type":["string","null"]},"description":{"type":["string","null"]},"image":{"type":["string","null"]},"price":{"type":["number","null"]},"price_high":{"type":["number","null"]},"currency":{"type":["string","null"]},"availability":{"type":["string","null"]},"rating":{"type":["object","null"]},"source":{"type":["string","null"]}}},"tables":{"type":"array","items":{"type":"object","properties":{"index":{"type":"integer"},"caption":{"type":["string","null"]},"headers":{"type":"array","items":{"type":"string"}},"rows":{"type":"array","items":{"type":"array","items":{"type":"string"}}},"checks":{"type":"object","properties":{"row_count":{"type":"integer"},"column_count":{"type":"integer"},"consistent_width":{"type":"boolean"}}}}}}}},"example":{"url":"https://example.com/product/123","final_url":"https://example.com/product/123","fetched_at":"2026-10-20T12:00:00.000Z","schema_version":"1.0","markdown":"# Example Product\n\nDescription...","markdown_truncated":false,"word_count":120,"metadata":{"title":"Example Product","description":"…","authors":[],"published_at":null,"modified_at":null,"site_name":"Example","language":"en","canonical_url":"https://example.com/product/123","image":null,"type":"product"},"product":{"name":"Example Product","brand":"Acme","sku":"A-123","gtin":null,"description":"…","image":null,"price":19.99,"price_high":null,"currency":"USD","availability":"InStock","rating":{"value":4.5,"count":210},"source":"json-ld"},"tables":[{"index":0,"caption":null,"headers":["Spec","Value"],"rows":[["Weight","1.2 kg"]],"checks":{"row_count":1,"column_count":2,"consistent_width":true}}]}}}},"400":{"description":"Invalid URL / forbidden host (free)"},"401":{"description":"Invalid API key"},"402":{"description":"Out of credits (Bearer) or payment required: x402 requirements in PAYMENT-REQUIRED header, Stripe buy links in body"},"422":{"description":"Target site blocked or errored (free)"},"429":{"description":"Free daily limit reached"},"451":{"description":"Disallowed by robots.txt (free)"}}}},"/v1/markdown":{"get":{"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.002"},"protocols":[{"x402":{}}]},"x-payment":{"protocol":"x402","scheme":"exact","price":"$0.002","network":"eip155:8453","asset":"USDC"},"operationId":"pageMarkdown","summary":"URL → clean Markdown only (0.4 credit / $0.002 x402)","parameters":[{"name":"url","in":"query","required":true,"schema":{"type":"string","format":"uri"}}],"responses":{"200":{"description":"Markdown result","content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string"},"final_url":{"type":"string"},"title":{"type":["string","null"]},"markdown":{"type":"string"},"markdown_truncated":{"type":"boolean"},"word_count":{"type":"integer"}}}}}},"400":{"description":"Invalid URL (not charged)"},"402":{"description":"Payment required (x402) or out of credits"},"422":{"description":"Target site blocked or errored (not charged)"},"451":{"description":"Disallowed by robots.txt (not charged)"}}}},"/v1/balance":{"get":{"security":[],"operationId":"getBalance","summary":"Remaining credits (or free calls today without key)","responses":{"200":{"description":"Balance"}}}}}}