Apollo
Person and company enrichment, people search, company job postings and news. Requires Felo administrative permission.
Recherche People API
Trouvez des personnes correspondant à des critères plutôt que d'enrichir une personne déjà identifiée. Filtrez par intitulé de poste, ancienneté, localisation, domaine de l'entreprise, effectif et secteur, et paginez avec page et per_page. Renvoie total_entries et un tableau people. Notez ce que la recherche omet délibérément : les entrées portent last_name_obfuscated et des indicateurs booléens — has_email, has_direct_phone, has_city, has_state, has_country — au lieu des valeurs elles-mêmes. La recherche indique qu'une correspondance existe ; l'enrichissement révèle les coordonnées. Passez les ids à post_apollo_people_match ou post_apollo_people_bulk_match pour obtenir les e-mails et les numéros de téléphone, ce qui est aussi là que les crédits sont consommés. Nécessite une autorisation administrative Felo.
Pricing reference
- Comptage : base de coût fixe par requête réussie.
- Estimation de référence par requête : USD 0.012.
Métadonnées de référence uniquement : ni devis de compte, ni prix garanti, ni plafond de dépenses. Les crédits de ressources ne sont pas des crédits Felo. Les débits définitifs suivent les enregistrements de facturation Felo.
- Type: array string[]contact
_email _status[] Les statuts d'e-mail des personnes que vous souhaitez trouver. Vous pouvez ajouter plusieurs statuts pour élargir votre recherche. Les statuts disponibles pour la recherche sont : verified unverified likely to engage unavailable
- Type: array string[]currently
_not _using _any _of _technology _uids[] Excluez des personnes de votre recherche selon l'une des technologies utilisées par leur employeur actuel. Apollo permet de filtrer par plus de 1 500 technologies. Apollo calcule les données de technologies à partir de plusieurs sources. Ces données sont mises à jour régulièrement. Consultez la liste complète des technologies prises en charge en téléchargeant ce fichier CSV . Utilisez des traits de soulignement (_) à la place des espaces et des points pour les technologies répertoriées dans le fichier CSV. Exemples : salesforce; google_analytics; wordpress_org
- Type: array string[]currently
_using _all _of _technology _uids[] Trouvez des personnes selon toutes les technologies utilisées par leur employeur actuel. Apollo permet de filtrer par plus de 1 500 technologies. Apollo calcule les données de technologies à partir de plusieurs sources. Ces données sont mises à jour régulièrement. Consultez la liste complète des technologies prises en charge en téléchargeant ce fichier CSV . Utilisez des traits de soulignement (_) à la place des espaces et des points pour les technologies répertoriées dans le fichier CSV. Exemples : salesforce; google_analytics; wordpress_org
- Type: array string[]currently
_using _any _of _technology _uids[] Trouvez des personnes selon l'une des technologies utilisées par leur employeur actuel. Apollo permet de filtrer par plus de 1 500 technologies. Apollo calcule les données de technologies à partir de plusieurs sources. Ces données sont mises à jour régulièrement. Consultez la liste complète des technologies prises en charge en téléchargeant ce fichier CSV . Utilisez des traits de soulignement (_) à la place des espaces et des points pour les technologies répertoriées dans le fichier CSV. Exemples : salesforce; google_analytics; wordpress_org
- Type: booleaninclude
_similar _titles Ce paramètre détermine si les personnes dont l'intitulé de poste est similaire à ceux que vous définissez dans le paramètre person_titles[] sont renvoyées dans la réponse. Définissez ce paramètre sur false lorsque vous utilisez person_titles[] pour ne renvoyer que les correspondances strictes d'intitulés de poste.
- Type: array string[]organization
_ids[] Les ID Apollo des entreprises (employeurs) que vous souhaitez inclure dans vos résultats de recherche. Chaque entreprise de la base de données Apollo se voit attribuer un ID unique. Pour trouver des ID, appelez le point de terminaison Organization Search et identifiez les valeurs de organization_id. Exemple : 5e66b6381e05b4008c8331b8
- Type: array string[]organization
_job _locations[] Les lieux des emplois que l'employeur de la personne recrute activement. Exemples : atlanta; japan
- Type: stringorganization
_job _posted _at _range[max] La date la plus récente à laquelle des offres d'emploi ont été publiées par l'employeur actuel de la personne. Utilisez ce paramètre avec organization_job_posted_at_range[min] pour définir une plage de dates de publication des offres. Exemple : 2025-09-25
- Type: stringorganization
_job _posted _at _range[min] La date la plus ancienne à laquelle des offres d'emploi ont été publiées par l'employeur actuel de la personne. Utilisez ce paramètre avec organization_job_posted_at_range[max] pour définir une plage de dates de publication des offres. Exemple : 2025-07-25
- Type: array string[]organization
_locations[] L'emplacement du siège social de l'employeur actuel d'une personne. Vous pouvez rechercher par villes, États américains et pays. Si une entreprise possède plusieurs bureaux, les résultats restent basés sur l'emplacement du siège. Par exemple, si vous recherchez chicago mais que le siège d'une entreprise se trouve à boston, les personnes qui travaillent dans cette entreprise n'apparaîtront pas dans vos résultats, même si elles correspondent à d'autres paramètres. Pour trouver des personnes selon leur lieu personnel, utilisez le paramètre person_locations. Exemples : texas; tokyo; spain
- Type: array string[]organization
_num _employees _ranges[] La plage du nombre d'employés travaillant dans l'entreprise actuelle de la personne. Cela vous permet de trouver des personnes selon l'effectif de leur employeur. Vous pouvez ajouter plusieurs plages pour élargir les résultats de recherche. Chaque plage ajoutée doit être une chaîne, avec les nombres supérieur et inférieur de la plage séparés uniquement par une virgule. Exemples : 1,10; 250,500; 10000,20000
- Type: integerorganization
_num _jobs _range[max] Le nombre maximal d'offres d'emploi actives chez l'employeur actuel de la personne. Utilisez ce paramètre avec organization_num_jobs_range[min] pour définir une plage d'offres d'emploi. Exemples : 50; 500
- Type: integerorganization
_num _jobs _range[min] Le nombre minimal d'offres d'emploi actives chez l'employeur actuel de la personne. Utilisez ce paramètre avec organization_num_jobs_range[max] pour définir une plage d'offres d'emploi. Exemples : 50; 500
- Type: integerpage
Le numéro de page des données Apollo que vous souhaitez récupérer. Utilisez ce paramètre avec le paramètre per_page pour rendre les résultats de recherche navigables et améliorer les performances du point de terminaison. Exemple : 4
- Type: integerper
_page Le nombre de résultats de recherche à renvoyer par page. Limiter le nombre de résultats par page améliore les performances du point de terminaison. Utilisez le paramètre page pour parcourir les différentes pages de données. Exemple : 10
- Type: array string[]person
_locations[] Le lieu où vivent les personnes. Vous pouvez rechercher par villes, États américains et pays. Pour trouver des personnes selon l'emplacement du siège de leur employeur actuel, utilisez le paramètre organization_locations. Exemples : california; ireland; chicago
- Type: array string[]person
_seniorities[] Le niveau hiérarchique du poste occupé par la personne chez son employeur actuel. Cela vous permet de trouver des personnes qui occupent actuellement des postes à certains niveaux de rattachement, comme le niveau directeur ou le niveau IC senior. Pour qu'une personne figure dans les résultats, elle doit correspondre à 1 seul des niveaux hiérarchiques que vous ajoutez. Ajouter davantage de niveaux hiérarchiques élargit les résultats de recherche. Les recherches ne renvoient des résultats que selon le poste actuel, donc une recherche d'employés de niveau directeur ne renvoie que les personnes qui occupent actuellement un titre de niveau directeur. Si une personne a été directrice par le passé mais est actuellement VP, elle ne figurera pas dans vos résultats. Utilisez ce paramètre avec le paramètre person_titles[] pour trouver des personnes selon des fonctions et des niveaux hiérarchiques précis. Les options suivantes peuvent être utilisées pour ce paramètre : owner founder c_suite partner vp head director manager senior entry intern
- Type: array string[]person
_titles[] Les intitulés de poste des personnes que vous souhaitez trouver. Pour qu'une personne figure dans les résultats, elle doit correspondre à 1 seul des intitulés de poste que vous ajoutez. Ajouter davantage d'intitulés de poste élargit les résultats. Les résultats incluent aussi les intitulés de poste comportant les mêmes termes, même s'il ne s'agit pas de correspondances exactes. Par exemple, une recherche sur marketing manager peut renvoyer des personnes dont l'intitulé est content marketing manager. Utilisez ce paramètre avec le paramètre person_seniorities[] pour trouver des personnes selon des fonctions et des niveaux hiérarchiques précis. Exemples : sales development representative; marketing manager; research analyst
- Type: stringq
_keywords Une chaîne de mots sur laquelle filtrer les résultats.
- Type: array string[]q
_organization _domains _list[] Le nom de domaine de l'employeur de la personne. Il peut s'agir de l'employeur actuel ou d'un employeur précédent. N'incluez pas www., le symbole @ ni d'éléments similaires. Ce paramètre accepte jusqu'à 1 000 domaines par requête. Exemples : apollo.io; microsoft.com
- Type: array string[]q
_organization _job _titles[] Les intitulés de poste figurant dans les offres d'emploi actives chez l'employeur actuel de la personne. Exemples : sales manager; research analyst
- Type: integerrevenue
_range[max] Le chiffre d'affaires maximal généré par l'employeur actuel de la personne. Utilisez ce paramètre avec revenue_range[min] pour définir une plage de chiffre d'affaires. N'indiquez ni symboles monétaires, ni virgules, ni points décimaux dans le montant. Exemples : 500000; 1500000
- Type: integerrevenue
_range[min] Le chiffre d'affaires minimal généré par l'employeur actuel de la personne. Utilisez ce paramètre avec revenue_range[max] pour définir une plage de chiffre d'affaires. N'indiquez ni symboles monétaires, ni virgules, ni points décimaux dans le montant. Exemples : 500000; 1500000
- Type: object200
Réponse réussie
- Type: array string[]people
Tableau de réponse
- Type: integertotal
_entries Champ de réponse
application/json - 400
La requête n'a pas pu être traitée. Vérifiez les paramètres de la requête.
- 401
Une clé API Felo valide est requise.
- 402
La requête ne peut pas aboutir car une condition de facturation n'est pas remplie.
- 403
Le compte n'est pas autorisé à effectuer cette opération.
- 429
Une limite de requêtes ou de dépenses a été atteinte.
- 502
Le service n'a pas pu terminer la requête.
- 503
L'API ou le service de facturation est temporairement indisponible.
- 504
Le service a expiré lors du traitement de la requête.
- default
Réponse d'erreur ; les réponses transmises depuis l'upstream peuvent utiliser les formats du fournisseur
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"
]
}