Web research API for AI agents — search the public web and safely extract source evidence

[
  {
    "scheme": "exact",
    "network": "eip155:8453",
    "payTo": "0xc29185fa176357612f3194735753e520e91adc46",
    "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "amount": "3000",
    "maxTimeoutSeconds": 120
  }
]

{
  "bazaar": {
    "info": {
      "input": {
        "method": "GET",
        "queryParams": {
          "fetch_count": "1",
          "max_chars": "12000",
          "q": "latest x402 payment protocol updates",
          "search_count": "5"
        },
        "type": "http"
      },
      "output": {
        "example": {
          "accepted_delivery": true,
          "payment_model": "one_shot_x402",
          "price_usdc": "0.003",
          "product": "SML Web Research — One Shot",
          "query": "latest x402 payment protocol updates",
          "results": [
            {
              "snippet": "<search-snippet>",
              "title": "<source-title>",
              "url": "https://example.com/source"
            }
          ],
          "sources": [
            {
              "text": "<safely-extracted-source-text>",
              "title": "<source-title>",
              "url": "https://example.com/source"
            }
          ],
          "status": "ready"
        },
        "type": "json"
      }
    },
    "schema": {
      "$schema": "https://json-schema.org/draft/2020-12/schema",
      "additionalProperties": false,
      "properties": {
        "input": {
          "additionalProperties": false,
          "properties": {
            "body": {
              "additionalProperties": true,
              "description": "GET resource; no JSON request body is required.",
              "type": "object"
            },
            "method": {
              "const": "GET",
              "type": "string"
            },
            "queryParams": {
              "additionalProperties": true,
              "properties": {
                "fetch_count": {
                  "description": "Public source pages to safely extract, 1-3 Search intents: web research api, web research api for ai agents, ai research api, web search api, search and extract, agent research.",
                  "type": "string"
                },
                "max_chars": {
                  "description": "Maximum extracted characters per source Search intents: web research api, web research api for ai agents, ai research api, web search api, search and extract, agent research.",
                  "type": "string"
                },
                "q": {
                  "description": "General-web research query Search intents: web research api, web research api for ai agents, ai research api, web search api, search and extract, agent research.",
                  "maxLength": 400,
                  "minLength": 1,
                  "type": "string"
                },
                "search_count": {
                  "description": "Search results to inspect Search intents: web research api, web research api for ai agents, ai research api, web search api, search and extract, agent research.",
                  "type": "string"
                }
              },
              "required": [
                "q"
              ],
              "type": "object"
            },
            "type": {
              "const": "http",
              "type": "string"
            }
          },
          "required": [
            "type",
            "method",
            "queryParams"
          ],
          "type": "object"
        },
        "output": {
          "additionalProperties": false,
          "properties": {
            "example": {
              "type": "object"
            },
            "type": {
              "const": "json",
              "type": "string"
            }
          },
          "required": [
            "type",
            "example"
          ],
          "type": "object"
        }
      },
      "required": [
        "input",
        "output"
      ],
      "type": "object"
    }
  }
}

curl "https://squeezeos-api.onrender.com/api/web/research/once"
# -> 402 Payment Required, accepts[] lists how to pay
# retry with a PAYMENT-SIGNATURE (or PAYMENT header) once paid

const res = await fetch("https://squeezeos-api.onrender.com/api/web/research/once");
if (res.status === 402) {
  const { accepts } = await res.json();
  // pay one of accepts[] via an x402 client, then retry with the payment header
}

import httpx
res = httpx.get("https://squeezeos-api.onrender.com/api/web/research/once")
if res.status_code == 402:
    accepts = res.json()["accepts"]
    # pay one of accepts[] via an x402 client, then retry with the payment header