Live web search for AI agents: returns ranked results with title, URL, snippet, publish da

[
  {
    "scheme": "exact",
    "network": "eip155:8453",
    "payTo": "0x4395C7e383b7e05665aad7f36ed77c01923Dd965",
    "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "amount": "15000",
    "maxTimeoutSeconds": 300
  }
]

{
  "bazaar": {
    "info": {
      "description": "Live web search with title, URL, snippet and freshness data from multiple search providers with automatic failover.",
      "errors": [
        {
          "code": "PAYMENT_REQUIRED",
          "description": "Missing or invalid payment — retry with a valid PAYMENT-SIGNATURE header",
          "retryable": true,
          "status": 402
        },
        {
          "code": "VALIDATION_ERROR",
          "description": "Request body does not match the input schema",
          "retryable": false,
          "status": 422
        },
        {
          "code": "RATE_LIMITED",
          "description": "Too many requests from this client",
          "retryable": true,
          "status": 429
        },
        {
          "code": "UPSTREAM_TIMEOUT",
          "description": "Upstream data source unavailable — safe to retry",
          "retryable": true,
          "status": 502
        }
      ],
      "input": {
        "body": {
          "limit": 3,
          "query": "x402 payment protocol for AI agents"
        },
        "bodyType": "json",
        "method": "POST",
        "type": "http"
      },
      "networks": [
        "eip155:8453"
      ],
      "output": {
        "example": {
          "results": [
            {
              "published_at": "2025-05-06T00:00:00Z",
              "snippet": "x402 lets AI agents pay for APIs with USDC over HTTP 402…",
              "source": "exa",
              "title": "Introducing x402: a new standard for internet-native payments",
              "url": "https://www.coinbase.com/developer-platform/discover/launches/x402"
            }
          ]
        },
        "type": "json"
      },
      "pricing": {
        "amount": 0.015,
        "currency": "USDC",
        "model": "per-call"
      }
    },
    "schema": {
      "$schema": "https://json-schema.org/draft/2020-12/schema",
      "properties": {
        "description": {
          "type": "string"
        },
        "errors": {
          "items": {
            "properties": {
              "code": {
                "type": "string"
              },
              "description": {
                "type": "string"
              },
              "retryable": {
                "type": "boolean"
              },
              "status": {
                "type": "integer"
              }
            },
            "required": [
              "status",
              "code"
            ],
            "type": "object"
          },
          "type": "array"
        },
        "input": {
          "additionalProperties": false,
          "properties": {
            "body": {
              "description": "Web Search input. Live web search for AI agents: returns ranked results with title, URL, snippet, publish date and source. Neural + keyword search across the current web with automatic provider failover. Use it to find recent news, documentation, competitors, prices or any fact that needs a fresh source.",
              "properties": {
                "country": {
                  "type": "string"
                },
                "freshness_days": {
                  "type": "integer"
                },
                "language": {
                  "type": "string"
                },
                "limit": {
                  "type": "integer"
                },
                "query": {
                  "type": "string"
                }
              },
              "required": [
                "query"
              ],
              "type": "object"
            },
            "bodyType": {
              "enum": [
                "json",
                "form-data",
                "text"
              ],
              "type": "string"
            },
            "headers": {
              "additionalProperties": {
                "type": "string"
              },
              "type": "object"
            },
            "method": {
              "enum": [
                "POST",
                "PUT",
                "PATCH"
              ],
              "type": "string"
            },
            "queryParams": {
              "additionalProperties": {
                "type": "string"
              },
              "type": "object"
            },
            "type": {
              "const": "http",
              "type": "string"
            }
          },
          "required": [
            "type",
            "method",
            "bodyType",
            "body"
          ],
          "type": "object"
        },
        "networks": {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "output": {
          "properties": {
            "example": {
              "type": "object"
            },
            "type": {
              "type": "string"
            }
          },
          "required": [
            "type"
          ],
          "type": "object"
        },
        "pricing": {
          "properties": {
            "amount": {
              "type": [
                "number",
                "null"
              ]
            },
            "currency": {
              "type": "string"
            },
            "model": {
              "type": "string"
            }
          },
          "type": "object"
        }
      },
      "required": [
        "input"
      ],
      "type": "object"
    }
  }
}

curl "https://agentbit.app/v1/web/search"
# -> 402 Payment Required, accepts[] lists how to pay
# retry with a PAYMENT-SIGNATURE (or PAYMENT header) once paid

const res = await fetch("https://agentbit.app/v1/web/search");
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://agentbit.app/v1/web/search")
if res.status_code == 402:
    accepts = res.json()["accepts"]
    # pay one of accepts[] via an x402 client, then retry with the payment header