API · Desarrolladores
Mango en tu código.
Pide empresas en palabras o con un filtro y recíbelas en JSON, con contacto, tamaño, ingresos y la fuente de cada dato. Funciona igual desde tu backend, tu CRM o Claude Code.
Empieza en un minuto
1Crea una clave
2Guárdala en tu terminal o en tu .env
export MANGO_API_KEY="mango_sk_..."
3Pídeselo a Claude Code
Claude Code lee esta documentación en https://mangoa-ai.com/api/v1 y escribe el código por ti.
“Lee https://mangoa-ai.com/api/v1 y usa la API de Mango con la clave de $MANGO_API_KEY. Trae las clínicas de Cali con teléfono y guárdalas en clinicas.csv.”
O llámala tú
curl -G "https://mangoa-ai.com/api/v1/empresas" \ -H "Authorization: Bearer $MANGO_API_KEY" \ --data-urlencode "q=constructoras en Medellín con correo"
Escribe el pedido como en el chat de Mango. Si prefieres control total, manda un filtro (abajo).
Rutas
Todas bajo https://mangoa-ai.com/api/v1, con el encabezado Authorization: Bearer mango_sk_...
- GET · POSTGasta 1 por empresa
/empresasLa lista de empresas, 25 por página. Manda un pedido en palabras (q o pedido) o un filtro, y desde para pasar de página.
- GET · POSTNo gasta cuota
/empresas/contarCuántas cumplen el pedido y cuántas tienen correo, teléfono, web, representante legal o ingresos, y en qué ciudades hay más.
- GETGasta 1
/empresas/{pais}/{id_fiscal}Todos los datos de una empresa: todos sus correos, dirección, estados financieros y de qué fuente sale cada dato. País CO o MX; NIT sin dígito de verificación o RFC.
- GET · POSTGasta 1 por empresa
/decisoresLos decisores de una empresa (dueños, C-level, directores, gerentes, jefes), de a 60: nombre, cargo, área, LinkedIn y correo de trabajo deducido. pais + id_fiscal, o pais + dominio en México; areas y niveles opcionales.
- GETNo gasta cuota
/filtrosLas industrias, tipos de sociedad, rangos de empleados y órdenes que acepta el filtro.
- GETNo gasta cuota
/usoCuántas empresas llevas este mes y cuántas te quedan.
Con un filtro
Las condiciones se combinan con Y. Las claves de industria salen de /filtros; los ingresos van en pesos colombianos.
{
"filtro": {
"empresa": {
"pais": ["CO"],
"ciudad": ["Medellín"],
"industria": ["construccion"],
"ingresos_min": 1000000000
},
"contacto": { "correo": true },
"orden": "ingresos"
},
"desde": 0
}Respuesta
Cuando siguiente no es null, mándalo como desde para traer la página siguiente.
{
"total": 1469,
"desde": 0,
"siguiente": 25,
"entendido": ["con correo", "Medellín", "industria Construcción"],
"empresas": [
{
"pais": "CO",
"id_fiscal": "900000001",
"razon_social": "CONSTRUCTORA EJEMPLO S.A.S.",
"ciudad": "MEDELLÍN",
"actividad": "Construcción de edificios residenciales",
"correo": "contacto@constructoraejemplo.co",
"telefono": "3000000000",
"web": "constructoraejemplo.co",
"representante_legal": "NOMBRE DE EJEMPLO",
"tamano": "mediana",
"ingresos": 18500000000,
"ingresos_texto": "$18.500 M",
"proveedor_estado": true
}
],
"ver_en_mango": "https://mangoa-ai.com/buscar?q=..."
}Límites y errores
- Hasta 60 llamadas por minuto por cuenta.
- Cada empresa que traes en una lista o una ficha cuenta para la cuota del mes. Contar y ver los filtros no gasta.
- Cada respuesta trae
x-cuota-restantecon las empresas que te quedan. - Lo que busques por la API queda en tu Actividad, igual que en la app.
entrada_no_valida · pedido_vacioFalta el pedido o el filtro tiene un campo mal escrito. El mensaje dice cuál.sin_clave · clave_no_validaNo llegó la clave, o fue revocada.no_encontradaEsa empresa no está en Mango.demasiadas_llamadas · cuota_agotadaMás de 60 llamadas en un minuto, o se acabó la cuota del mes.Los errores llegan como {"error": {"codigo", "mensaje"}}. Mango no entrega números de documento de personas, y usar las listas tiene las mismas reglas que en la app: contacto comercial entre empresas y la opción de salir en cada mensaje.