Search businesses
search_businessesSearch businesses in Costa Rica (or Panama with country: 'PA', Guatemala with 'GT', the Dominican Republic with 'DO') by industry, category, place, name and contact channel. Costs no credits: says which contacts each business has without revealing them, sorted by record quality. Combine industry and place with website, social, booking, min_rooms, email_type, ad_pixel, online_store, built_with and outdated_site to find the right target (spas that book on WhatsApp, businesses on Instagram with no website, stores that use Gmail, Wix sites not updated in years). Each result has signals with the same words: website, social, booking, booking_systems, rooms, email_type, ad_pixels, online_store, built_with, site_year (last update), no_mobile_version, no_https and opening_hours (OpenStreetMap format). Returns total and next_offset (null on the last page). Up to 3,000 results a day (100 until the account buys credits) and the first 1,000 of each search. detail: 'summary' drops signals and categories to save tokens.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "search_businesses"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | Part of the business name | |
| limit | No | Results per page (max 50, default 20) | |
| place | No | Province, canton or district in Costa Rica (e.g. 'Escazú', 'La Fortuna', 'Heredia'); in Panama, province, district or corregimiento (e.g. 'Chiriquí', 'David', 'Bella Vista'); in Guatemala, department or municipality (e.g. 'Quetzaltenango', 'Mixco'); in the Dominican Republic, province or municipality (e.g. 'La Vega', 'Santo Domingo Este'). Accents optional | |
| detail | No | full (default) or summary | |
| offset | No | Skip this many results (use next_offset) | |
| social | No | Only businesses with this social profile | |
| booking | No | How they take bookings: through WhatsApp, without a booking system (phone, email, form) or with one. Known for about 1,500 businesses, mostly spas, salons and hotels | |
| channel | No | Only businesses with this contact (mobile: a mobile number published as a phone, likely WhatsApp) | |
| country | No | CR (Costa Rica, the default), PA (Panama), GT (Guatemala) or DO (Dominican Republic) | |
| website | No | none: no website (or it is down or parked); has: a working website | |
| ad_pixel | No | true: its own website has a Meta or TikTok ad pixel | |
| category | No | Category slug inside the industry, e.g. barberia, odontologia, pulperia_minisuper, taller_mecanico, hotel. list_categories has them all; an unknown one comes back with the valid ones | |
| industry | No | Industry: tienda (Retail and convenience stores), restaurante (Restaurants and cafés), hospedaje (Hotels and lodging), automotriz (Auto repair and parts), salon_belleza (Beauty salons and barbers), gimnasio (Gyms and fitness), spa (Spas), salud (Clinics, doctors and labs), veterinaria (Veterinary clinics), educacion (Private schools and academies), servicios (Professional services), construccion_hogar (Construction and home services), eventos (Events and parties), industria (Manufacturers and distributors), agro (Farms and agriculture), imprenta_medios (Printing, signs and media), transporte (Transport, freight and car rental), entretenimiento (Entertainment, sports and recreation), finanzas (Banks, lenders and credit unions), otros (Other businesses) | |
| min_rooms | No | Hotels: at least this many rooms | |
| built_with | No | Only businesses whose own website is built with this CMS or site builder | |
| email_type | No | own_domain: email on the business's own domain; free: Gmail, Hotmail, Outlook, Yahoo, iCloud and similar | |
| online_store | No | true: its own website is an online store (Shopify, WooCommerce with products, PrestaShop…) | |
| outdated_site | No | true: its own website shows no update in two years or more (copyright year or page dates) | |
| independent_only | No | true: small businesses only, no chain locations | |
| min_whatsapp_confidence | No | Minimum WhatsApp confidence, 0 to 1 |