{"uid":"cap_UuFI726IbLU4PNkBjvtul","slug":"tolca-web-search-a731363b","name":"Tolca Web Search","description":"Ask about any company or Québec contractor and get a verdict grounded in official registries, not guesses. Plus web search that reads the pages for you. Pay per call, no account.","url":"https://tolca.tonbot.ca/v1/web-search?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"lang":{"enum":["auto","fr","en"],"type":"string","default":"auto"},"read":{"type":"integer","default":3,"maximum":5,"minimum":0,"description":"Top pages to fetch and return as clean text"},"site":{"type":"string","example":"github.com"},"query":{"type":"string","example":"subvention thermopompe Québec 2026","description":"Question or keywords; Brave operators allowed (site:, \"exact\", -word)"},"country":{"type":"string","default":"CA","example":"CA"},"official":{"type":"boolean","default":false,"description":"Only governments, registries, courts, laws"},"freshness":{"enum":["none","24h","7d","30d"],"type":"string","default":"none"},"max_chars":{"type":"integer","default":6000,"maximum":20000,"minimum":1000}}},"responseSchema":{"type":"json","example":{"lang":"fr","count":10,"pages":[{"url":"https://www.hydroquebec.com/residentiel/mieux-consommer/logisvert/","kind":"html","text":"Clean page text...","chars":5400,"title":"Programme LogisVert","sha256":"3b1c...","read_ms":820,"truncated":false,"fetched_at":"2026-10-17T20:00:00Z"}],"query":"subvention thermopompe Québec 2026","notice":"No results = HTTP 404 = no charge.","country":"CA","results":[{"age":"2026-09-02","url":"https://www.hydroquebec.com/residentiel/mieux-consommer/logisvert/","rank":1,"title":"Programme LogisVert","snippet":"Aide financière pour l'installation d'une thermopompe...","official":false}],"took_ms":2100,"official":false}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.008","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.008/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.008","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.008","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_CLcHpIE8fSwuXZtDKWprj","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.008","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Performs a web search and optionally fetches and returns clean text content from the top result pages, with support for language, freshness, and official-only filters.","exampleAgentPrompt":"Search the web in French for 'subvention thermopompe Québec 2026', restrict to official government sources only, and read the top 3 pages so I can see the actual content.","exampleUseCases":[{"title":"Quebec home subsidy research","prompt":"Search for current Quebec government subsidies for heat pump installation in 2026, official sources only, and read the top 3 pages so I can see the actual program details."},{"title":"Recent news on a Canadian company","prompt":"Search the web for recent news about Bombardier in the last 30 days and fetch the text from the top 2 results so I can read what's been reported."},{"title":"Site-specific regulatory lookup","prompt":"Search site:legisquebec.gouv.qc.ca for the latest rules on contractor licensing in Quebec and read the top 2 pages so I can see the actual legal text."}],"resultDescription":"A JSON object containing the interpreted language, total result count, ranked search results with title, URL, snippet, age, and official flag, plus optionally the clean extracted text of up to 5 fetched pages including character count, fetch time, and a SHA256 hash. Also includes total response time in milliseconds and a notice about no-charge 404s.","failureModes":["HTTP 404 returned when no results are found (no charge applied)","Page fetch timeout or unreachable URL results in missing text for that page","Query too vague or unsupported Brave operators may return low-quality results","Official-only filter may return very few results for niche queries","max_chars limit may truncate long page content (truncated flag set to true)","Rate limiting or payment failure may prevent the call from completing"],"whenToPreferThis":"Choose this endpoint when you need to search the web AND optionally read the content of the result pages in a single pay-per-call request, especially for Quebec or Canadian topics requiring French-language or official-registry results. It is ideal when you want clean, readable text from pages without building your own scraper, or when you need to filter strictly to government and official sources. Prefer it over generic search APIs when operating in a Canadian/Quebec context or when you need both search metadata and page content in one round trip.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-30T06:32:09.781Z","isFirstParty":false,"canonicalSlug":"tolca-web-search-a731363b"}