{"uid":"cap_tu0-Xiihse4SVHcbuWiHz","slug":"toll402-local-business-search-f41d571f","name":"Toll402 Local Business Search","description":"Global business directory for agents (any city in the world; unknown cities are seeded on demand). Search by city, country, category, text or proximity; every result carries a dated verification score (0-100), level (unverified/listed/corroborated/verified/owner_verified) and, on request, the evidence behind it. Open data + live checks + owner claims, never scraped review sites.","url":"https://toll402.dev/v1/biz/search","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","properties":{"city":{"type":"string","maxLength":80,"description":"City label, e.g. 'Ciudad de México'"},"near":{"type":"object","required":["lat","lon"],"properties":{"lat":{"type":"number"},"lon":{"type":"number"},"radiusKm":{"type":"number","default":3,"maximum":50,"minimum":0.1}},"additionalProperties":false},"limit":{"type":"integer","default":10,"maximum":50,"minimum":1},"query":{"type":"string","maxLength":200,"description":"Free text: name, cuisine, service…"},"offset":{"type":"integer","default":0,"minimum":0},"channel":{"enum":["whatsapp","email","instagram","facebook","linkedin","booking","contactForm","telegram"],"type":"string","description":"Only businesses with this contact channel found on their own website or open data"},"cityKey":{"type":"string","maxLength":60,"description":"Coverage key, e.g. 'cdmx' or one returned in `coverage` (see GET /v1/biz/coverage)"},"country":{"type":"string","maxLength":2,"minLength":2,"description":"ISO 3166-1 alpha-2"},"category":{"enum":["restaurant","cafe","bar","bakery","hotel","travel","car_rental","pharmacy","clinic","dentist","veterinary","optician","lawyer","notary","accountant","insurance","real_estate","architect","it_services","company","wholesale","manufacturing","agriculture","medical_supply","import_export","packaging","chemicals","textiles","construction_materials","machinery","marketing","consulting","finance","coworking","recruiting","logistics","engineering","bank","atm","school","museum","entertainment","gym","salon","supermarket","hardware","electronics","clothing","jewelry","furniture","bookstore","florist","pet","sports","gifts","department_store","auto","laundry","printing","trades","post","government","religion","childcare","other"],"type":"string","description":"One of: restaurant, cafe, bar, bakery, hotel, travel, car_rental, pharmacy, clinic, dentist, veterinary, optician, lawyer, notary, accountant, insurance, real_estate, architect, it_services, company, wholesale, manufacturing, agriculture, medical_supply, import_export, packaging, chemicals, textiles, construction_materials, machinery, marketing, consulting, finance, coworking, recruiting, logistics, engineering, bank, atm, school, museum, entertainment, gym, salon, supermarket, hardware, electronics, clothing, jewelry, furniture, bookstore, florist, pet, sports, gifts, department_store, auto, laundry, printing, trades, post, government, religion, childcare, other"},"hasEmail":{"type":"boolean","description":"Only businesses with an email (mostly from official registries)"},"hasPhone":{"type":"boolean"},"minLevel":{"enum":["unverified","listed","corroborated","verified","owner_verified"],"type":"string"},"minScore":{"type":"integer","default":0,"maximum":100,"minimum":0,"description":"Only businesses with verification score ≥ this"},"diversify":{"type":"boolean","default":true,"description":"Collapse chains: at most one result per website domain"},"hasWebsite":{"type":"boolean","description":"Only businesses with a website"},"claimedOnly":{"type":"boolean","default":false},"enrichedOnly":{"type":"boolean","description":"Only businesses whose own website has been crawled and summarized (services, prices, booking, social)"},"minEmployees":{"type":"integer","maximum":251,"minimum":0,"description":"Minimum staff size from official registry bands (6, 11, 31, 51, 101, 251). Great for B2B supplier searches."},"includeEvidence":{"type":"boolean","default":false}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"ms":{"type":"integer"},"ok":{"type":"boolean"},"tool":{"type":"string"},"result":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"contact":{"type":"object","properties":{"phone":{"type":"string"},"website":{"type":"string"}}},"category":{"type":"string"},"location":{"type":"object","properties":{"city":{"type":"string"}}},"verification":{"type":"object","properties":{"level":{"type":"string"},"score":{"type":"integer"},"lastVerifiedAt":{"type":"string"}}}}}},"total":{"type":"integer"}}}}}}}}},"responseSchema":{"type":"json","example":{"items":[{"id":"osm:node/123","name":"Clínica Dental Roma","contact":{"phone":"+5255...","website":"https://..."},"category":"dentist","location":{"city":"Ciudad de México"},"verification":{"level":"corroborated","score":68,"lastVerifiedAt":"2026-09-07T00:00:00Z"}}],"total":120}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","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.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_tGi60XVMQRhfNPLZ1dAMJ","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Search a verified local-business directory by city, category, text query, or coordinates and receive results with dated verification scores and trust levels","exampleAgentPrompt":"Find me up to 10 owner-verified or verified restaurants in Mexico City — I only want results with a verification score of at least 70, and include the evidence behind each listing.","exampleUseCases":[{"title":"Vetting local clinics before recommending","prompt":"Search for verified clinics in Buenos Aires, Argentina — only show me ones with a verification level of at least 'verified' and a score above 60, and include the evidence so I can see what sources back them up."},{"title":"Proximity-based café discovery","prompt":"Find cafes within 3km of latitude 48.8566, longitude 2.3522 — that's central Paris — and show me up to 20 results, only ones that are at least 'corroborated'."},{"title":"Agent vetting a local accountant","prompt":"I need a list of accountants in Berlin, Germany that have been claimed by their owners. Return up to 5 results and include the verification evidence for each one."}],"resultDescription":"A paginated list of business records, each containing the business name, category, location, a numeric verification score (0-100), a verification level (unverified/listed/corroborated/verified/owner_verified) with its date, and optionally the structured evidence sources that support the score. Results can be filtered by geography, category, free text, minimum score, and trust level.","failureModes":["No results found for the requested city or coverage area — city may not be indexed (check /v1/biz/coverage)","Invalid country code (non-ISO 3166-1 alpha-2) returns a 400 validation error","Coordinates out of supported radius range (0.1–50 km) return a validation error","minScore or minLevel filters too restrictive return an empty result set","Payment failure via x402 protocol returns 402 with payment details","Query text exceeding 200 characters is rejected","Providing both 'city' and 'near' may cause ambiguous location resolution"],"whenToPreferThis":"Choose this endpoint when you need verified, trust-scored local business data rather than raw scraped listings or unvalidated review-site data. It is ideal when an agent needs to recommend businesses to a user and must convey confidence levels, or when the downstream task requires filtering by verification tier (e.g. only owner-verified). Prefer it over generic web search when structured, filterable directory results with explicit trust metadata are needed.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T19:05:11.818Z","isFirstParty":false}