Apollo
Person and company enrichment, people search, company job postings and news. Requires Felo administrative permission.
Búsqueda en People API
Encuentra personas que cumplen criterios en lugar de enriquecer a alguien que ya identificaste. Filtra por cargo, antigüedad, ubicación, dominio de la empresa, número de empleados y sector, y pagina con page y per_page. Devuelve total_entries y un array people. Fíjate en lo que la búsqueda omite deliberadamente: las entradas incluyen last_name_obfuscated y flags booleanos — has_email, has_direct_phone, has_city, has_state, has_country — en lugar de los valores en sí. La búsqueda indica que existe una coincidencia; el enriquecimiento revela los datos de contacto. Pasa los ids a post_apollo_people_match o post_apollo_people_bulk_match para obtener correos y teléfonos, que es también donde se gastan los créditos. Requiere permiso de administración de Felo.
Pricing reference
- Medición: base de costo fija por solicitud exitosa.
- Estimación de referencia por solicitud: USD 0.012.
Solo metadatos de referencia; no son una cotización de la cuenta, un precio garantizado ni un límite de gasto. Los créditos de recursos no son créditos de Felo. Los cargos finales se rigen por los registros de facturación de Felo.
- Tipo: array string[]contact
_email _status[] Los estados de correo electrónico de las personas que quieres encontrar. Puedes añadir varios estados para ampliar la búsqueda. Los estados que puedes buscar son: verified unverified likely to engage unavailable
- Tipo: array string[]currently
_not _using _any _of _technology _uids[] Excluye personas de tu búsqueda en función de cualquiera de las tecnologías que utilice su empleador actual. Apollo permite filtrar por más de 1500 tecnologías. Apollo calcula los datos de tecnologías a partir de varias fuentes. Estos datos se actualizan con regularidad. Consulta la lista completa de tecnologías compatibles descargando este archivo CSV . Usa guiones bajos (_) para sustituir espacios y puntos en las tecnologías que figuran en el archivo CSV. Ejemplos: salesforce; google_analytics; wordpress_org
- Tipo: array string[]currently
_using _all _of _technology _uids[] Encuentra personas en función de todas las tecnologías que utilice su empleador actual. Apollo permite filtrar por más de 1500 tecnologías. Apollo calcula los datos de tecnologías a partir de varias fuentes. Estos datos se actualizan con regularidad. Consulta la lista completa de tecnologías compatibles descargando este archivo CSV . Usa guiones bajos (_) para sustituir espacios y puntos en las tecnologías que figuran en el archivo CSV. Ejemplos: salesforce; google_analytics; wordpress_org
- Tipo: array string[]currently
_using _any _of _technology _uids[] Encuentra personas en función de cualquiera de las tecnologías que utilice su empleador actual. Apollo permite filtrar por más de 1500 tecnologías. Apollo calcula los datos de tecnologías a partir de varias fuentes. Estos datos se actualizan con regularidad. Consulta la lista completa de tecnologías compatibles descargando este archivo CSV . Usa guiones bajos (_) para sustituir espacios y puntos en las tecnologías que figuran en el archivo CSV. Ejemplos: salesforce; google_analytics; wordpress_org
- Tipo: booleaninclude
_similar _titles Este parámetro determina si se devuelven en la respuesta personas con puestos similares a los que defines en el parámetro person_titles[]. Establece este parámetro en false al usar person_titles[] para devolver solo coincidencias estrictas de puestos.
- Tipo: array string[]organization
_ids[] Los IDs de Apollo de las empresas (empleadores) que quieres incluir en los resultados de búsqueda. A cada empresa de la base de datos de Apollo se le asigna un ID único. Para encontrar IDs, llama al endpoint Organization Search e identifica los valores de organization_id. Ejemplo: 5e66b6381e05b4008c8331b8
- Tipo: array string[]organization
_job _locations[] Las ubicaciones de los empleos que el empleador de la persona está reclutando activamente. Ejemplos: atlanta; japan
- Tipo: stringorganization
_job _posted _at _range[max] La fecha más reciente en que el empleador actual de la persona publicó ofertas de empleo. Usa este parámetro junto con organization_job_posted_at_range[min] para definir un intervalo de fechas de publicación de ofertas. Ejemplo: 2025-09-25
- Tipo: stringorganization
_job _posted _at _range[min] La fecha más antigua en que el empleador actual de la persona publicó ofertas de empleo. Usa este parámetro junto con organization_job_posted_at_range[max] para definir un intervalo de fechas de publicación de ofertas. Ejemplo: 2025-07-25
- Tipo: array string[]organization
_locations[] La ubicación de la sede de la empresa del empleador actual de una persona. Puedes buscar por ciudades, estados de EE. UU. y países. Si una empresa tiene varias oficinas, los resultados se siguen basando en la ubicación de la sede. Por ejemplo, si buscas chicago pero la sede de una empresa está en boston, las personas que trabajan en esa empresa no aparecerán en tus resultados, aunque coincidan con otros parámetros. Para encontrar personas según su ubicación personal, usa el parámetro person_locations. Ejemplos: texas; tokyo; spain
- Tipo: array string[]organization
_num _employees _ranges[] El intervalo de número de empleados que trabajan en la empresa actual de la persona. Esto te permite encontrar personas según el número de empleados de su empleador. Puedes añadir varios intervalos para ampliar los resultados de la búsqueda. Cada intervalo que añadas debe ser una cadena, con los números superior e inferior del intervalo separados solo por una coma. Ejemplos: 1,10; 250,500; 10000,20000
- Tipo: integerorganization
_num _jobs _range[max] El número máximo de ofertas de empleo activas en el empleador actual de la persona. Usa este parámetro junto con organization_num_jobs_range[min] para definir un intervalo de ofertas de empleo. Ejemplos: 50; 500
- Tipo: integerorganization
_num _jobs _range[min] El número mínimo de ofertas de empleo activas en el empleador actual de la persona. Usa este parámetro junto con organization_num_jobs_range[max] para definir un intervalo de ofertas de empleo. Ejemplos: 50; 500
- Tipo: integerpage
El número de página de los datos de Apollo que quieres recuperar. Usa este parámetro junto con el parámetro per_page para que los resultados de búsqueda sean navegables y mejorar el rendimiento del endpoint. Ejemplo: 4
- Tipo: integerper
_page El número de resultados de búsqueda que deben devolverse por página. Limitar el número de resultados por página mejora el rendimiento del endpoint. Usa el parámetro page para buscar en las distintas páginas de datos. Ejemplo: 10
- Tipo: array string[]person
_locations[] El lugar donde viven las personas. Puedes buscar por ciudades, estados de EE. UU. y países. Para encontrar personas según la ubicación de la sede de su empleador actual, usa el parámetro organization_locations. Ejemplos: california; ireland; chicago
- Tipo: array string[]person
_seniorities[] El nivel de antigüedad del puesto que ocupa la persona en su empleador actual. Esto te permite encontrar personas que actualmente ocupan posiciones en determinados niveles de reporte, como nivel de director o nivel de IC sénior. Para que una persona se incluya en los resultados de búsqueda, solo debe coincidir con 1 de los niveles de antigüedad que añadas. Añadir más niveles de antigüedad amplía los resultados de búsqueda. Las búsquedas solo devuelven resultados según su puesto actual, por lo que buscar empleados de nivel de director solo devuelve personas que actualmente tienen un título de nivel de director. Si alguien fue director en el pasado pero actualmente es VP, no se incluiría en los resultados. Usa este parámetro junto con el parámetro person_titles[] para encontrar personas según funciones y niveles de antigüedad concretos. Se pueden usar las siguientes opciones para este parámetro: owner founder c_suite partner vp head director manager senior entry intern
- Tipo: array string[]person
_titles[] Los puestos que ocupan las personas que quieres encontrar. Para que una persona se incluya en los resultados, solo debe coincidir con 1 de los puestos que añadas. Añadir más puestos amplía los resultados. Los resultados también incluyen puestos con los mismos términos, aunque no sean coincidencias exactas. Por ejemplo, buscar marketing manager puede devolver personas con el puesto content marketing manager. Usa este parámetro junto con el parámetro person_seniorities[] para encontrar personas según funciones y niveles de antigüedad concretos. Ejemplos: sales development representative; marketing manager; research analyst
- Tipo: stringq
_keywords Una cadena de palabras por la que queremos filtrar los resultados.
- Tipo: array string[]q
_organization _domains _list[] El nombre de dominio del empleador de la persona. Puede ser el empleador actual o uno anterior. No incluyas www., el símbolo @ ni similares. Este parámetro acepta hasta 1000 dominios en una sola solicitud. Ejemplos: apollo.io; microsoft.com
- Tipo: array string[]q
_organization _job _titles[] Los puestos que figuran en las ofertas de empleo activas del empleador actual de la persona. Ejemplos: sales manager; research analyst
- Tipo: integerrevenue
_range[max] Los ingresos máximos que genera el empleador actual de la persona. Usa este parámetro junto con revenue_range[min] para definir un intervalo de ingresos. No introduzcas símbolos de moneda, comas ni puntos decimales en la cifra. Ejemplos: 500000; 1500000
- Tipo: integerrevenue
_range[min] Los ingresos mínimos que genera el empleador actual de la persona. Usa este parámetro junto con revenue_range[max] para definir un intervalo de ingresos. No introduzcas símbolos de moneda, comas ni puntos decimales en la cifra. Ejemplos: 500000; 1500000
- Tipo: object200
Respuesta correcta
- Tipo: array string[]people
Array de respuesta
- Tipo: integertotal
_entries Campo de respuesta
application/json - 400
No se pudo procesar la solicitud. Comprueba los parámetros de la solicitud.
- 401
Se requiere una clave de API de Felo válida.
- 402
La solicitud no puede continuar porque no se cumple un requisito de facturación.
- 403
La cuenta no tiene permiso para realizar esta operación.
- 429
Se ha alcanzado un límite de solicitudes o de gasto.
- 502
El servicio no pudo completar la solicitud.
- 503
La API o el servicio de facturación no están disponibles temporalmente.
- 504
El servicio agotó el tiempo de espera al procesar la solicitud.
- default
Respuesta de error; las respuestas de paso del upstream pueden usar formatos del proveedor
application/json
curl https://openapi.felo.ai/v1/beta/apollo/mixed_people/api_search \
--request POST \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN'
{
"total_entries": 1,
"people": [
"string"
]
}