{"openapi":"3.1.0","servers":[{"url":"https://135-181-53-91.sslip.io"}],"info":{"title":"Audit Alpha Evidence Audit API","version":"1.0.0","description":"Paid evidence-based audit of a public landing page.","contact":{"url":"https://135-181-53-91.sslip.io"},"x-guidance":"Use POST /api/x402/audit with a public source_url. Pay 0.05 USDC on Base through x402. The response contains observable findings and practical fixes; it does not promise traffic, rankings, conversions, revenue, or legal compliance."},"paths":{"/sample.json":{"get":{"operationId":"getLandingPageAuditSample","summary":"Inspect a representative JSON result for free","description":"Returns a clearly synthetic example without fetching a page, creating an order, or accepting payment.","security":[],"tags":["Sample"],"responses":{"200":{"description":"Free synthetic result sample","content":{"application/json":{"schema":{"type":"object","properties":{"sample":{"type":"boolean","const":true},"creates_order":{"type":"boolean","const":false},"cost":{"type":"string","const":"free"},"paid_endpoint":{"type":"string","format":"uri"},"current_paid_price":{"type":"string"},"example_paid_response":{"type":"object","properties":{"service":{"type":"string"},"order_id":{"type":"integer"},"status":{"type":"string"},"source_url":{"type":"string","format":"uri"},"observed_at":{"type":"string","format":"date-time"},"price":{"type":"string"},"summary":{"type":"object"},"findings":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string"},"severity":{"type":"string","enum":["high","medium","low"]},"evidence":{"type":"string"},"recommendation":{"type":"string"}},"required":["title","severity","evidence","recommendation"],"additionalProperties":false}},"limitations":{"type":"string"}},"required":["service","order_id","status","source_url","findings","limitations"]},"limitations":{"type":"string"}},"required":["sample","creates_order","cost","paid_endpoint","current_paid_price","example_paid_response","limitations"],"additionalProperties":false}}}}}}},"/preview":{"post":{"operationId":"previewPublicLandingPage","summary":"Preview one observable finding for free","description":"No payment is required. This bounded preview returns at most one static-HTML finding and does not create an order.","security":[],"tags":["Preview"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"source_url":{"type":"string","format":"uri","example":"https://example.com","description":"Public HTTP(S) landing page to inspect"}},"required":["source_url"],"additionalProperties":false}}}},"responses":{"200":{"description":"Free one-finding preview","content":{"application/json":{"schema":{"type":"object","properties":{"finding":{"oneOf":[{"type":"object","properties":{"severity":{"type":"string"},"title":{"type":"string"},"evidence":{"type":"string"},"recommendation":{"type":"string"}},"required":["severity","title","evidence","recommendation"]},{"type":"null"}]},"scope":{"type":"string"},"quick_price":{"type":"string"},"full_price":{"type":"string"}},"required":["finding","scope","quick_price","full_price"]}}}},"422":{"description":"The submitted public page could not be previewed safely"},"429":{"description":"Preview rate limit exceeded"},"503":{"description":"Preview capacity is temporarily busy"}}}},"/api/x402/audit":{"post":{"operationId":"auditPublicLandingPage","summary":"Audit a public landing page","tags":["Audit"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.05"},"protocols":[{"x402":{}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"source_url":{"maxLength":2048,"minLength":8,"title":"Source Url","type":"string"},"conversion_goal":{"default":"increase conversions","maxLength":500,"minLength":1,"title":"Conversion Goal","type":"string"},"audience":{"default":"prospective customers","maxLength":500,"minLength":1,"title":"Audience","type":"string"},"offer":{"default":"public landing page","maxLength":1000,"minLength":1,"title":"Offer","type":"string"}},"required":["source_url"],"title":"AuditRequest","type":"object"}}}},"responses":{"200":{"description":"Audit delivered after successful payment","content":{"application/json":{"schema":{"type":"object","properties":{"service":{"type":"string"},"order_id":{"type":"integer"},"status":{"type":"string"},"source_url":{"type":"string","format":"uri"},"observed_at":{"type":"string","format":"date-time"},"price":{"type":"string"},"summary":{"type":"object"},"findings":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string"},"severity":{"type":"string","enum":["high","medium","low"]},"evidence":{"type":"string"},"recommendation":{"type":"string"}},"required":["title","severity","evidence","recommendation"],"additionalProperties":false}},"limitations":{"type":"string"}},"required":["service","order_id","status","source_url","findings","limitations"]}}}},"402":{"description":"Payment Required"},"422":{"description":"The submitted public page could not be audited safely"}}}},"/api/x402/landing-page-audit":{"get":{"operationId":"auditPublicLandingPageWithQuery","summary":"Audit a public landing page with an agent-ready GET request","description":"Pass source_url and optional context as query parameters. Invalid or non-public targets are rejected without settlement.","tags":["Audit"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.05"},"protocols":[{"x402":{}}]},"parameters":[{"name":"source_url","in":"query","required":true,"schema":{"type":"string","format":"uri","maxLength":2048},"example":"https://example.com"},{"name":"conversion_goal","in":"query","required":false,"schema":{"type":"string","maxLength":500}},{"name":"audience","in":"query","required":false,"schema":{"type":"string","maxLength":500}},{"name":"offer","in":"query","required":false,"schema":{"type":"string","maxLength":1000}}],"responses":{"200":{"description":"Audit delivered after successful payment","content":{"application/json":{"schema":{"type":"object","properties":{"service":{"type":"string"},"order_id":{"type":"integer"},"status":{"type":"string"},"source_url":{"type":"string","format":"uri"},"observed_at":{"type":"string","format":"date-time"},"price":{"type":"string"},"summary":{"type":"object"},"findings":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string"},"severity":{"type":"string","enum":["high","medium","low"]},"evidence":{"type":"string"},"recommendation":{"type":"string"}},"required":["title","severity","evidence","recommendation"],"additionalProperties":false}},"limitations":{"type":"string"}},"required":["service","order_id","status","source_url","findings","limitations"]}}}},"402":{"description":"Payment Required"},"422":{"description":"The submitted public page could not be audited safely"}}}},"/api/x402/checklist":{"get":{"operationId":"getLandingPageAuditChecklist","summary":"Buy a machine-readable landing-page audit rubric","description":"Returns a deterministic ten-point conversion and accessibility review checklist. No input is required.","tags":["Checklist"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"Checklist delivered after successful payment","content":{"application/json":{"schema":{"type":"object","properties":{"service":{"type":"string"},"order_id":{"type":"integer"},"status":{"type":"string"},"observed_at":{"type":"string","format":"date-time"},"price":{"type":"string"},"checks":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"priority":{"type":"string"},"check":{"type":"string"},"evidence":{"type":"string"}},"required":["id","priority","check","evidence"],"additionalProperties":false}},"usage":{"type":"string"},"limitations":{"type":"string"}},"required":["service","order_id","status","price","checks","limitations"],"additionalProperties":false}}}},"402":{"description":"Payment Required"}}}}}}