Api Endpoint

Tolca

Search the web and read the top pages in ONE call: 10 results (title, url, snippet, date) plus the clean text of the best pages, with fetch time and sha256. French and Canada by default when the query is French; official-sources mode (governments, registries, courts, laws); freshness filter; site: restriction. No results = HTTP 404 = you are not charged. Input: query, optional read (0-5), official, lang, country, freshness, site.

Open interactive test console

Offering

Provider
tolca.tonbot.ca
Method
POST
Offering type
Api Endpoint
Transport type
http
Category
Other
Delivery
Not provided
Pricing model
Not provided
x402 version
2

Endpoint context

URL
https://tolca.tonbot.ca/v1/web-search
MIME type
application/json
First seen
2026-10-19T02:32:25.008Z
Last seen
Tags
Search, Web, scrape, markdown, Research, french, canada, AI-agent

Payment pricing

x402 payment terms are the authoritative price for calling this endpoint.

Payment option 1
0.008 USDC
Atomic price: 8000 · Network: eip155:8453 · Asset: USDC · Scheme: exact
Raw x402 terms
[
  {
    "scheme": "exact",
    "network": "eip155:8453",
    "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "amount": "8000",
    "payTo": "0x35F0B86a7E33F561faf7cfa5654CAd9162C4A17d"
  }
]

Observed health

Status
Healthy
Latest latency
72 ms
Average latency
718 ms
HTTP status
200
Last checked
Reachability
92.3% over 13 checks

Latency is measured to the first response headers. A reachable result does not verify response accuracy or merchant identity.

Input schema

{
  "type": "object",
  "properties": {
    "type": {
      "type": "string",
      "const": "http"
    },
    "method": {
      "type": "string",
      "enum": [
        "POST"
      ]
    },
    "bodyType": {
      "type": "string",
      "enum": [
        "json",
        "form-data",
        "text"
      ]
    },
    "body": {
      "type": "object",
      "properties": {
        "query": {
          "type": "string",
          "example": "subvention thermopompe Québec 2026",
          "description": "Question or keywords; Brave operators allowed (site:, \"exact\", -word)"
        },
        "read": {
          "type": "integer",
          "minimum": 0,
          "maximum": 5,
          "default": 3,
          "description": "Top pages to fetch and return as clean text"
        },
        "official": {
          "type": "boolean",
          "default": false,
          "description": "Only governments, registries, courts, laws"
        },
        "lang": {
          "type": "string",
          "enum": [
            "auto",
            "fr",
            "en"
          ],
          "default": "auto"
        },
        "country": {
          "type": "string",
          "default": "CA",
          "example": "CA"
        },
        "freshness": {
          "type": "string",
          "enum": [
            "none",
            "24h",
            "7d",
            "30d"
          ],
          "default": "none"
        },
        "site": {
          "type": "string",
          "example": "github.com"
        },
        "max_chars": {
          "type": "integer",
          "minimum": 1000,
          "maximum": 20000,
          "default": 6000
        }
      },
      "required": [
        "query"
      ]
    }
  },
  "required": [
    "type",
    "method",
    "bodyType",
    "body"
  ],
  "additionalProperties": false
}

Output schema

{
  "type": "object",
  "properties": {
    "type": {
      "type": "string"
    },
    "example": {
      "type": "object"
    }
  },
  "required": [
    "type"
  ]
}