{"openapi":"3.1.0","info":{"title":"Web Access Gateway","version":"1.0.0","description":"Current web search and clean page reading for autonomous agents, with fixed JSON schemas and pay-per-call x402 pricing.","x-use-cases":["Current web research","Source discovery","Clean page ingestion","Research-grounding for autonomous agents"]},"servers":[{"url":"https://web-access-gateway.mattskowronis.workers.dev"}],"paths":{"/v1/search":{"post":{"summary":"Return 5 current ranked web results with compact source excerpts in a fixed JSON schema.","operationId":"search","x-402":{"price":"$0.01","networks":["eip155:8453","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"]},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"protocols":[{"x402":{}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"query":{"type":"string","minLength":1,"maxLength":500}},"required":["query"]}}}},"responses":{"200":{"description":"Fixed-schema result","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"schema_version":{"type":"string","const":"1.0"},"operation":{"type":"string","enum":["search","read","search_and_read"]},"query":{"type":["string","null"]},"requested_url":{"type":["string","null"]},"retrieved_at":{"type":"string","format":"date-time"},"result_count":{"type":"integer","minimum":0},"results":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"rank":{"type":"integer","minimum":1},"title":{"type":["string","null"]},"url":{"type":"string","format":"uri"},"published_at":{"type":["string","null"]},"author":{"type":["string","null"]},"score":{"type":["number","null"]},"snippet":{"type":"string"},"content":{"type":["string","null"]},"content_sha256":{"type":["string","null"],"pattern":"^[a-f0-9]{64}$"},"retrieval_status":{"type":"string","enum":["complete","metadata_only","failed"]}},"required":["rank","title","url","published_at","author","score","snippet","content","content_sha256","retrieval_status"]}},"warnings":{"type":"array","items":{"type":"string"}}},"required":["schema_version","operation","query","requested_url","retrieved_at","result_count","results","warnings"]}}}},"400":{"description":"Invalid input"},"402":{"description":"x402 payment required"},"502":{"description":"Upstream retrieval failed; incoming payment is not settled"},"503":{"description":"Payment service unavailable"}}}},"/v1/read":{"post":{"summary":"Read one public URL and return clean bounded page content with a SHA-256 content hash.","operationId":"read","x-402":{"price":"$0.003","networks":["eip155:8453","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"]},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.003"},"protocols":[{"x402":{}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"url":{"type":"string","format":"uri","maxLength":2048}},"required":["url"]}}}},"responses":{"200":{"description":"Fixed-schema result","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"schema_version":{"type":"string","const":"1.0"},"operation":{"type":"string","enum":["search","read","search_and_read"]},"query":{"type":["string","null"]},"requested_url":{"type":["string","null"]},"retrieved_at":{"type":"string","format":"date-time"},"result_count":{"type":"integer","minimum":0},"results":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"rank":{"type":"integer","minimum":1},"title":{"type":["string","null"]},"url":{"type":"string","format":"uri"},"published_at":{"type":["string","null"]},"author":{"type":["string","null"]},"score":{"type":["number","null"]},"snippet":{"type":"string"},"content":{"type":["string","null"]},"content_sha256":{"type":["string","null"],"pattern":"^[a-f0-9]{64}$"},"retrieval_status":{"type":"string","enum":["complete","metadata_only","failed"]}},"required":["rank","title","url","published_at","author","score","snippet","content","content_sha256","retrieval_status"]}},"warnings":{"type":"array","items":{"type":"string"}}},"required":["schema_version","operation","query","requested_url","retrieved_at","result_count","results","warnings"]}}}},"400":{"description":"Invalid input"},"402":{"description":"x402 payment required"},"502":{"description":"Upstream retrieval failed; incoming payment is not settled"},"503":{"description":"Payment service unavailable"}}}},"/v1/search-read":{"post":{"summary":"Search the current web and return 5 ranked results with clean page content and content hashes.","operationId":"search_and_read","x-402":{"price":"$0.025","networks":["eip155:8453","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"]},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.025"},"protocols":[{"x402":{}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"query":{"type":"string","minLength":1,"maxLength":500}},"required":["query"]}}}},"responses":{"200":{"description":"Fixed-schema result","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"schema_version":{"type":"string","const":"1.0"},"operation":{"type":"string","enum":["search","read","search_and_read"]},"query":{"type":["string","null"]},"requested_url":{"type":["string","null"]},"retrieved_at":{"type":"string","format":"date-time"},"result_count":{"type":"integer","minimum":0},"results":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"rank":{"type":"integer","minimum":1},"title":{"type":["string","null"]},"url":{"type":"string","format":"uri"},"published_at":{"type":["string","null"]},"author":{"type":["string","null"]},"score":{"type":["number","null"]},"snippet":{"type":"string"},"content":{"type":["string","null"]},"content_sha256":{"type":["string","null"],"pattern":"^[a-f0-9]{64}$"},"retrieval_status":{"type":"string","enum":["complete","metadata_only","failed"]}},"required":["rank","title","url","published_at","author","score","snippet","content","content_sha256","retrieval_status"]}},"warnings":{"type":"array","items":{"type":"string"}}},"required":["schema_version","operation","query","requested_url","retrieved_at","result_count","results","warnings"]}}}},"400":{"description":"Invalid input"},"402":{"description":"x402 payment required"},"502":{"description":"Upstream retrieval failed; incoming payment is not settled"},"503":{"description":"Payment service unavailable"}}}},"/v1/ma-government-snapshot":{"post":{"summary":"Massachusetts-only evidence-backed snapshot covering selected official state and selected municipal sources for at most seven days, with official evidence links. Not comprehensive coverage of every Massachusetts government source.","operationId":"ma-government-snapshot","x-402":{"price":"$0.50","networks":["eip155:8453","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"]},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.50"},"protocols":[{"x402":{}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"since":{"type":"string","format":"date-time"},"lookback_hours":{"type":"integer","minimum":1,"maximum":168,"default":24},"topic":{"type":"string","minLength":1,"maxLength":120},"government_levels":{"type":"array","minItems":1,"uniqueItems":true,"items":{"type":"string","enum":["state","municipal"]}},"municipalities":{"type":"array","uniqueItems":true,"items":{"type":"string","enum":["Boston","Easthampton","Worcester"]}},"include_routine":{"type":"boolean","default":false},"max_developments":{"type":"integer","minimum":1,"maximum":50,"default":25}}}}}},"responses":{"200":{"description":"Fixed-schema result","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["job","snapshot_id","jurisdiction","generated_at","data_through","requested_window","coverage","briefing","developments","clusters","source_health","warnings","billable_units"],"properties":{"job":{"type":"string","const":"ma-government-snapshot"},"snapshot_id":{"type":"string"},"jurisdiction":{"type":"string","const":"Massachusetts"},"generated_at":{"type":"string","format":"date-time"},"data_through":{"type":"string","format":"date-time"},"requested_window":{"type":"object"},"coverage":{"type":"object"},"briefing":{"type":"object"},"developments":{"type":"array"},"clusters":{"type":"array"},"source_health":{"type":"array"},"warnings":{"type":"array","items":{"type":"string"}},"billable_units":{"type":"integer","const":1}}}}}},"400":{"description":"Invalid input"},"402":{"description":"x402 payment required"},"502":{"description":"Upstream retrieval failed; incoming payment is not settled"},"503":{"description":"Payment service unavailable"}}}}}}