mango.ai

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

Entra a tu cuenta y ve a Panel → API. Ponle un nombre y toca Crear clave. Cópiala en ese momento: solo se muestra una vez.

2Guárdala en tu terminal o en tu .env

terminal
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
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 · POST
    /empresas

    La 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.

    Gasta 1 por empresa
  • GET · POST
    /empresas/contar

    Cuántas cumplen el pedido y cuántas tienen correo, teléfono, web, representante legal o ingresos, y en qué ciudades hay más.

    No gasta cuota
  • GET
    /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.

    Gasta 1
  • GET · POST
    /decisores

    Los 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.

    Gasta 1 por empresa
  • GET
    /filtros

    Las industrias, tipos de sociedad, rangos de empleados y órdenes que acepta el filtro.

    No gasta cuota
  • GET
    /uso

    Cuántas empresas llevas este mes y cuántas te quedan.

    No gasta cuota

Con un filtro

Las condiciones se combinan con Y. Las claves de industria salen de /filtros; los ingresos van en pesos colombianos.

POST /empresas
{
  "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.

200 · JSON
{
  "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-restante con las empresas que te quedan.
  • Lo que busques por la API queda en tu Actividad, igual que en la app.
400entrada_no_valida · pedido_vacioFalta el pedido o el filtro tiene un campo mal escrito. El mensaje dice cuál.
401sin_clave · clave_no_validaNo llegó la clave, o fue revocada.
404no_encontradaEsa empresa no está en Mango.
429demasiadas_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.