{"manifest_version":"1","name":"Santos Website Intelligence API","alternate_name":"Santos Agent Readiness API","version":"2.3.1","description":"AI Website Intelligence for measuring whether public websites can be discovered, understood, trusted, and used by AI agents. Returns structured evidence, applicability, coverage, scores, and prioritized remediation.","canonical_url":"https://api.santosautomation.com","openapi_url":"https://api.santosautomation.com/openapi.json","llms_url":"https://api.santosautomation.com/llms.txt","mcp_url":"https://api.santosautomation.com/mcp","capability_manifest_url":"https://api.santosautomation.com/capabilities.json","website":"https://www.santosautomation.com","pricing":{"amount":"0.015","currency":"USDC","atomic_amount":"15000","billing_unit":"successful audit"},"payment":{"protocol":"x402 v2","network":"eip155:8453","scheme":"exact","challenge_header":"PAYMENT-REQUIRED","authorization_header":"PAYMENT-SIGNATURE","receipt_header":"PAYMENT-RESPONSE"},"capabilities":["AI Website Intelligence dimensions (Discoverable, Understandable, Callable, Trustworthy)","applicability-aware Agent Readiness with evidence coverage and confidence","performance signals (fetch timing, page weight, script/stylesheet counts)","SEO signals (title, meta description, headings, canonical, OpenGraph)","basic HTML accessibility signals (alt text, lang, viewport)","security-header checks (HTTPS, HSTS, CSP)","structured remediation guidance"],"limitations":["audits a single page per call (no crawling)","no JavaScript rendering or Core Web Vitals","no full WCAG conformance or vulnerability scanning","public pages only; private/internal addresses rejected","15s timeout, 5 redirects, 5MB response cap, ports 80/443 only"],"tiers":{"quick":{"title":"Quick Intelligence Audit","endpoint":"GET /api/audit?url=","price_usdc":"0.015","mode":"synchronous","engine":"fetch + HTML parsing (no browser)"},"agent-readiness":{"capability_id":"agent-readiness.quick","endpoint":"GET /api/agent-readiness?url=&depth=quick","price_usdc":"0.075","billing_unit":"successful audit","mode":"synchronous, bounded passive discovery","engine":"fetch + HTML/JSON interface analysis; no authentication to or payment of the audited target; no business tool invocation","schema_version":"1.0.0","enabled":true},"safe-fetch":{"capability_id":"web.safe-fetch","title":"Safe Fetch","endpoint":"GET /v1/fetch?url=","price_usdc":"0.002","mode":"synchronous","engine":"SSRF-guarded raw fetch (GET ?url= or POST {url})"},"content-extraction":{"capability_id":"content.extract-markdown","title":"Page-to-Markdown Extraction","endpoint":"POST /v1/extract","price_usdc":"0.005","mode":"synchronous","engine":"safe-fetch + Readability + Markdown"},"structured-extraction":{"capability_id":"content.extract-structured","title":"Structured Extraction","endpoint":"POST /v1/extract/structured","price_usdc":"0.08","billing_unit":"successful extraction (output validated against caller schema)","mode":"synchronous","engine":"safe-fetch + Readability + Claude Sonnet 5 forced tool-use, validated against the caller's JSON Schema"},"screenshot":{"capability_id":"render.screenshot","title":"Screenshot & PDF Render","endpoint":"GET /v1/screenshot?url=","price_usdc":"0.01","billing_unit":"successful render","mode":"synchronous","engine":"real Chromium render (SSRF-guarded)"},"deep-page":{"title":"Deep Website Intelligence Audit","endpoint":"POST /v1/audits","price_usdc":"0.225","mode":"asynchronous job (poll status_url)","engine":"Chromium/Playwright + Lighthouse + rendered axe-core + network evidence + screenshots + passive security","payment_note":"Payment buys one bounded compute reservation; settles when the job is accepted, not on report completion. Use an Idempotency-Key header.","enabled":true}},"endpoints":{"GET /api/audit?url=":"$0.015 USDC via x402 v2 — quick audit, synchronous","GET /api/agent-readiness?url=&depth=quick":"$0.075 USDC via x402 v2 — Agent Readiness audit, synchronous","GET /v1/fetch?url=":"$0.002 USDC via x402 v2 — SSRF-guarded raw fetch, synchronous","POST /v1/extract":"$0.005 USDC via x402 v2 — page-to-Markdown extraction, synchronous","POST /v1/extract/structured":"$0.08 USDC via x402 v2 — structured JSON extraction against your schema, synchronous","GET /v1/screenshot?url=":"$0.01 USDC via x402 v2 — screenshot/PDF render, synchronous","POST /v1/audits":"$0.225 USDC via x402 v2 — deep page audit job, asynchronous","GET /api/audit/demo?url=":"free, 1/day per IP, human demo","POST /mcp":"MCP server (Streamable HTTP) — free preview tool audit_website_preview"},"capability_manifest":{"manifest_type":"santos-capability-manifest","manifest_version":"1.0.0","standard":false,"name":"Santos Website Intelligence API","description":"An AI Website Intelligence API that measures whether websites can be discovered, understood, trusted, and used by AI agents. This vendor-specific discovery metadata is not an IETF, MCP, or Schema.org standard.","version":"2.3.1","provider":{"name":"Santos Automation","url":"https://www.santosautomation.com"},"documentation_url":"https://api.santosautomation.com/openapi.json","openapi_url":"https://api.santosautomation.com/openapi.json","mcp_url":"https://api.santosautomation.com/mcp","authentication":"No account or traditional API key. Paid resources use x402 v2; deep report reads use a per-job bearer token.","payment_protocols":[{"protocol":"x402-v2","network":"eip155:8453","currency":"USDC"}],"human_purchase":{"product":"Agent Readiness Report","price":{"amount":"5.00","currency":"USD","rail":"stripe-card"},"url":"https://www.santosautomation.com/agent-readiness/buy","note":"Human convenience: one-time card purchase, emailed as a private tokened link, no account. The machine-payable per-call price remains $0.075 USDC via x402."},"support_url":"mailto:info@santosautomation.com","terms_url":"https://www.santosautomation.com/terms","privacy_url":"https://www.santosautomation.com/terms#privacy","capabilities":[{"id":"site-audit.quick","title":"Quick Intelligence Audit","version":"2.1.0","description":"Select for synchronous lightweight website intelligence triage of one public page.","endpoint":"https://api.santosautomation.com/api/audit?url={url}","method":"GET","mode":"synchronous","expected_latency":"seconds","input_schema":{"type":"object","required":["url"],"properties":{"url":{"type":"string","format":"uri"}}},"output_schema":"https://api.santosautomation.com/openapi.json#/paths/~1api~1audit/get/responses/200","access":"x402 v2 payment; no account or API key","billing_unit":"successful audit","idempotency":"safe GET; payment settles only on a successful response","side_effects":"read-only public fetch","rate_limits":"bounded target fetch","error_model":"stable JSON code and message","data_retention":"no target credentials or cookies collected","limitations":["single page","no JavaScript rendering","not WCAG certification or a vulnerability scan"],"documentation":"https://api.santosautomation.com/openapi.json","support":"mailto:info@santosautomation.com","price":{"amount":"0.015","currency":"USDC","protocol":"x402-v2","network":"eip155:8453"}},{"id":"agent-readiness.quick","title":"Agent Readiness Audit","version":"1.0.0","description":"Select to assess public agent-facing discovery, APIs, MCP, trust, and resource-scoped machine-commerce pricing without active target actions.","endpoint":"https://api.santosautomation.com/api/agent-readiness?url={url}","method":"GET","mode":"synchronous","expected_latency":"seconds","input_schema":{"type":"object","required":["url"],"properties":{"url":{"type":"string","format":"uri"},"depth":{"type":"string","enum":["quick"]}}},"output_schema":"https://api.santosautomation.com/openapi.json#/components/schemas/AgentReadinessResult","access":"x402 v2 payment; no account or API key","billing_unit":"successful audit","idempotency":"safe read-only GET; payment settles only on a successful response","side_effects":"none on the target beyond bounded public reads","rate_limits":"maximum eight additional public requests","error_model":"stable JSON code and message","data_retention":"no authentication, payment signature, cookie, or secret collection","limitations":["public surfaces only","does not authenticate to or pay the audited target","no MCP tools/call","llms.txt proposal and optional preview-registry evidence"],"documentation":"https://api.santosautomation.com/openapi.json","support":"mailto:info@santosautomation.com","schema_version":"1.0.0","price":{"amount":"0.075","currency":"USDC","protocol":"x402-v2","network":"eip155:8453"}},{"id":"web.safe-fetch","title":"Safe Fetch","version":"1.0.0","description":"Select to retrieve one public URL's raw text body through a hardened SSRF-guarded fetcher with redirects, headers, and timing metadata.","endpoint":"https://api.santosautomation.com/v1/fetch?url={url}","method":"GET","mode":"synchronous","expected_latency":"seconds","input_schema":{"type":"object","required":["url"],"properties":{"url":{"type":"string","format":"uri"}}},"output_schema":"https://api.santosautomation.com/openapi.json#/paths/~1v1~1fetch/get/responses/200","access":"x402 v2 payment; no account or API key","billing_unit":"successful fetch","idempotency":"read-only; payment settles only on a successful response","side_effects":"read-only public fetch","rate_limits":"bounded target fetch (15s, 2MB, ports 80/443)","error_model":"stable JSON code and message","data_retention":"fetched content is returned, not stored","limitations":["single URL","text formats only","no crawling","no JavaScript rendering"],"documentation":"https://api.santosautomation.com/openapi.json","support":"mailto:info@santosautomation.com","price":{"amount":"0.002","currency":"USDC","protocol":"x402-v2","network":"eip155:8453"}},{"id":"content.extract-markdown","title":"Page-to-Markdown Extraction","version":"1.0.0","description":"Select to convert one public web page into clean Markdown with title, links, and metadata for RAG and research workflows.","endpoint":"https://api.santosautomation.com/v1/extract","method":"POST","mode":"synchronous","expected_latency":"seconds","input_schema":{"type":"object","required":["url"],"properties":{"url":{"type":"string","format":"uri"}}},"output_schema":"https://api.santosautomation.com/openapi.json#/paths/~1v1~1extract/post/responses/200","access":"x402 v2 payment; no account or API key","billing_unit":"successful extraction","idempotency":"read-only; payment settles only on a successful response","side_effects":"read-only public fetch","rate_limits":"bounded target fetch (15s, 5MB)","error_model":"stable JSON code and message","data_retention":"page content is returned, not stored","limitations":["single page","no crawling","no JavaScript rendering"],"documentation":"https://api.santosautomation.com/openapi.json","support":"mailto:info@santosautomation.com","price":{"amount":"0.005","currency":"USDC","protocol":"x402-v2","network":"eip155:8453"}},{"id":"content.extract-structured","title":"Structured Extraction","version":"1.0.0","description":"Select to extract structured JSON fields from one public web page against your own JSON Schema, using an LLM with forced tool-use and schema validation on the output.","endpoint":"https://api.santosautomation.com/v1/extract/structured","method":"POST","mode":"synchronous","expected_latency":"seconds","input_schema":{"type":"object","required":["url","schema"],"properties":{"url":{"type":"string","format":"uri"},"schema":{"type":"object","description":"Self-contained JSON Schema (type: object, no $ref) describing the fields to extract. Max 4000 characters."}}},"output_schema":"https://api.santosautomation.com/openapi.json#/paths/~1v1~1extract~1structured/post/responses/200","access":"x402 v2 payment; no account or API key","billing_unit":"successful extraction (output validated against caller schema)","idempotency":"read-only; payment settles only when the extracted data validates against the caller's schema","side_effects":"read-only public fetch plus one upstream LLM call","rate_limits":"bounded target fetch (15s, 5MB); page content truncated to 8000 characters before extraction; model output capped at 1024 tokens regardless of schema size","error_model":"stable JSON code and message","data_retention":"page content and extracted data are returned, not stored","limitations":["single page","no crawling","no JavaScript rendering","caller-supplied JSON Schema, self-contained only (no external $ref)","very long pages are truncated before extraction"],"documentation":"https://api.santosautomation.com/openapi.json","support":"mailto:info@santosautomation.com","price":{"amount":"0.08","currency":"USDC","protocol":"x402-v2","network":"eip155:8453"}},{"id":"render.screenshot","title":"Screenshot & PDF Render","version":"1.0.0","description":"Select to render one public page as a PNG, JPEG, or print-rendered A4 PDF in a real isolated Chromium browser — JavaScript executes, so SPAs and client-rendered content are captured as a real visitor sees them. Useful for deploy verification, visual monitoring, link previews, PDF archival, and vision-model input.","endpoint":"https://api.santosautomation.com/v1/screenshot?url={url}","method":"GET","mode":"synchronous","expected_latency":"seconds (a cold worker wakes on demand; retry on 504)","input_schema":{"type":"object","required":["url"],"properties":{"url":{"type":"string","format":"uri"},"format":{"type":"string","enum":["png","jpeg","pdf"]},"device":{"type":"string","enum":["desktop","mobile"]},"full_page":{"type":"boolean"}}},"output_schema":"https://api.santosautomation.com/openapi.json#/paths/~1v1~1screenshot/get/responses/200","access":"x402 v2 payment; no account or API key","billing_unit":"successful render","idempotency":"read-only; payment settles only when render bytes are returned","side_effects":"read-only public browser navigation","rate_limits":"bounded browser requests, bytes, and runtime","error_model":"stable JSON code and message on failures; binary on success","data_retention":"render artifacts expire within 72 hours","limitations":["single page","public pages only — no login-protected content","fresh anonymous visitor: no cookies carried","binary response"],"documentation":"https://api.santosautomation.com/openapi.json","support":"mailto:info@santosautomation.com","price":{"amount":"0.01","currency":"USDC","protocol":"x402-v2","network":"eip155:8453"}},{"id":"site-audit.deep-page","title":"Deep Website Intelligence Audit","version":"3.0.0","description":"Select for browser-rendered website intelligence evidence and optional Agent Readiness discovery.","endpoint":"https://api.santosautomation.com/v1/audits","method":"POST","mode":"asynchronous","expected_latency":"tens of seconds to minutes","input_schema":"https://api.santosautomation.com/openapi.json#/paths/~1v1~1audits/post/requestBody","output_schema":"https://api.santosautomation.com/openapi.json#/paths/~1v1~1audits~1{job_id}~1report/get/responses/200","access":"x402 v2 payment plus per-job bearer access token","billing_unit":"bounded compute reservation","idempotency":"Idempotency-Key supported","side_effects":"read-only public browser navigation","rate_limits":"bounded browser requests, bytes, runtime, and artifacts","error_model":"versioned job and report errors","data_retention":"short-lived report artifacts; target cookie values are never captured","limitations":["single page","lab data","no authenticated flows or penetration testing"],"documentation":"https://api.santosautomation.com/openapi.json","support":"mailto:info@santosautomation.com","price":{"amount":"0.225","currency":"USDC","protocol":"x402-v2","network":"eip155:8453"}}]},"contact":"https://www.santosautomation.com"}