Small businesses in Costa Rica, Panama, Guatemala and Dominican Republic: WhatsApp, phone, email
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Bearer fy_live_… key from your account at www.fyrmo.com
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Buys the list priced with quote_list: same filters and count, plus max_credits, the most the person agreed to spend. Reveals the businesses in order of record quality, never spends more than max_credits (businesses already revealed come free) and returns one row per business (WhatsApp with its wa.me link, mobile, phone, email, website, place, when the contact was last seen) plus a receipt: delivered, charged, free, how many have WhatsApp, credits per WhatsApp and credits left. Only businesses with at least one contact are listed; to pay only for WhatsApp, set channel: 'whatsapp'.
How many businesses the list should have (max 200)
The most credits the person agreed to spend in this call
Part of the business name
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
Only businesses with this social profile
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
Only businesses with this contact (mobile: a mobile number published as a phone, likely WhatsApp)
CR (Costa Rica, the default), PA (Panama), GT (Guatemala) or DO (Dominican Republic)
none: no website (or it is down or parked); has: a working website
true: its own website has a Meta or TikTok ad pixel
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 slug, named in search_businesses and list_categories
Hotels: at least this many rooms
Only businesses whose own website is built with this CMS or site builder
own_domain: email on the business's own domain; free: Gmail, Hotmail, Outlook, Yahoo, iCloud and similar
true: its own website is an online store (Shopify, WooCommerce with products, PrestaShop…)
true: its own website shows no update in two years or more (copyright year or page dates)
true: small businesses only, no chain locations
Minimum WhatsApp confidence, 0 to 1
The server marks this tool as destructive. Running it may delete or overwrite data on the server or in any account you connected with your headers.
Pick your client. Values in capitals, like YOUR_TOKEN, are yours to fill in.
Run in a terminal
claude mcp add --transport http fyrmo https://www.fyrmo.com/api/mcp \ --header 'Authorization: Bearer YOUR_TOKEN'
Headers
Authorization (required): Bearer fy_live_… key from your account at www.fyrmo.comBuys the list priced with quote_list: same filters and count, plus max_credits, the most the person agreed to spend. Reveals the businesses in order of record quality, never spends more than max_credits (businesses already revealed come free) and returns one row per business (WhatsApp with its wa.me link, mobile, phone, email, website, place, when the contact was last seen) plus a receipt: delivered, charged, free, how many have WhatsApp, credits per WhatsApp and credits left. Only businesses with at least one contact are listed; to pay only for WhatsApp, set channel: 'whatsapp'.
| Argument | Type | Description |
|---|---|---|
| name | string | Part of the business name |
| count* | integer | How many businesses the list should have (max 200) |
| place | string | 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 |
| social | string | Only businesses with this social profile |
| booking | string | 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 | string | Only businesses with this contact (mobile: a mobile number published as a phone, likely WhatsApp) |
| country | string | CR (Costa Rica, the default), PA (Panama), GT (Guatemala) or DO (Dominican Republic) |
| website | string | none: no website (or it is down or parked); has: a working website |
| ad_pixel | boolean | true: its own website has a Meta or TikTok ad pixel |
| category | string | 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 | string | Industry slug, named in search_businesses and list_categories |
| min_rooms | integer | Hotels: at least this many rooms |
| built_with | string | Only businesses whose own website is built with this CMS or site builder |
| email_type | string | own_domain: email on the business's own domain; free: Gmail, Hotmail, Outlook, Yahoo, iCloud and similar |
| max_credits* | integer | The most credits the person agreed to spend in this call |
| online_store | boolean | true: its own website is an online store (Shopify, WooCommerce with products, PrestaShop…) |
| outdated_site | boolean | true: its own website shows no update in two years or more (copyright year or page dates) |
| independent_only | boolean | true: small businesses only, no chain locations |
| min_whatsapp_confidence | number | Minimum WhatsApp confidence, 0 to 1 |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"count",
"max_credits"
],
"properties": {
"name": {
"type": "string",
"maxLength": 120,
"description": "Part of the business name"
},
"count": {
"type": "integer",
"maximum": 200,
"minimum": 1,
"description": "How many businesses the list should have (max 200)"
},
"place": {
"type": "string",
"maxLength": 80,
"description": "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"
},
"social": {
"enum": [
"instagram",
"facebook",
"tiktok",
"youtube",
"linkedin",
"x"
],
"type": "string",
"description": "Only businesses with this social profile"
},
"booking": {
"enum": [
"whatsapp",
"no_booking_system",
"booking_system"
],
"type": "string",
"description": "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": {
"enum": [
"whatsapp",
"phone",
"email",
"website",
"mobile"
],
"type": "string",
"description": "Only businesses with this contact (mobile: a mobile number published as a phone, likely WhatsApp)"
},
"country": {
"enum": [
"CR",
"PA",
"GT",
"DO"
],
"type": "string",
"description": "CR (Costa Rica, the default), PA (Panama), GT (Guatemala) or DO (Dominican Republic)"
},
"website": {
"enum": [
"none",
"has"
],
"type": "string",
"description": "none: no website (or it is down or parked); has: a working website"
},
"ad_pixel": {
"type": "boolean",
"description": "true: its own website has a Meta or TikTok ad pixel"
},
"category": {
"type": "string",
"maxLength": 40,
"description": "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": {
"enum": [
"tienda",
"restaurante",
"hospedaje",
"automotriz",
"salon_belleza",
"gimnasio",
"spa",
"salud",
"veterinaria",
"educacion",
"servicios",
"construccion_hogar",
"eventos",
"industria",
"agro",
"imprenta_medios",
"transporte",
"entretenimiento",
"finanzas",
"otros"
],
"type": "string",
"description": "Industry slug, named in search_businesses and list_categories"
},
"min_rooms": {
"type": "integer",
"maximum": 2000,
"minimum": 1,
"description": "Hotels: at least this many rooms"
},
"built_with": {
"enum": [
"wordpress",
"wix",
"godaddy",
"squarespace",
"shopify",
"google_sites",
"webflow",
"joomla"
],
"type": "string",
"description": "Only businesses whose own website is built with this CMS or site builder"
},
"email_type": {
"enum": [
"own_domain",
"free"
],
"type": "string",
"description": "own_domain: email on the business's own domain; free: Gmail, Hotmail, Outlook, Yahoo, iCloud and similar"
},
"max_credits": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "The most credits the person agreed to spend in this call"
},
"online_store": {
"type": "boolean",
"description": "true: its own website is an online store (Shopify, WooCommerce with products, PrestaShop…)"
},
"outdated_site": {
"type": "boolean",
"description": "true: its own website shows no update in two years or more (copyright year or page dates)"
},
"independent_only": {
"type": "boolean",
"description": "true: small businesses only, no chain locations"
},
"min_whatsapp_confidence": {
"type": "number",
"maximum": 1,
"minimum": 0,
"description": "Minimum WhatsApp confidence, 0 to 1"
}
}
}Credit packs (100 = US$29, 500 = US$119, 2,000 = US$399, 10,000 = US$1,490) with their Stripe payment link. The link carries the client number, so credits load on their own once the payment completes. Give the link to the person as is; Fyrmo never asks for card details here.
No arguments.
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
}Businesses like a given one: same industry, categories in common, nearby (same canton, then province) and the same signals (website, Instagram/TikTok, how they book, independent). Use it to grow a list from a business that worked. No credits; counts toward the daily search results; contacts are not shown.
| Argument | Type | Description |
|---|---|---|
| code* | string | Business code to start from |
| limit | integer | How many (max 50, default 20) |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"code"
],
"properties": {
"code": {
"type": "string",
"maxLength": 32,
"minLength": 6,
"description": "Business code to start from"
},
"limit": {
"type": "integer",
"maximum": 50,
"minimum": 1,
"description": "How many (max 50, default 20)"
}
}
}The full record of one business (code) or up to 10 (codes): location, description, opening hours (OpenStreetMap format), its website in detail (what it is built with, last update, https, mobile version, online store, booking system, travel sites, delivery apps, payments, chat, analytics and ad pixels), social profiles, attributes with their source (services, prices, how it takes bookings) and its contacts. No credits, up to 300 a day (20 until the account buys credits); revealed ones don't count. Contacts stay masked and social profiles hidden (value null, hidden true) until revealed.
| Argument | Type | Description |
|---|---|---|
| code | string | Business code, from search_businesses |
| codes | array | Several codes at once (max 10) |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"code": {
"type": "string",
"maxLength": 32,
"minLength": 6,
"description": "Business code, from search_businesses"
},
"codes": {
"type": "array",
"items": {
"type": "string",
"maxLength": 32,
"minLength": 6
},
"maxItems": 10,
"minItems": 1,
"description": "Several codes at once (max 10)"
}
}
}Every industry and category slug Fyrmo uses, with its English and Spanish name and how many businesses it has (Costa Rica and Panama together). Use the slugs as industry and category in the other tools. No credits, works without a key.
| Argument | Type | Description |
|---|---|---|
| industry | string | Only this industry's categories |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"industry": {
"enum": [
"tienda",
"restaurante",
"hospedaje",
"automotriz",
"salon_belleza",
"gimnasio",
"spa",
"salud",
"veterinaria",
"educacion",
"servicios",
"construccion_hogar",
"eventos",
"industria",
"agro",
"imprenta_medios",
"transporte",
"entretenimiento",
"finanzas",
"otros"
],
"type": "string",
"description": "Only this industry's categories"
}
}
}Finds which businesses of a list the person already has (a CRM export, a spreadsheet) are in Fyrmo. Each row matches by phone, email or own website, or by exact name plus canton or district; a phone or website shared by several businesses (a chain, a directory) only counts when the name tells them apart. Returns, per row (0-based), the business code and what it matched by, or why not (no_data, not_found, ambiguous, daily_limit), plus the matched businesses without their contacts. No credits; counts toward the daily search results; reveal the ones they want with reveal_contacts. Up to 200 rows per call. The list is not stored.
| Argument | Type | Description |
|---|---|---|
| rows* | array |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"rows"
],
"properties": {
"rows": {
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string",
"maxLength": 200,
"description": "Business name"
},
"email": {
"type": "string",
"maxLength": 200
},
"phone": {
"type": "string",
"maxLength": 200,
"description": "Phone, mobile or WhatsApp in any format; several separated by /"
},
"place": {
"type": "string",
"maxLength": 100,
"description": "Canton or district, e.g. 'Escazú'"
},
"website": {
"type": "string",
"maxLength": 300,
"description": "Website or domain"
}
}
},
"maxItems": 200,
"minItems": 1
}
}
}The businesses you revealed with their contacts and wa.me links, the last outcome you reported and when the reveal expires (after that the contacts come back masked until revealed again), plus your balance.
| Argument | Type | Description |
|---|---|---|
| limit | integer | |
| offset | integer | |
| status | string |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"limit": {
"type": "integer",
"maximum": 200,
"minimum": 1
},
"offset": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
"status": {
"enum": [
"all",
"not_contacted",
"contacted"
],
"type": "string"
}
}
}Prices a list before buying it. Takes the same filters as search_businesses plus how many businesses you want (up to 200) and says how many match, how many of the first `count` with contacts you already revealed (free again) and how many credits the rest would cost, with a 10-row sample. Spends no credits. Show the person the price, then call build_list with the same filters.
| Argument | Type | Description |
|---|---|---|
| name | string | Part of the business name |
| count* | integer | How many businesses the list should have (max 200) |
| place | string | 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 |
| social | string | Only businesses with this social profile |
| booking | string | 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 | string | Only businesses with this contact (mobile: a mobile number published as a phone, likely WhatsApp) |
Records how the contact with a revealed business went. wrong_number and closed give the credit back (within 14 days, up to 10% of what was revealed that month) and send the business back to research. Use note 'do not contact' when a business asks not to be written to again.
| Argument | Type | Description |
|---|---|---|
| code* | string | |
| note | string | |
| contact | string | The number or email used; defaults to the main contact |
| outcome* | string |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"code",
"outcome"
],
"properties": {
"code": {
"type": "string",
"maxLength": 32,
"minLength": 6
},
"note": {
"type": "string",
"maxLength": 500
},
"contact": {
"type": "string",
"maxLength": 200,
"description": "The number or email used; defaults to the main contact"
},
"outcome": {
"enum": [
"worked",
"no_answer",
"wrong_number",
"not_whatsapp",
"closed"
],
"type": "string"
}
}
}Returns the WhatsApp, mobile, phone and email of up to 50 businesses, each with its confidence, sources and last-seen date, and a wa.me link for every WhatsApp or mobile so the person can write one to one (their social profiles then show in get_business). Costs 1 credit per new business; businesses already revealed (12 months) and businesses without contacts are not charged. Limit: 500 per day.
| Argument | Type | Description |
|---|---|---|
| codes* | array | Business codes |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"codes"
],
"properties": {
"codes": {
"type": "array",
"items": {
"type": "string",
"maxLength": 32,
"minLength": 6
},
"maxItems": 50,
"minItems": 1,
"description": "Business codes"
}
}
}Search 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.
| Argument | Type | Description |
|---|---|---|
| name | string | Part of the business name |
| limit | integer | Results per page (max 50, default 20) |
| place | string | 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 | string | full (default) or summary |
How many businesses each segment has and how many of them have WhatsApp, without listing them. No credits, and doesn't count toward the daily search results. Use it to choose who to target before searching: e.g. for someone who sells espresso machines, compare cafés, bakeries, hotels and restaurants in a place. A segment takes the same filters as search_businesses. Up to 6 segments per call; results come back in the same order.
| Argument | Type | Description |
|---|---|---|
| segments* | array | The segments to compare |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"segments"
],
"properties": {
"segments": {
"type": "array",
"items": {
"type": "object",
"properties": {
"place": {
"type": "string",
"maxLength": 80,
"description": "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"
},
"social": {
"enum": [
"instagram",
"facebook",
"tiktok",
"youtube",
"linkedin",
"x"
],
"type": "string",
"description": "Only businesses with this social profile"
},
"booking": {
"enum": [
"whatsapp",
"no_booking_system",
"booking_system"
],
"type": "string",
"description": "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": {
"enum": [
"whatsapp",
"phone",
"email",
"website",
"mobile"
],
"type": "string",
"description": "Only businesses with this contact (mobile: a mobile number published as a phone, likely WhatsApp)"
},
"country": {
"enum": [
"CR",
"PA",
"GT",
"DO"
],
"type": "string",
"description": "CR (Costa Rica, the default), PA (Panama), GT (Guatemala) or DO (Dominican Republic)"
},
"website": {
"enum": [
"none",
"has"
],
"type": "string",
"description": "none: no website (or it is down or parked); has: a working website"
},
"ad_pixel": {
"type": "boolean",
"description": "true: its own website has a Meta or TikTok ad pixel"
},
"category": {
"type": "string",
"maxLength": 40,
"description": "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": {
"enum": [
"tienda",
"restaurante",
"hospedaje",
"automotriz",
"salon_belleza",
"gimnasio",
"spa",
"salud",
"veterinaria",
"educacion",
"servicios",
"construccion_hogar",
"eventos",
"industria",
"agro",
"imprenta_medios",
"transporte",
"entretenimiento",
"finanzas",
"otros"
],
"type": "string",
"description": "Industry slug, named in search_businesses and list_categories"
},
"min_rooms": {
"type": "integer",
"maximum": 2000,
"minimum": 1,
"description": "Hotels: at least this many rooms"
},
"built_with": {
"enum": [
"wordpress",
"wix",
"godaddy",
"squarespace",
"shopify",
"google_sites",
"webflow",
"joomla"
],
"type": "string",
"description": "Only businesses whose own website is built with this CMS or site builder"
},
"email_type": {
"enum": [
"own_domain",
"free"
],
"type": "string",
"description": "own_domain: email on the business's own domain; free: Gmail, Hotmail, Outlook, Yahoo, iCloud and similar"
},
"online_store": {
"type": "boolean",
"description": "true: its own website is an online store (Shopify, WooCommerce with products, PrestaShop…)"
},
"outdated_site": {
"type": "boolean",
"description": "true: its own website shows no update in two years or more (copyright year or page dates)"
},
"independent_only": {
"type": "boolean",
"description": "true: small businesses only, no chain locations"
}
}
},
"maxItems": 6,
"minItems": 1,
"description": "The segments to compare"
}
}
}We read every tool's name, description and inputs the way the model will, looking for instructions hidden from you. A clean result means no warning signs, not a guarantee. Scanned Nov 16, 2026.
| country | string | CR (Costa Rica, the default), PA (Panama), GT (Guatemala) or DO (Dominican Republic) |
| website | string | none: no website (or it is down or parked); has: a working website |
| ad_pixel | boolean | true: its own website has a Meta or TikTok ad pixel |
| category | string | 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 | string | Industry slug, named in search_businesses and list_categories |
| min_rooms | integer | Hotels: at least this many rooms |
| built_with | string | Only businesses whose own website is built with this CMS or site builder |
| email_type | string | own_domain: email on the business's own domain; free: Gmail, Hotmail, Outlook, Yahoo, iCloud and similar |
| online_store | boolean | true: its own website is an online store (Shopify, WooCommerce with products, PrestaShop…) |
| outdated_site | boolean | true: its own website shows no update in two years or more (copyright year or page dates) |
| independent_only | boolean | true: small businesses only, no chain locations |
| min_whatsapp_confidence | number | Minimum WhatsApp confidence, 0 to 1 |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"count"
],
"properties": {
"name": {
"type": "string",
"maxLength": 120,
"description": "Part of the business name"
},
"count": {
"type": "integer",
"maximum": 200,
"minimum": 1,
"description": "How many businesses the list should have (max 200)"
},
"place": {
"type": "string",
"maxLength": 80,
"description": "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"
},
"social": {
"enum": [
"instagram",
"facebook",
"tiktok",
"youtube",
"linkedin",
"x"
],
"type": "string",
"description": "Only businesses with this social profile"
},
"booking": {
"enum": [
"whatsapp",
"no_booking_system",
"booking_system"
],
"type": "string",
"description": "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": {
"enum": [
"whatsapp",
"phone",
"email",
"website",
"mobile"
],
"type": "string",
"description": "Only businesses with this contact (mobile: a mobile number published as a phone, likely WhatsApp)"
},
"country": {
"enum": [
"CR",
"PA",
"GT",
"DO"
],
"type": "string",
"description": "CR (Costa Rica, the default), PA (Panama), GT (Guatemala) or DO (Dominican Republic)"
},
"website": {
"enum": [
"none",
"has"
],
"type": "string",
"description": "none: no website (or it is down or parked); has: a working website"
},
"ad_pixel": {
"type": "boolean",
"description": "true: its own website has a Meta or TikTok ad pixel"
},
"category": {
"type": "string",
"maxLength": 40,
"description": "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": {
"enum": [
"tienda",
"restaurante",
"hospedaje",
"automotriz",
"salon_belleza",
"gimnasio",
"spa",
"salud",
"veterinaria",
"educacion",
"servicios",
"construccion_hogar",
"eventos",
"industria",
"agro",
"imprenta_medios",
"transporte",
"entretenimiento",
"finanzas",
"otros"
],
"type": "string",
"description": "Industry slug, named in search_businesses and list_categories"
},
"min_rooms": {
"type": "integer",
"maximum": 2000,
"minimum": 1,
"description": "Hotels: at least this many rooms"
},
"built_with": {
"enum": [
"wordpress",
"wix",
"godaddy",
"squarespace",
"shopify",
"google_sites",
"webflow",
"joomla"
],
"type": "string",
"description": "Only businesses whose own website is built with this CMS or site builder"
},
"email_type": {
"enum": [
"own_domain",
"free"
],
"type": "string",
"description": "own_domain: email on the business's own domain; free: Gmail, Hotmail, Outlook, Yahoo, iCloud and similar"
},
"online_store": {
"type": "boolean",
"description": "true: its own website is an online store (Shopify, WooCommerce with products, PrestaShop…)"
},
"outdated_site": {
"type": "boolean",
"description": "true: its own website shows no update in two years or more (copyright year or page dates)"
},
"independent_only": {
"type": "boolean",
"description": "true: small businesses only, no chain locations"
},
"min_whatsapp_confidence": {
"type": "number",
"maximum": 1,
"minimum": 0,
"description": "Minimum WhatsApp confidence, 0 to 1"
}
}
}| offset |
| integer |
| Skip this many results (use next_offset) |
| social | string | Only businesses with this social profile |
| booking | string | 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 | string | Only businesses with this contact (mobile: a mobile number published as a phone, likely WhatsApp) |
| country | string | CR (Costa Rica, the default), PA (Panama), GT (Guatemala) or DO (Dominican Republic) |
| website | string | none: no website (or it is down or parked); has: a working website |
| ad_pixel | boolean | true: its own website has a Meta or TikTok ad pixel |
| category | string | 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 | string | 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 | integer | Hotels: at least this many rooms |
| built_with | string | Only businesses whose own website is built with this CMS or site builder |
| email_type | string | own_domain: email on the business's own domain; free: Gmail, Hotmail, Outlook, Yahoo, iCloud and similar |
| online_store | boolean | true: its own website is an online store (Shopify, WooCommerce with products, PrestaShop…) |
| outdated_site | boolean | true: its own website shows no update in two years or more (copyright year or page dates) |
| independent_only | boolean | true: small businesses only, no chain locations |
| min_whatsapp_confidence | number | Minimum WhatsApp confidence, 0 to 1 |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"name": {
"type": "string",
"maxLength": 120,
"description": "Part of the business name"
},
"limit": {
"type": "integer",
"maximum": 50,
"minimum": 1,
"description": "Results per page (max 50, default 20)"
},
"place": {
"type": "string",
"maxLength": 80,
"description": "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": {
"enum": [
"full",
"summary"
],
"type": "string",
"description": "full (default) or summary"
},
"offset": {
"type": "integer",
"maximum": 999,
"minimum": 0,
"description": "Skip this many results (use next_offset)"
},
"social": {
"enum": [
"instagram",
"facebook",
"tiktok",
"youtube",
"linkedin",
"x"
],
"type": "string",
"description": "Only businesses with this social profile"
},
"booking": {
"enum": [
"whatsapp",
"no_booking_system",
"booking_system"
],
"type": "string",
"description": "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": {
"enum": [
"whatsapp",
"phone",
"email",
"website",
"mobile"
],
"type": "string",
"description": "Only businesses with this contact (mobile: a mobile number published as a phone, likely WhatsApp)"
},
"country": {
"enum": [
"CR",
"PA",
"GT",
"DO"
],
"type": "string",
"description": "CR (Costa Rica, the default), PA (Panama), GT (Guatemala) or DO (Dominican Republic)"
},
"website": {
"enum": [
"none",
"has"
],
"type": "string",
"description": "none: no website (or it is down or parked); has: a working website"
},
"ad_pixel": {
"type": "boolean",
"description": "true: its own website has a Meta or TikTok ad pixel"
},
"category": {
"type": "string",
"maxLength": 40,
"description": "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": {
"enum": [
"tienda",
"restaurante",
"hospedaje",
"automotriz",
"salon_belleza",
"gimnasio",
"spa",
"salud",
"veterinaria",
"educacion",
"servicios",
"construccion_hogar",
"eventos",
"industria",
"agro",
"imprenta_medios",
"transporte",
"entretenimiento",
"finanzas",
"otros"
],
"type": "string",
"description": "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": {
"type": "integer",
"maximum": 2000,
"minimum": 1,
"description": "Hotels: at least this many rooms"
},
"built_with": {
"enum": [
"wordpress",
"wix",
"godaddy",
"squarespace",
"shopify",
"google_sites",
"webflow",
"joomla"
],
"type": "string",
"description": "Only businesses whose own website is built with this CMS or site builder"
},
"email_type": {
"enum": [
"own_domain",
"free"
],
"type": "string",
"description": "own_domain: email on the business's own domain; free: Gmail, Hotmail, Outlook, Yahoo, iCloud and similar"
},
"online_store": {
"type": "boolean",
"description": "true: its own website is an online store (Shopify, WooCommerce with products, PrestaShop…)"
},
"outdated_site": {
"type": "boolean",
"description": "true: its own website shows no update in two years or more (copyright year or page dates)"
},
"independent_only": {
"type": "boolean",
"description": "true: small businesses only, no chain locations"
},
"min_whatsapp_confidence": {
"type": "number",
"maximum": 1,
"minimum": 0,
"description": "Minimum WhatsApp confidence, 0 to 1"
}
}
}