{"openapi":"3.1.0","info":{"title":"Search402","version":"1.0.0","summary":"Pay-per-call web search and page extraction for AI agents (x402, USDC on Base).","description":"No account and no API key. Call an endpoint, receive HTTP 402 with payment terms, pay in USDC on Base with x402, retry. Outputs are token-lean Markdown, JSON or JSON-LD.","contact":{"url":"https://search.missioncoregroup.com","email":"hello@missioncoregroup.com"}},"servers":[{"url":"https://search.missioncoregroup.com"}],"externalDocs":{"url":"https://search.missioncoregroup.com/llms.txt"},"paths":{"/v1/search":{"get":{"operationId":"search","summary":"Full-text web search over the Search402 index. $0.005 USDC per call.","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string","minLength":2,"maxLength":300},"description":"Query. Supports \"quoted phrases\", OR and -exclusions."},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":25,"default":10}},{"name":"site","in":"query","schema":{"type":"string"},"description":"Restrict to one domain, e.g. docs.python.org"},{"name":"format","in":"query","required":false,"description":"md (default, GFM), json, or jsonld. Also chosen by the Accept header.","schema":{"type":"string","enum":["md","json","jsonld"],"default":"md"}}],"x-price":{"amount":0.005,"currency":"USDC","network":"eip155:8453"},"responses":{"200":{"description":"OK","headers":{"X-Agent-RateLimit-Remaining":{"description":"Requests left in the current 60-second window.","schema":{"type":"integer"}},"X-Data-Freshness-Timestamp":{"description":"ISO time of the oldest data in this response.","schema":{"type":"string","format":"date-time"}},"X-Token-Cost":{"description":"Estimated LLM tokens in the body (bytes / 4).","schema":{"type":"integer"}},"X-Price-USDC":{"description":"Price of this endpoint in USDC.","schema":{"type":"string"}},"X-Cache":{"description":"HIT or MISS.","schema":{"type":"string"}}},"content":{"text/markdown":{"schema":{"type":"string"}},"application/json":{"schema":{"type":"object","required":["query","count","results"],"properties":{"query":{"type":"string"},"count":{"type":"integer"},"results":{"type":"array","items":{"type":"object","required":["url","title","snippet","domain","fetchedAt","score"],"additionalProperties":false,"properties":{"url":{"type":"string","format":"uri"},"title":{"type":"string"},"description":{"type":"string"},"snippet":{"type":"string","description":"Matching passage; query terms wrapped in **."},"domain":{"type":"string"},"score":{"type":"number"},"fetchedAt":{"type":"string","format":"date-time"}}}}}}},"application/ld+json":{"schema":{"type":"object"}}}},"400":{"description":"Bad input","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"}}}}}},"402":{"description":"Payment required (x402). Body and PAYMENT-REQUIRED header describe how to pay; retry with a PAYMENT-SIGNATURE header.","content":{"application/json":{"schema":{"type":"object"}}}},"429":{"description":"Rate limited"}}}},"/v1/extract":{"get":{"operationId":"extract","summary":"Fetch one public URL and return its main content as clean Markdown/JSON-LD. $0.002 USDC per call.","parameters":[{"name":"url","in":"query","required":true,"schema":{"type":"string","format":"uri"}},{"name":"format","in":"query","required":false,"description":"md (default, GFM), json, or jsonld. Also chosen by the Accept header.","schema":{"type":"string","enum":["md","json","jsonld"],"default":"md"}}],"x-price":{"amount":0.002,"currency":"USDC","network":"eip155:8453"},"responses":{"200":{"description":"OK","headers":{"X-Agent-RateLimit-Remaining":{"description":"Requests left in the current 60-second window.","schema":{"type":"integer"}},"X-Data-Freshness-Timestamp":{"description":"ISO time of the oldest data in this response.","schema":{"type":"string","format":"date-time"}},"X-Token-Cost":{"description":"Estimated LLM tokens in the body (bytes / 4).","schema":{"type":"integer"}},"X-Price-USDC":{"description":"Price of this endpoint in USDC.","schema":{"type":"string"}},"X-Cache":{"description":"HIT or MISS.","schema":{"type":"string"}}},"content":{"text/markdown":{"schema":{"type":"string"}},"application/json":{"schema":{"type":"object","required":["url","title","markdown","fetchedAt"],"properties":{"url":{"type":"string","format":"uri"},"title":{"type":"string"},"description":{"type":"string"},"lang":{"type":"string"},"markdown":{"type":"string","description":"Main content as GitHub-flavoured Markdown."},"jsonld":{"description":"JSON-LD blocks found on the page, or null.","type":["array","null"]},"fetchedAt":{"type":"string","format":"date-time"}}}},"application/ld+json":{"schema":{"type":"object"}}}},"400":{"description":"Bad or private URL","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"}}}}}},"402":{"description":"Payment required (x402). Body and PAYMENT-REQUIRED header describe how to pay; retry with a PAYMENT-SIGNATURE header.","content":{"application/json":{"schema":{"type":"object"}}}},"451":{"description":"Blocked by the site's robots.txt"},"502":{"description":"Site unreachable"}}}},"/v1/preview":{"get":{"operationId":"preview","summary":"Free sample: top 3 search results, titles and URLs only. 20 calls per IP per day.","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","headers":{"X-Agent-RateLimit-Remaining":{"description":"Requests left in the current 60-second window.","schema":{"type":"integer"}},"X-Data-Freshness-Timestamp":{"description":"ISO time of the oldest data in this response.","schema":{"type":"string","format":"date-time"}},"X-Token-Cost":{"description":"Estimated LLM tokens in the body (bytes / 4).","schema":{"type":"integer"}},"X-Price-USDC":{"description":"Price of this endpoint in USDC.","schema":{"type":"string"}},"X-Cache":{"description":"HIT or MISS.","schema":{"type":"string"}}},"content":{"text/markdown":{"schema":{"type":"string"}},"application/json":{"schema":{"type":"object","required":["query","count","results"],"properties":{"query":{"type":"string"},"count":{"type":"integer"},"results":{"type":"array","items":{"type":"object","required":["url","title","snippet","domain","fetchedAt","score"],"additionalProperties":false,"properties":{"url":{"type":"string","format":"uri"},"title":{"type":"string"},"description":{"type":"string"},"snippet":{"type":"string","description":"Matching passage; query terms wrapped in **."},"domain":{"type":"string"},"score":{"type":"number"},"fetchedAt":{"type":"string","format":"date-time"}}}}}}},"application/ld+json":{"schema":{"type":"object"}}}},"429":{"description":"Daily free limit reached"}}}},"/v1/status":{"get":{"operationId":"status","summary":"Free. Index size, freshness and whether payments are live.","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}}}}}}}