Locus public pay-per-use API

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

{
  "bazaar": {
    "info": {
      "input": {
        "body": {
          "query": "x402 discovery"
        },
        "bodyType": "json",
        "method": "POST",
        "type": "http"
      },
      "output": {
        "example": {
          "data": {},
          "payment": {
            "authorizedMaxUsdc": "0.001000",
            "scheme": "exact",
            "settledUsdc": "0.001000"
          },
          "request": {
            "id": "00000000-0000-4000-8000-000000000000",
            "statusUrl": "/requests/00000000-0000-4000-8000-000000000000"
          },
          "success": true
        },
        "type": "json"
      }
    },
    "schema": {
      "$schema": "https://json-schema.org/draft/2020-12/schema",
      "properties": {
        "input": {
          "additionalProperties": false,
          "properties": {
            "body": {
              "additionalProperties": true,
              "properties": {
                "country": {
                  "description": "Country code for search results (e.g. \"us\", \"gb\")",
                  "type": "string"
                },
                "days": {
                  "description": "Only return results from the last N days",
                  "type": "number"
                },
                "exclude_domains": {
                  "description": "Exclude results from these domains",
                  "items": {
                    "type": "string"
                  },
                  "type": "array"
                },
                "include_answer": {
                  "description": "Include AI-generated answer: true, false, or 'advanced'",
                  "type": "boolean"
                },
                "include_domains": {
                  "description": "Only include results from these domains",
                  "items": {
                    "type": "string"
                  },
                  "type": "array"
                },
                "include_images": {
                  "description": "Include related images in results",
                  "type": "boolean"
                },
                "include_raw_content": {
                  "description": "Include raw HTML content in results",
                  "type": "boolean"
                },
                "max_results": {
                  "description": "Maximum number of results (default 5)",
                  "type": "number"
                },
                "query": {
                  "description": "Search query",
                  "type": "string"
                },
                "search_depth": {
                  "description": "Search depth: 'basic' (default) or 'advanced'",
                  "type": "string"
                },
                "topic": {
                  "description": "Topic category: 'general' (default) or 'news'",
                  "type": "string"
                }
              },
              "required": [
                "query"
              ],
              "type": "object"
            },
            "bodyType": {
              "enum": [
                "json",
                "form-data",
                "text"
              ],
              "type": "string"
            },
            "method": {
              "enum": [
                "POST"
              ],
              "type": "string"
            },
            "type": {
              "const": "http",
              "type": "string"
            }
          },
          "required": [
            "type",
            "method",
            "bodyType",
            "body"
          ],
          "type": "object"
        },
        "output": {
          "properties": {
            "example": {
              "type": "object"
            },
            "type": {
              "type": "string"
            }
          },
          "required": [
            "type"
          ],
          "type": "object"
        }
      },
      "required": [
        "input"
      ],
      "type": "object"
    }
  }
}

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

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