La API de Apollo.io permite que tu propio código busque personas, enriquezca registros y gestione tu flujo de trabajo de ventas. La llamas a través de HTTPS con una clave de API de Apollo.io. También puedes omitir la clave y permitir que un cliente de IA acceda a los mismos datos mediante el servidor MCP de Apollo.io. Ambas rutas consumen los créditos de tu plan y siguen sus límites.
Esta guía explica la API de Apollo.io desde el primer clic hasta la primera llamada. Muestra cómo crear una clave y dónde encontrarla. Cubre la documentación de la API de Apollo.io, la comprobación de estado, la búsqueda de personas, el enriquecimiento, los límites de velocidad y los costes en créditos. Termina con el servidor MCP oficial de Apollo.io y una rutina para comprobar las direcciones que devuelve la API. Todo proviene de la documentación oficial para desarrolladores en docs.apollo.io, consultada en octubre de 2026. Apollo.io marca varias páginas como actualizadas recientemente, así que confirma los detalles el día que desarrolles.
No estamos afiliados a Apollo.io. BillionVerify es un servicio de verificación de correo electrónico. Para obtener una visión más amplia de la plataforma, lee nuestra guía de Apollo.io.
Datos clave (comprobados en octubre de 2026):
- Cada nivel, incluido el gratuito, ofrece cierto acceso a la API. Las cuentas gratuitas necesitan un correo electrónico laboral para determinados endpoints.
- La API de Apollo.io envía la clave en el encabezado
x-api-key, y la URL base eshttps://api.apollo.io/api/v1. - Una clave de API de Apollo.io con permisos limitados solo accede a los endpoints que selecciones. Una clave maestra accede a todos.
- La mayoría de los endpoints aceptan 200 llamadas por minuto en un nivel de pago, frente a 50 en el nivel gratuito.
- El servidor MCP de Apollo.io se encuentra en
https://mcp.apollo.io/mcpe inicia sesión mediante OAuth.
Qué hace la API de Apollo.io
Apollo.io describe su API como una forma de buscar, enriquecer, crear y gestionar datos mediante programación. Detrás de ella hay una base de datos con más de 240 millones de contactos y 30 millones de empresas. La documentación divide el trabajo en tres tareas:
- Crear integraciones. Conecta tu producto con los datos de Apollo.io, crea cuentas y gestiona secuencias.
- Enriquecer datos. Completa registros de personas y empresas uno por uno o en bloque.
- Encontrar personas. Busca por cargo, ubicación, nivel de seniority y muchos otros filtros.
Tu plan determina qué endpoints puedes usar, con qué rapidez puedes llamarlos y cuánto cuesta cada llamada. Apollo.io también indica que sus herramientas no pueden hacer nada que no pudieras hacer en la aplicación. Si tu cuenta no tiene una función, la API no la desbloqueará.
¿Qué planes incluyen la API?
La sección de preguntas frecuentes para desarrolladores indica que todos los niveles tienen acceso básico. Las funciones más avanzadas solo están disponibles en determinados niveles. Nuestra guía de precios de Apollo.io enumera los niveles y sus fondos de créditos.
Hay una excepción para las cuentas gratuitas. Algunos endpoints de búsqueda de personas, enriquecimiento y registros requieren una cuenta registrada con una dirección de correo electrónico laboral. Cada página del endpoint afectado lo indica. Las cuentas de pago no se ven afectadas.
¿Para quién es la API de Apollo.io?
Tres grupos la utilizan principalmente:
- Equipos de ventas y RevOps que quieren enviar datos enriquecidos a un CRM o a un almacén de datos.
- Desarrolladores de empresas de software que integran datos de Apollo.io en su propio producto.
- Socios que crean integraciones para marketplaces. Inician sesión con OAuth 2.0 en lugar de una clave.
Apollo.io añade una nota sobre licencias. Compartir, exponer o revender sus datos a personas que no son usuarios de Apollo.io requiere un contrato personalizado.
Documentación de la API de Apollo.io: dónde está todo
La documentación de la API de Apollo.io se encuentra en docs.apollo.io. La barra superior la divide en Comenzar, API, MCP, CLI, OpenAPI y Registro de cambios. La sección API contiene una página para cada endpoint.

Captura de pantalla: la página People API Search en la documentación para desarrolladores de Apollo.io, tomada de la guía de Apollo.io para probar una clave.
Cada página de endpoint sigue el mismo patrón. Un cuadro de «Aspectos esenciales del endpoint» en la parte superior muestra la ruta de acceso principal, el ámbito de OAuth, quién puede usarlo y cuántos créditos cuesta. Debajo aparecen los parámetros. A la derecha encontrarás un selector de idioma, un campo de credenciales, una solicitud cURL y una respuesta de ejemplo.
Puedes probarlo en directo desde la página. Pega tu clave en el campo del encabezado, completa los parámetros obligatorios y pulsa «Probar». Un 200 significa que la llamada funcionó. Incluso sin una clave, puedes abrir cada respuesta de ejemplo para ver el esquema.
El archivo OpenAPI
Apollo.io publica toda la API como un único archivo OpenAPI 3 en https://docs.apollo.io/openapi/apollo-rest-api.json. Se reconstruye cada vez que cambia la documentación. Cárgalo en Postman u otro cliente de API y cada endpoint aparecerá con sus parámetros. También puedes pasarlo a un generador de código para crear un cliente tipado en tu propio lenguaje.
En Postman, conserva la clave en la autorización API Key preconfigurada y establece una variable apiKey. La documentación advierte que pegar la clave como token Bearer devuelve un 401. Los tokens Bearer son para socios de OAuth.
Un índice legible por máquinas
La documentación también publica un índice de texto plano en docs.apollo.io/llms.txt. Enumera cada página como un enlace Markdown. Las herramientas de programación con IA pueden leerlo para encontrar la página del endpoint adecuada sin rastrear el sitio.
Cómo obtener una clave API de Apollo.io
Una clave API de Apollo.io se crea dentro de la aplicación, no en el sitio de documentación. La ruta es Settings, luego Integrations y después API Keys. Solo los administradores pueden hacerlo, al igual que los usuarios cuyo perfil de permisos incluye las claves.
Así puedes obtener acceso a la clave API de Apollo.io paso a paso:
- Abre Apollo.io y haz clic en Settings > Integrations > API Keys. El panel de desarrolladores en developer.apollo.io muestra la misma página.
- Haz clic en Create new key.
- Introduce un nombre y una descripción.
- Marca cada endpoint que la clave pueda llamar o activa Set as master key.
- Haz clic en Create API key.
- Haz clic en Copy y pega la clave en un lugar seguro.

Captura de pantalla: el diálogo Create new API key en el portal de desarrolladores de Apollo.io, tomado de la documentación de Apollo.io.
Apollo.io muestra la clave completa al final. Cópiala en ese momento. Si la pierdes, vuelve a generarla desde el panel.
Dónde encontrar una clave API de Apollo.io existente
Si necesitas encontrar una clave API de Apollo.io que creaste anteriormente, vuelve al panel de desarrolladores y abre API keys. Cada clave que hayas creado aparece en esa lista. La barra lateral del portal también contiene las páginas Quick Start, Usage y Subscription. La misma barra lateral tiene una página OAuth Registration para partners.
Apollo.io te permite hacer dos cosas con una clave existente. Regenerate te proporciona un secreto nuevo y lo copia. Delete elimina la clave definitivamente. Trata ambas acciones como puertas de un solo sentido, porque todos los scripts que usaban la clave anterior dejan de funcionar.
¿Clave maestra o clave con alcance?
Esta elección importa más que cualquier otra al crear una clave API de Apollo.io.
| Tipo | A qué puede acceder | Para qué usarla |
|---|---|---|
| Clave con alcance (predeterminada) | Solo los endpoints que marcaste | La mayoría de las integraciones |
| Clave maestra | Todos los endpoints | Endpoints que la exigen y el servidor MCP mediante una clave |
Una clave con alcance que llama a un endpoint que no marcaste recibe un 403. Algunos endpoints, como la lista de usuarios del espacio de trabajo, solo funcionan con una clave maestra. Apollo.io te indica que trates una clave maestra como una contraseña. Puede realizar cualquier acción de API que tu cuenta permita.
¿Como qué usuario actúa una clave?
Una clave API de Apollo.io identifica tu espacio de trabajo, no a una persona. Apollo.io no puede saber qué compañero de equipo la utilizó. Cada solicitud actúa como el administrador activo con más antigüedad del espacio de trabajo, y ese usuario es propietario de todo lo que crea la llamada. Para saber quién es, llama al endpoint para obtener el perfil del usuario actual, que no consume créditos.
Esto sorprende a los equipos que crean una clave desde un inicio de sesión con permisos limitados. La clave no restringe lo que el código puede alcanzar.
Comprobación de estado de la API de Apollo.io
La forma más rápida de probar una clave nueva es hacer una única llamada de estado. Es una solicitud GET a auth/health y no consume créditos.
curl --request GET \ --url 'https://api.apollo.io/api/v1/auth/health' \ --header 'Content-Type: application/json' \ --header 'x-api-key: YOUR_API_KEY'
Si todo está configurado correctamente, la comprobación de estado de la API de Apollo.io devuelve dos valores:
{ "healthy": true, "is_logged_in": true }
Cuando ambos valores son true, la clave funciona. Si alguno es false, busca espacios adicionales o saltos de línea después de la clave y vuelve a enviar la solicitud. En Postman, establece el tipo de autorización en No Auth y añade la clave como encabezado.
¿Está caída la API de Apollo.io?
Las personas que buscan este término a veces quieren una respuesta diferente. Quieren saber si el propio servicio está caído. La llamada auth/health prueba tu clave y un inicio de sesión, no toda la plataforma. Para consultar interrupciones, Apollo.io mantiene una página de estado en status.apollo.io.
Una respuesta 429 con el código USAGE.RATE_LIMIT.PLATFORM_RATE_LIMIT significa que la plataforma está rechazando el tráfico debido a una carga elevada generalizada. No tiene nada que ver con tu plan. La documentación indica que debes esperar 60 segundos y volver a intentarlo.
Principales grupos de endpoints en la API de Apollo.io
La referencia enumera docenas de endpoints. Se dividen en seis grupos.
| Grupo | Qué incluye | Ejemplos |
|---|---|---|
| Buscar y enriquecer | Encontrar personas y empresas, completar registros | Búsqueda en People API, enriquecimiento de personas, búsqueda de organizaciones |
| Gestionar registros | Cuentas, contactos, negocios, listas, notas | Crear un contacto, actualizar cuentas en bloque, añadir registros a una lista |
| Interactuar con prospectos | Secuencias, correos electrónicos, llamadas, tareas, conversaciones | Añadir contactos a una secuencia, enviar un correo electrónico ahora |
| Asistente de IA | Asignar una tarea al asistente integrado | Ejecutar una tarea del asistente, consultar el estado de una tarea del asistente |
| Espacio de trabajo | Usuarios, buzones, campos personalizados | Obtener una lista de usuarios, crear un campo personalizado |
| Analítica y uso | Informes, estadísticas de uso, resultados de webhooks | Consultar un informe de analítica, ver estadísticas de uso |
La gestión de registros, las secuencias y la mayoría de las llamadas del espacio de trabajo utilizan 0 créditos. El coste se concentra en la búsqueda y el enriquecimiento, que explicamos a continuación.
Buscar no es enriquecer
Esta distinción confunde a los usuarios nuevos. Buscar en la base de datos de personas de Apollo.io devuelve perfiles. Los resultados no contienen correos electrónicos ni teléfonos. Necesitas una segunda llamada, a un endpoint de enriquecimiento, para obtenerlos. Buscar tus propios contactos guardados corresponde a otro conjunto de endpoints, y sus límites son diferentes.
Documentación de búsqueda de personas de la API de Apollo.io
La documentación de búsqueda de personas de la API de Apollo.io cubre un endpoint POST: /mixed_people/api_search. Apollo.io describe como personas a los prospectos nuevos que aún no has guardado como contactos.
curl --request POST \ --url 'https://api.apollo.io/api/v1/mixed_people/api_search?person_titles[]=sales%20director&person_locations[]=california&per_page=10' \ --header 'accept: application/json' \ --header 'x-api-key: YOUR_API_KEY'
Los parámetros se incluyen en la cadena de consulta. Puedes limitar la búsqueda por:
- Cargos:
person_titles[], además deperson_not_titles[]para excluir algunos. - Nivel de seniority:
person_seniorities[]. - Ubicación:
person_locations[]para saber dónde viven las personas,organization_locations[]para la sede central de la empresa. - Tamaño e ingresos de la empresa:
organization_num_employees_ranges[]yrevenue_range[min]. - Tecnología: filtros para más de 1.500 tecnologías que utiliza una empresa.
- Señales de contratación:
q_organization_job_titles[]y recuentos de ofertas de empleo. - Estado del correo electrónico:
contact_email_status[], con valores como verificado, no verificado, probable interacción y no disponible. - Paginación:
pageyper_page.
El endpoint de búsqueda de personas utiliza 0 créditos. Devuelve hasta 100 registros por página. También tiene un límite de visualización de 50.000 registros, es decir, 500 páginas. Añade filtros para mantenerte por debajo de ese límite.
Qué devuelve la búsqueda de personas de la API de Apollo.io
Una respuesta de búsqueda de personas contiene un recuento total_entries y una lista people. Omite las direcciones de correo electrónico y los teléfonos. Para obtener los datos de contacto, pasa cada resultado al endpoint de enriquecimiento.
La búsqueda tiene sus propios límites, indicados en la sección de límites de velocidad que aparece a continuación.
Si buscas por contact_email_status[], recuerda de dónde procede el valor. Describe el registro propio de Apollo.io sobre la dirección. No es una prueba activa del buzón.
Cómo leer más rápido la documentación de búsqueda de personas de la API de Apollo.io
Empieza por el cuadro de aspectos esenciales del endpoint. Comprueba las filas sobre el uso de créditos y el acceso de la cuenta gratuita. Después, revisa rápidamente la lista de parámetros para encontrar los filtros que necesitas. Por último, ejecuta una solicitud pequeña con per_page=10 antes de recorrer miles de resultados.
Enriquece personas con la API de Apollo.io
El enriquecimiento actualiza registros que ya tienes. Apollo.io ofrece dos endpoints para personas:
- Enriquecimiento de personas:
POST /people/match, una persona por llamada. - Enriquecimiento masivo de personas: hasta 10 personas en una sola solicitud.
Apollo.io necesita suficientes detalles para encontrar a la persona correcta. Una dirección de correo electrónico por sí sola funciona. También un nombre junto con el dominio de una empresa. El endpoint también acepta una URL de LinkedIn, el nombre de una organización o un ID de persona de Apollo.io. Si envías solo un nombre, puedes recibir una respuesta 200 que no haya enriquecido nada.
Comprueba match_confidence en cada respuesta. Puede ser high, medium, low o none.
curl --request POST \ --url 'https://api.apollo.io/api/v1/people/match?email=mark%40sumware.com' \ --header 'accept: application/json' \ --header 'x-api-key: YOUR_API_KEY'
La respuesta incluye el cargo de la persona, su historial laboral, los datos de la empresa y un email_status, como verified. Ese estado es una etiqueta propia de Apollo.io. Nuestra comprobación posterior en esta guía verifica la dirección en sí.
Teléfonos, direcciones personales y búsqueda en cascada
Tres opciones adicionales cambian los datos que recibes:
reveal_personal_emails=trueañade direcciones personales. Apollo.io no las revela para personas de regiones sujetas al GDPR.reveal_phone_number=trueañade todos los números de teléfono, incluidos los móviles. Requiere unwebhook_url. Apollo.io comprueba los números de forma asíncrona y los envía a tu webhook, lo que puede tardar varios minutos.run_waterfall_emailyrun_waterfall_phonebuscan primero en Apollo.io y después en tus proveedores externos de datos configurados. Los resultados finales también llegan mediante webhook.
Evita pagar dos veces
Si vuelves a enriquecer a la misma persona más adelante, es posible que gastes créditos otra vez por los mismos datos. Apollo.io sugiere convertir a las personas enriquecidas en contactos. Un contacto pertenece a tu organización, por lo que sus datos siguen estando disponibles.
Límites de solicitudes de la API de Apollo.io
Los límites de solicitudes se aplican por equipo, no por clave ni por usuario. También se aplican por endpoint y funcionan en tres ventanas a la vez: un minuto, una hora y un día. Debes mantenerte dentro de cada ventana aplicable.
| Límite | Gratis | Básico | Profesional | Organización |
|---|---|---|---|---|
| Solicitudes por minuto | 50 | 200 | 200 | 200 |
| Solicitudes por hora | 200 | 400 | 400 | 600 |
| Solicitudes por día | 600 | 2.000 | 2.000 | 6.000 |
Esa tabla es la configuración predeterminada. Los endpoints de búsqueda y enriquecimiento tienen límites más altos en los planes de pago:
- Endpoints de enriquecimiento: 1.000 solicitudes por minuto en los planes de pago, sin límite horario ni diario. Las cuentas gratuitas obtienen 50 por minuto y 20 en los endpoints masivos.
- Endpoints de búsqueda: 200 por minuto, 6.000 por hora y 50.000 por día en los planes de pago.
- Límites inferiores: el informe de análisis de consultas permite 5 solicitudes por hora.
La documentación de Apollo.io señala que el límite alto de enriquecimiento no es una autorización para enviar llamadas ilimitadas. Tu saldo de créditos sigue controlando cuánto puedes enriquecer.

Captura de pantalla: la página de uso del portal para desarrolladores de Apollo.io, con límites diarios y horarios para los endpoints de enriquecimiento, según la documentación de Apollo.io.
Encabezados de respuesta y el error 429
Apollo.io añade encabezados a las llamadas autenticadas. Muestran el límite, el uso acumulado y las solicitudes restantes para cada ventana:
x-rate-limit-minute,x-rate-limit-hourlyyx-rate-limit-24-hourx-minute-usage,x-hourly-usageyx-24-hour-usagex-minute-requests-left,x-hourly-requests-leftyx-24-hour-requests-leftretry-after, enviado con un429, indica los segundos hasta que se restablece la ventana
Cuando superas un límite, recibes un 429. Lee retry-after y espera. La ventana se abre con tu primera solicitud y no está vinculada al reloj. El cuerpo del error contiene un objeto error_details. Su code es USAGE.RATE_LIMIT.API_RATE_LIMIT_EXCEEDED para tu propio límite.
Para leer los límites actuales de tu equipo en el código, llama al endpoint para consultar las estadísticas de uso de la API. Una sola llamada puede cubrir hasta 74 rutas de endpoint y nada de ello consume créditos.
Créditos de API de Apollo.io: qué cuesta dinero
Muchas llamadas no cuestan nada. Apollo.io indica que los endpoints que crean, actualizan, enumeran o gestionan registros consumen 0 créditos. Los créditos se destinan a los endpoints de enriquecimiento, búsqueda de organizaciones, búsqueda de noticias y análisis de IA, y solo cuando devuelven datos que cumplen los requisitos.
| Endpoint | Coste en créditos |
|---|---|
| Enriquecimiento de personas | De 1 a 9 por persona: 1 por datos demográficos o correo electrónico, más 8 si se devuelve un teléfono móvil |
| Enriquecimiento masivo de personas | La misma lógica, hasta 10 personas por solicitud |
| Enriquecimiento de organizaciones | 1 por organización |
| Búsqueda de organizaciones | 1 por página, hasta 100 resultados por página |
| Búsqueda de artículos de noticias | 1 por página, hasta 25 resultados por página |
| Ofertas de empleo de organizaciones | 1 por página |
| Obtener información completa de una persona | 1 por persona |
| Tarea del asistente | Variable, según las acciones que realice el asistente |
La búsqueda de personas es gratuita, por lo que una estrategia razonable consiste en buscar primero y enriquecer solo las coincidencias más relevantes. Paginar un endpoint que consume créditos gasta créditos en cada página. Apollo.io recomienda realizar una pequeña prueba y revisar el uso antes de ampliar la escala.
El enriquecimiento en cascada puede costar más. La cascada de correo electrónico suele utilizar de 1 a 4 créditos, y algunas configuraciones usan 20 o más. La cascada de teléfonos suele utilizar de 8 a 25, y algunas usan 45 o más.
Para hacer un seguimiento del gasto, abre Configuración > Facturación y créditos > Uso de créditos en la aplicación. La pestaña Uso del panel del desarrollador muestra los créditos de teléfono y correo electrónico utilizados en el ciclo de facturación actual. Los planes antiguos pueden diferir, así que consulta la página Acerca de los créditos de tu espacio de trabajo.
Errores y códigos de estado
La mayoría de los endpoints de la API de Apollo.io comparten una lista breve de códigos de estado:
| Código | Significado | Causa común |
|---|---|---|
401 | No autorizado | Falta la clave, es inválida o pertenece a una cuenta inactiva |
403 | Prohibido | El plan no tiene acceso a la API o una clave con permisos específicos no tiene acceso al endpoint |
404 | No encontrado | El registro no existe o no es visible para ti |
422 | No procesable | Parámetro inválido o faltante |
429 | Demasiadas solicitudes | Superaste un límite de frecuencia |
500 | Error del servidor | Un fallo del lado de Apollo.io; vuelve a intentarlo |
Apollo.io está trasladando los errores a un formato único. Cuando un endpoint se ha migrado, la respuesta incluye un objeto error_details con un code estable, un message, suggestions y context. Basa las ramificaciones de tu código en error_details.code, nunca en el texto del mensaje. Apollo.io planea eliminar los campos de error antiguos del nivel raíz el 16 de febrero de 2027, así que empieza a usar el nuevo objeto desde ahora.
El servidor MCP de Apollo.io
MCP es un estándar que permite a las herramientas de IA llamar a servicios externos. El servidor MCP de Apollo.io conecta Claude, ChatGPT y clientes similares con tu cuenta de Apollo.io. Luego puedes pedir en lenguaje natural: encuentra líderes de marketing de nivel VP en empresas SaaS, o enriquece estos diez prospectos.

Captura de pantalla: la página MCP de Apollo.io en la documentación para desarrolladores, octubre de 2026.
Tres formas de conectarse
| Ruta | Cómo funciona |
|---|---|
| Conectores de IA | Integraciones integradas en ChatGPT, Claude, Perplexity, Replit y Cursor. No requiere configurar un servidor. |
| Plug-ins de programación | Plug-ins propios para herramientas como Codex. |
| Servidor MCP independiente | Apunta cualquier cliente MCP compatible con servidores remotos a una URL. |
La configuración independiente es breve:
| Configuración | Valor |
|---|---|
| Endpoint | https://mcp.apollo.io/mcp |
| Transporte | HTTP transmitible |
| Inicio de sesión | OAuth 2.0 |
| Instalación local | No es necesaria |
| API key | No es necesaria, salvo que el cliente no tenga navegador |
En Claude Code, un comando añade el servidor. Ejecútalo, luego escribe /mcp y completa el inicio de sesión mediante OAuth:
claude mcp add --transport http apollo https://mcp.apollo.io/mcp
Si administras varios espacios de trabajo, añade la misma URL con un nombre diferente para cada uno. Inicia sesión en cada conexión por separado.
Servidores sin navegador
OAuth necesita una ventana del navegador. Un trabajo cron o una canalización de CI no tienen ninguna. Para esos casos, el servidor acepta una API key enviada como X-Api-Key. La clave debe ser una clave maestra. Una clave con permisos limitados devuelve un 403 con el código API_INACCESSIBLE, porque el servidor MCP no es uno de los endpoints que puedes seleccionar.
Guarda esa clave como cualquier secreto de producción. Actúa como administrador del espacio de trabajo y consume sus créditos. Las nuevas herramientas MCP acceden de inmediato a una clave maestra, pero tu cliente puede conservar una lista de herramientas en caché. Vuelve a conectarte y llama a tools/list para actualizarla.
Qué puede hacer el servidor MCP de Apollo.io
La lista de herramientas abarca búsqueda y prospección, enriquecimiento de personas y empresas, contactos, listas, secuencias, correos electrónicos individuales, tareas, comprobaciones de dominios de correo electrónico y análisis. Las acciones de enriquecimiento consumen créditos. La mayoría de las demás acciones no consume ninguno. Apollo.io advierte que la búsqueda de personas no devuelve correos electrónicos ni teléfonos, por lo que tu asistente debe ejecutar un paso de enriquecimiento para obtenerlos.
Límites prácticos indicados en la documentación:
- No hay ningún cargo adicional por conectarse. Se aplican tu plan, tus permisos y tus créditos.
- No se admiten acciones destructivas, como la eliminación masiva.
- El servidor respeta tus permisos. Con OAuth actúa como el usuario que inició sesión.
- Apollo.io MCP utiliza límites de velocidad independientes y no devuelve los encabezados de límite de velocidad.
- Apollo.io prohíbe entrenar modelos de IA con sus datos MCP, así que desactiva el entrenamiento en tu cliente de IA primero.
Apollo.io recomienda configurar las acciones que consumen créditos como Requiere aprobación, para que un asistente demasiado conversador no consuma créditos por su cuenta.
Otras formas de usar la API de Apollo.io
- CLI de Apollo.io. Una herramienta de línea de comandos con acceso a toda la API. Instálala con Homebrew, un binario precompilado o desde el código fuente. Utiliza OAuth, por lo que no necesita ninguna clave.
- OAuth 2.0. Los socios la utilizan para llamar a la API para clientes mutuos, y la documentación incluye una aplicación del marketplace para integraciones terminadas.
- Extensión de Chrome. Para hacer clic en lugar de programar, lee nuestra guía de la extensión de Chrome de Apollo.
Comprueba direcciones de la API de Apollo.io antes de enviar
Elijas la ruta que elijas, los datos tienen un punto débil. Proceden de una base de datos. Las personas cambian de trabajo y las empresas se trasladan a nuevos dominios. El campo email_status es una etiqueta propia de Apollo.io, no una prueba reciente. Un correo electrónico en frío enviado a una dirección inactiva rebota, y los rebotes perjudican tu reputación del remitente.
Por eso, añade una comprobación entre el enriquecimiento y tu secuencia. BillionVerify prueba cada dirección sin enviar ningún mensaje. Comprueba la sintaxis, el dominio, los registros MX y, cuando lo solicitas, el buzón mediante SMTP. Marca las direcciones desechables y de rol. Informa los resultados catch-all por separado, en lugar de contarlos como válidos. Los resultados desconocidos no cuestan nada, y repetir una comprobación en un plazo de 24 horas es gratis. Antes de conectar la API, puedes comprobar manualmente si existe una dirección de correo electrónico en el verificador web gratuito.

BillionVerify devuelve un estado, un indicador de entregabilidad y un motivo para cada dirección.
Una pequeña canalización
Una canalización sencilla tiene cuatro pasos:
- Realiza una búsqueda gratuita de personas mediante la API.
- Enriquece solo las coincidencias más relevantes.
- Envía cada dirección a la API REST de BillionVerify.
- Añade solo las direcciones entregables a tu secuencia.
La llamada a BillionVerify es un POST. Envía la clave en el encabezado BV-API-KEY y establece check_smtp en true para realizar una prueba del buzón en tiempo real:
curl -X POST https://api.billionverify.com/v1/verify/single \
-H "BV-API-KEY: YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"email":"mark@sumware.com","check_smtp":true}'
La respuesta contiene status, is_deliverable, is_catchall, is_role, is_disposable y un reason. Para comprobar hasta 50 direcciones en una sola llamada, utiliza la ruta masiva. Para una exportación completa, sube un archivo CSV, TXT o XLSX y descarga los resultados más tarde. La referencia completa está en la documentación de BillionVerify.
Verifica desde el cliente de IA
Si ya conectas la configuración MCP de Apollo.io a un cliente de IA, añade a su lado el servidor MCP alojado de BillionVerify. Se encuentra en https://mcp.billionverify.com/mcp y utiliza OAuth para iniciar sesión. Tu asistente podrá enriquecer un prospecto mediante Apollo.io y comprobar la dirección en una sola conversación. Indícale tu política, por ejemplo, qué estados aceptar y qué hacer con las direcciones catch-all.
Otras comprobaciones
- Nuestra página de verificación de correo electrónico de Apollo explica el flujo de exportación.
- Un contacto sospechoso puede pasar por nuestra búsqueda inversa de correo electrónico gratuita, que muestra qué información pública está vinculada a una dirección.
- Los números de teléfono devueltos mediante el webhook también merecen una prueba. Nuestro validador de números de teléfono gratuito muestra si un número es válido para su país y qué tipo de línea es.
BillionVerify ofrece 20 créditos gratuitos cada día que utilizas tu cuenta, hasta 600 al mes. Nunca caducan y no necesitas tarjeta de crédito.
Consejos para crear integraciones con la API de Apollo.io
- Comienza con una clave específica por integración. Si una se filtra, solo revocas esa.
- Ejecuta primero la comprobación de estado. Descarta problemas con la clave antes de depurar el código.
- Lee el cuadro de aspectos esenciales del endpoint. La documentación de búsqueda de personas de la API de Apollo.io muestra el coste en créditos desde el principio.
- Busca antes de enriquecer. Buscar es gratis y el enriquecimiento no.
- Prueba con
per_page=10. Las ejecuciones pequeñas muestran los costes en créditos antes de que sean problemáticos. - Respeta
retry-after. Bombardear un endpoint limitado solo prolonga la espera. - Lee
error_details.code. El texto del mensaje puede cambiar sin previo aviso. - Verifica antes de enviar. Un crédito gastado en una dirección que rebota se desperdicia dos veces.
Preguntas frecuentes
¿Apollo.io tiene una API?
Sí, Apollo.io tiene una API REST. Te permite buscar personas y empresas, enriquecer contactos y actualizar cuentas, negocios y secuencias. El acceso básico viene con todos los niveles. Tu plan determina qué endpoints puedes utilizar, con qué rapidez y cuánto cuesta cada llamada.
¿Cómo obtengo una clave de API de Apollo.io?
Una clave de Apollo.io se obtiene desde el área Integraciones de Configuración: abre Claves de API y selecciona Crear una clave nueva. Asígnale un nombre, marca los endpoints que puede utilizar y confirma; después, copia el secreto inmediatamente. Puede hacerlo un administrador o un usuario con el perfil de permisos adecuado.
¿Dónde puedo encontrar mi clave de API de Apollo.io?
La lista de claves de API de Apollo.io se encuentra en la página Claves de API, a la que accedes desde la aplicación o desde el panel para desarrolladores. El secreto completo aparece cuando creas la clave. Si pierdes el secreto, tendrás que regenerar la clave, lo que emitirá una nueva.
¿La API de Apollo.io es gratuita?
Las llamadas a la API de Apollo.io que crean, enumeran o actualizan registros no tienen costo, y tampoco la búsqueda de personas. El enriquecimiento y algunos endpoints de búsqueda cobran créditos cuando devuelven datos. Las cuentas gratuitas pueden llamar a la API dentro de los límites del plan gratuito, pero algunos endpoints requieren un correo electrónico laboral.
¿Cuál es el límite de tasa de la API de Apollo.io?
En un nivel de pago, la mayoría de los endpoints de la API de Apollo.io aceptan 200 llamadas por minuto, con límites horarios y diarios que varían según el nivel. El nivel gratuito acepta 50 por minuto, 200 por hora y 600 por día. Los límites se aplican por equipo y por endpoint, y una respuesta 429 significa que superaste uno.
¿Cómo pruebo la comprobación de estado de la API de Apollo.io?
La comprobación de estado de Apollo.io es una solicitud GET a la ruta auth/health con el encabezado de clave configurado. Una respuesta de healthy: true y is_logged_in: true significa que la clave funciona. No se gastan créditos.
¿La búsqueda de personas de la API de Apollo.io devuelve correos electrónicos?
No, el endpoint de búsqueda de personas de Apollo.io devuelve únicamente perfiles, sin correos electrónicos ni teléfonos. Ejecuta el endpoint de enriquecimiento de personas o de enriquecimiento masivo de personas sobre los resultados para obtener datos de contacto, lo que cuesta créditos.
¿Dónde está la documentación de la API de Apollo.io?
La documentación de la API de Apollo.io está en docs.apollo.io. Cada endpoint tiene su propia página con parámetros, un panel de pruebas y una respuesta de ejemplo. También puedes descargar el archivo OpenAPI e importarlo en Postman.
¿Qué es el servidor MCP de Apollo.io?
El servidor MCP de Apollo.io conecta clientes de IA con tu espacio de trabajo mediante el Protocolo de Contexto del Modelo. Su URL es https://mcp.apollo.io/mcp, utiliza HTTP transmitible y OAuth, y no requiere instalación local. Tu plan, permisos y créditos siguen aplicándose.
¿Cuál es el mejor servidor MCP para Apollo.io?
Apollo.io publica un servidor MCP oficial, y ese es el que describen sus documentos. No probamos opciones de terceros. Elige el servidor oficial si quieres los mismos permisos y reglas de crédito que en la aplicación.
¿Debería verificar los correos electrónicos que provienen de la API de Apollo.io?
Sí, comprueba cada dirección de correo electrónico de la API de Apollo.io antes de una campaña. El campo email_status refleja los propios registros de Apollo.io, y las personas cambian de trabajo. Una revisión rápida mediante la API de BillionVerify elimina las direcciones inactivas y protege tu reputación del remitente.
Ver vídeo: Cómo validar un número de teléfono: validador de teléfonos gratis
