{"nombre":"API de Mango","descripcion":"Empresas de Colombia y México con datos de contacto, tamaño e ingresos, de registros públicos oficiales (RUES, SECOP II, Supersociedades, DENUE).","documentacion":"https://mangoa-ai.com/desarrolladores","base":"https://mangoa-ai.com/api/v1","autenticacion":{"encabezado":"Authorization: Bearer mango_sk_...","alternativa":"x-api-key: mango_sk_...","crear_clave":"https://mangoa-ai.com/panel/api"},"limites":{"llamadas_por_minuto":60,"empresas_por_mes":5000,"que_gasta":"Cada empresa devuelta por /empresas, por una ficha o por /decisores (la primera página) cuenta 1. /empresas/contar, /filtros, /uso y las páginas siguientes de /decisores no gastan.","encabezado_restante":"x-cuota-restante"},"rutas":[{"metodo":"GET | POST","ruta":"/empresas","que_hace":"Lista de empresas, 25 por página, primero las de datos de contacto más completos.","entrada":{"q_o_pedido":"string. El pedido en palabras: 'constructoras en Medellín con correo'. En GET va como ?q=","filtro":"objeto (opcional, en vez del pedido). Ver /filtros y el ejemplo abajo. En GET va como ?filtro=<JSON>","desde":"entero, 0 a 5000. Cuántas saltar, de 25 en 25"},"salida":"{ total, desde, siguiente (null si no hay más), entendido, filtro_aplicado, empresas: [{ pais, id_fiscal, razon_social, nombre_comercial, ciudad, region, actividad, correo, telefono, web, representante_legal, directivos, tamano, ingresos, ingresos_texto, proveedor_estado }], ver_en_mango }"},{"metodo":"GET | POST","ruta":"/empresas/contar","que_hace":"Cuántas empresas cumplen y cuántas tienen correo, teléfono, web, representante legal, ingresos reportados o le venden al Estado, y las ciudades con más.","entrada":{"q_o_pedido":"string","filtro":"objeto (opcional)"},"salida":"{ total, correo, telefono, web, estado, representante, financieros, ciudades, entendido, filtro_aplicado, ver_en_mango }"},{"metodo":"GET","ruta":"/empresas/{pais}/{id_fiscal}","que_hace":"Todos los datos de una empresa: todos los correos, dirección, representante legal, actividad, constitución, estados financieros (ingresos, utilidad, activos y año), tamaño legal y fuentes.","entrada":{"pais":"CO o MX","id_fiscal":"NIT sin dígito de verificación, o RFC"}},{"metodo":"GET | POST","ruta":"/decisores","que_hace":"Decisores de una empresa (dueños, C-level, VP, directores, gerentes y jefes): nombre, cargo, nivel, área, perfil de LinkedIn o enlace para buscarlo, y correo de trabajo deducido (sin verificar). 60 por llamada.","entrada":{"pais":"CO o MX","id_fiscal":"NIT sin dígito de verificación (Colombia)","dominio":"dominio del sitio web (México, o si no hay NIT)","areas":"opcional: direccion_general, ventas, compras, marketing, recursos_humanos, finanzas, tecnologia, operaciones, legal, producto, servicio_cliente","niveles":"opcional: dueno_fundador, c_level, vp, director, jefe","desde":"entero; usa 'siguiente' de la respuesta anterior"},"salida":"{ empresa, total, desde, siguiente, decisores: [{ nombre, cargo, nivel, areas, coincide_con_lo_pedido, linkedin, buscar_en_linkedin, apellido_oculto, correo, correo_estado, fuente }], notas }"},{"metodo":"GET","ruta":"/filtros","que_hace":"Industrias (clave y nombre), tipos de sociedad, rangos de empleados, órdenes y cobertura."},{"metodo":"GET","ruta":"/uso","que_hace":"Empresas usadas y restantes este mes."}],"ejemplo_filtro":{"filtro":{"empresa":{"pais":["CO"],"ciudad":["Medellín"],"industria":["construccion"],"ingresos_min":1000000000},"contacto":{"correo":true},"orden":"ingresos"},"desde":0},"errores":{"formato":"{ \"error\": { \"codigo\": \"...\", \"mensaje\": \"...\" } }","codigos":{"400":"entrada_no_valida, pedido_vacio, pais_no_valido, id_no_valido","401":"sin_clave, clave_no_valida","404":"no_encontrada","429":"demasiadas_llamadas (esperar 60 s), cuota_agotada (se renueva el día 1)"}},"notas":["Las cifras son de la base publicada; nada se inventa. Los ingresos están en pesos colombianos y solo existen para quienes reportan a Supersociedades.","Mango no entrega números de documento de personas.","Uso permitido: contacto comercial entre empresas, dando la opción de no recibir más mensajes. Ver https://mangoa-ai.com/privacidad#base-legal"]}