L'API Apollo.io permet à votre propre code de rechercher des personnes, d'enrichir des fiches et de gérer votre workflow commercial. Vous l'appelez via HTTPS avec une clé API Apollo.io. Vous pouvez aussi ignorer la clé et laisser un client IA accéder aux mêmes données via le serveur MCP d'Apollo.io. Les deux méthodes utilisent les crédits de votre forfait et respectent ses limites.
Ce guide présente l'API Apollo.io, du premier clic au premier appel. Il explique comment créer une clé et où la trouver. Il couvre la documentation de l'API Apollo.io, le contrôle d'état, la recherche de personnes, l'enrichissement, les limites de débit et le coût en crédits. Il se termine par le serveur MCP officiel d'Apollo.io et une routine pour vérifier les adresses renvoyées par l'API. Tout provient de la documentation officielle destinée aux développeurs sur docs.apollo.io, consultée en octobre 2026. Apollo.io indique que plusieurs pages ont été récemment mises à jour ; vérifiez donc les détails le jour où vous construisez votre intégration.
Nous ne sommes pas affiliés à Apollo.io. BillionVerify est un service de vérification d'email. Pour une vue d'ensemble plus large de la plateforme, consultez notre guide Apollo.io.
Points clés (vérifiés en octobre 2026) :
- Chaque niveau, y compris l'offre gratuite, donne accès à l'API. Les comptes gratuits ont besoin d'une adresse email professionnelle pour certains endpoints.
- L'API Apollo.io envoie la clé dans l'en-tête
x-api-key, et l'URL de base esthttps://api.apollo.io/api/v1. - Une clé API Apollo.io limitée par périmètre n'accède qu'aux endpoints que vous cochez. Une clé principale y accède tous.
- La plupart des endpoints acceptent 200 appels par minute sur un forfait payant, contre 50 sur l'offre gratuite.
- Le serveur MCP d'Apollo.io se trouve à l'adresse
https://mcp.apollo.io/mcpet utilise OAuth pour l'authentification.
Ce que fait l'API Apollo.io
Apollo.io décrit son API comme un moyen de rechercher, enrichir, créer et gérer des données par programmation. Elle s'appuie sur une base de données de plus de 240 millions de contacts et de 30 millions d'entreprises. La documentation répartit ces tâches en trois catégories :
- Créer des intégrations. Connecter votre produit aux données d'Apollo.io, créer des comptes et piloter des séquences.
- Enrichir les données. Compléter les fiches de personnes et d'entreprises une par une ou en masse.
- Trouver des personnes. Rechercher par intitulé de poste, localisation, niveau hiérarchique et de nombreux autres filtres.
Votre forfait détermine les endpoints que vous pouvez utiliser, la vitesse à laquelle vous pouvez les appeler et le coût de chaque appel. Apollo.io précise également que ses outils ne peuvent rien faire que vous ne puissiez déjà faire dans l'application. Si votre compte ne dispose pas d'une fonctionnalité, l'API ne la débloquera pas.
Quels forfaits incluent l'API ?
La FAQ destinée aux développeurs indique que chaque niveau offre un accès de base. Les fonctions plus avancées sont disponibles uniquement avec certains niveaux. Notre guide des tarifs d'Apollo.io répertorie les niveaux et leurs crédits disponibles.
Une restriction s'applique aux comptes gratuits. Certains endpoints de recherche de personnes, d'enrichissement et de fiches nécessitent un compte enregistré avec une adresse e-mail professionnelle. Chaque page d'endpoint concernée l'indique. Les comptes payants ne sont pas concernés.
À qui s'adresse l'API Apollo.io ?
Trois groupes l'utilisent principalement :
- Les équipes commerciales et RevOps qui souhaitent transférer des données enrichies vers un CRM ou un entrepôt de données.
- Les développeurs de sociétés de logiciels qui intègrent les données d'Apollo.io à leur propre produit.
- Les partenaires qui créent des intégrations pour des marketplaces. Ils se connectent avec OAuth 2.0 plutôt qu'avec une clé.
Apollo.io ajoute une note concernant les licences. Le partage, l'exposition ou la revente de ses données à des personnes qui ne sont pas des utilisateurs d'Apollo.io nécessite un contrat personnalisé.
Documentation de l’API Apollo.io : où tout se trouve
La documentation de l’API Apollo.io se trouve sur docs.apollo.io. La barre supérieure la divise en Get Started, API, MCP, CLI, OpenAPI et Changelog. La section API contient une page pour chaque endpoint.

Capture d’écran : la page People API Search dans la documentation développeur d’Apollo.io, tirée du guide d’Apollo.io consacré au test d’une clé.
Chaque page d’endpoint suit le même modèle. Une boîte « Éléments essentiels de l’endpoint » en haut répertorie le chemin d’accès, le scope OAuth, les utilisateurs autorisés et le nombre de crédits requis. Viennent ensuite les paramètres. À droite, vous trouverez un sélecteur de langage, un champ d’identifiants, une requête cURL et un exemple de réponse.
Vous pouvez effectuer un test en direct depuis la page. Collez votre clé dans le champ d’en-tête, renseignez les paramètres obligatoires et cliquez sur Try It. Un code 200 signifie que l’appel a fonctionné. Même sans clé, vous pouvez ouvrir chaque exemple de réponse pour voir le schéma.
Le fichier OpenAPI
Apollo.io publie l’intégralité de son API dans un fichier OpenAPI 3 à l’adresse https://docs.apollo.io/openapi/apollo-rest-api.json. Il est reconstruit chaque fois que la documentation est modifiée. Chargez-le dans Postman ou un autre client API, et chaque endpoint y sera importé avec ses paramètres. Vous pouvez également le fournir à un générateur de code pour créer un client typé dans votre propre langage.
Dans Postman, conservez la clé dans l’autorisation API Key préconfigurée et définissez une variable apiKey. La documentation avertit que coller la clé comme jeton Bearer renvoie une erreur 401. Les jetons Bearer sont destinés aux partenaires OAuth.
Un index lisible par machine
La documentation publie également un index en texte brut à l’adresse docs.apollo.io/llms.txt. Il répertorie chaque page sous forme de lien Markdown. Les outils de codage IA peuvent le lire pour trouver la page d’endpoint appropriée sans explorer tout le site.
Comment obtenir une clé API Apollo.io
Une clé API Apollo.io se crée dans l'application, et non sur le site de documentation. Le chemin est Settings, puis Integrations, puis API Keys. Seuls les administrateurs peuvent le faire, ainsi que les utilisateurs dont le profil d'autorisation couvre les clés.
Voici comment obtenir l'accès à une clé API Apollo.io, étape par étape :
- Ouvrez Apollo.io et cliquez sur Settings > Integrations > API Keys. Le tableau de bord développeur sur developer.apollo.io affiche la même page.
- Cliquez sur Create new key.
- Saisissez un nom et une description.
- Cochez chaque endpoint que la clé peut appeler, ou activez Set as master key.
- Cliquez sur Create API key.
- Cliquez sur Copy et collez la clé dans un endroit sûr.

Capture d'écran : la boîte de dialogue de création d'une nouvelle clé API dans le portail développeur Apollo.io, d'après la documentation d'Apollo.io.
Apollo.io affiche la clé complète à la fin. Copiez-la à ce moment-là. Si vous la perdez, générez-en une nouvelle depuis le tableau de bord.
Où trouver une clé API Apollo.io existante
Si vous devez retrouver une clé API Apollo.io que vous avez créée précédemment, retournez au tableau de bord développeur et ouvrez API keys. Chaque clé que vous avez créée se trouve dans cette liste. La barre latérale du portail contient également les pages Quick Start, Usage et Subscription. Cette même barre latérale propose une page OAuth Registration pour les partenaires.
Apollo.io vous permet de faire deux choses avec une clé existante. Regenerate génère un nouveau secret et le copie. Delete supprime définitivement la clé. Considérez ces deux actions comme irréversibles, car chaque script qui utilisait l'ancienne clé cesse de fonctionner.
Clé principale ou clé limitée ?
Ce choix est plus important que tout autre lorsque vous créez une clé API Apollo.io.
| Type | Ce à quoi elle donne accès | Utilisez-la pour |
|---|---|---|
| Clé limitée (par défaut) | Uniquement les endpoints que vous avez cochés | La plupart des intégrations |
| Clé principale | Tous les endpoints | Les endpoints qui l'exigent et le serveur MCP via une clé |
Une clé limitée qui appelle un endpoint que vous n'avez pas coché reçoit une erreur 403. Certains endpoints, comme la liste des utilisateurs de l'espace de travail, ne fonctionnent qu'avec une clé principale. Apollo.io vous recommande de traiter une clé principale comme un mot de passe. Elle peut effectuer toute action API autorisée par votre compte.
Quel utilisateur une clé représente-t-elle ?
Une clé API Apollo.io identifie votre espace de travail, et non une personne. Apollo.io ne peut pas savoir quel collègue l'a utilisée. Chaque requête agit au nom de l'administrateur actif le plus ancien de l'espace de travail, et cet utilisateur devient propriétaire de tout ce que l'appel crée. Pour savoir de qui il s'agit, appelez l'endpoint de profil de l'utilisateur actuel, qui ne consomme aucun crédit.
Cela surprend les équipes qui créent une clé depuis une connexion aux autorisations limitées. La clé ne restreint pas ce que le code peut atteindre.
Vérification de l’état de l’API Apollo.io
Le moyen le plus rapide de tester une nouvelle clé consiste à effectuer un seul appel de vérification. Il s’agit d’une requête GET vers auth/health, qui ne consomme aucun crédit.
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 tout est correctement configuré, la vérification de l’état de l’API Apollo.io renvoie deux valeurs :
{ "healthy": true, "is_logged_in": true }
Lorsque les deux valeurs sont true, la clé fonctionne. Si l’une d’elles est false, recherchez les espaces ou sauts de ligne superflus après la clé, puis envoyez à nouveau la requête. Dans Postman, définissez le type d’autorisation sur No Auth et ajoutez plutôt la clé comme en-tête.
L’API Apollo.io est-elle en panne ?
Les personnes qui recherchent ce terme souhaitent parfois obtenir une réponse différente. Elles veulent savoir si le service lui-même est en panne. L’appel auth/health teste votre clé et une connexion, mais pas l’ensemble de la plateforme. En cas de panne, Apollo.io gère une page d’état à l’adresse status.apollo.io.
Une réponse 429 avec le code USAGE.RATE_LIMIT.PLATFORM_RATE_LIMIT signifie que la plateforme rejette le trafic en raison d’une charge élevée généralisée. Cela n’a rien à voir avec votre forfait. La documentation recommande d’attendre 60 secondes, puis de réessayer.
Principaux groupes de points de terminaison dans l’API Apollo.io
La référence répertorie des dizaines de points de terminaison. Ils se répartissent en six groupes.
| Groupe | Ce que cela couvre | Exemples |
|---|---|---|
| Rechercher et enrichir | Trouver des personnes et des entreprises, compléter les fiches | Recherche dans la People API, enrichissement de personnes, recherche d’organisations |
| Gérer les fiches | Comptes, contacts, opportunités, listes, notes | Créer un contact, mettre à jour des comptes en masse, ajouter des fiches à une liste |
| Interagir avec les prospects | Séquences, emails, appels, tâches, conversations | Ajouter des contacts à une séquence, envoyer un email maintenant |
| Assistant IA | Confier une tâche à l’assistant intégré | Exécuter une tâche de l’assistant, interroger une tâche de l’assistant |
| Espace de travail | Utilisateurs, boîtes aux lettres, champs personnalisés | Obtenir une liste d’utilisateurs, créer un champ personnalisé |
| Analyses et utilisation | Rapports, statistiques d’utilisation, résultats de webhook | Interroger un rapport d’analyses, consulter les statistiques d’utilisation |
La gestion des fiches, les séquences et la plupart des appels liés à l’espace de travail utilisent 0 crédit. Le coût concerne la recherche et l’enrichissement, que nous expliquons ci-dessous.
La recherche n’est pas l’enrichissement
Cette distinction déroute les nouveaux utilisateurs. La recherche dans la base de données de personnes d’Apollo.io renvoie des profils. Les résultats ne contiennent ni emails ni numéros de téléphone. Vous devez effectuer un deuxième appel, vers un point de terminaison d’enrichissement, pour les obtenir. La recherche dans vos propres contacts enregistrés utilise un autre ensemble de points de terminaison, avec des limites différentes.
Documentation de recherche de personnes via l’API Apollo.io
La documentation de recherche de personnes via l’API Apollo.io couvre un endpoint POST : /mixed_people/api_search. Apollo.io décrit les personnes comme des prospects entièrement nouveaux que vous n’avez pas encore enregistrés comme contacts.
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'
Les paramètres sont placés dans la chaîne de requête. Vous pouvez affiner la recherche par :
- Intitulés de poste :
person_titles[], ainsi queperson_not_titles[]pour en exclure certains. - Niveau hiérarchique :
person_seniorities[]. - Localisation :
person_locations[]pour le lieu de résidence des personnes,organization_locations[]pour le siège de l’entreprise. - Taille et chiffre d’affaires de l’entreprise :
organization_num_employees_ranges[]etrevenue_range[min]. - Technologie : filtres sur plus de 1 500 technologies utilisées par une entreprise.
- Signaux de recrutement :
q_organization_job_titles[]et nombre d’offres d’emploi. - Statut de l’email :
contact_email_status[], avec des valeurs telles que vérifié, non vérifié, susceptible d’interagir et indisponible. - Pagination :
pageetper_page.
L’endpoint de recherche de personnes utilise 0 crédit. Il renvoie jusqu’à 100 enregistrements par page. Il comporte également une limite d’affichage de 50 000 enregistrements, soit 500 pages. Ajoutez des filtres pour rester en dessous de cette limite.
Ce que renvoie la recherche de personnes via l’API Apollo.io
Une réponse de recherche de personnes contient un compteur total_entries et une liste people. Elle exclut les emails et les numéros de téléphone. Pour obtenir les coordonnées, transmettez chaque résultat à l’endpoint d’enrichissement.
La recherche possède ses propres limites, indiquées dans la section consacrée aux limites de débit ci-dessous.
Si vous effectuez une recherche avec contact_email_status[], souvenez-vous de l’origine de la valeur. Elle décrit l’enregistrement de l’adresse par Apollo.io. Il ne s’agit pas d’un test en temps réel de boîte aux lettres.
Comment lire plus rapidement la documentation de recherche de personnes via l’API Apollo.io
Commencez par l’encadré des éléments essentiels de l’endpoint. Vérifiez les lignes relatives à l’utilisation des crédits et à l’accès au compte gratuit. Parcourez ensuite la liste des paramètres pour repérer les filtres dont vous avez besoin. Enfin, exécutez une petite requête avec per_page=10 avant de parcourir des milliers de résultats.
Enrichir des personnes avec l'API Apollo.io
L'enrichissement actualise les fiches que vous détenez déjà. Apollo.io propose deux endpoints pour les personnes :
- Enrichissement de personnes :
POST /people/match, une personne par appel. - Enrichissement groupé de personnes : jusqu'à 10 personnes dans une seule requête.
Apollo.io a besoin de suffisamment de détails pour identifier la bonne personne. Une adresse email seule suffit. Un nom associé au domaine d'une entreprise fonctionne également. L'endpoint accepte aussi une URL LinkedIn, le nom d'une organisation ou un identifiant de personne Apollo.io. Si vous envoyez uniquement un nom, vous pouvez obtenir une réponse 200 qui n'a rien enrichi.
Vérifiez match_confidence dans chaque réponse. Sa valeur peut être high, medium, low ou 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 réponse contient le poste de la personne, son historique professionnel, les données de l'entreprise et un email_status, tel que verified. Ce statut est le propre libellé d'Apollo.io. La vérification effectuée plus loin dans ce guide teste l'adresse elle-même.
Téléphones, adresses personnelles et waterfall
Trois options facultatives modifient les données renvoyées :
reveal_personal_emails=trueajoute les adresses personnelles. Apollo.io ne les révèle pas pour les personnes situées dans des régions soumises au RGPD.reveal_phone_number=trueajoute tous les numéros de téléphone, y compris les mobiles. Cette option nécessite unewebhook_url. Apollo.io vérifie les numéros de manière asynchrone et les envoie à votre webhook, ce qui peut prendre plusieurs minutes.run_waterfall_emailetrun_waterfall_phoneeffectuent d'abord une recherche dans Apollo.io, puis auprès de vos fournisseurs de données externes configurés. Les résultats finaux arrivent également par webhook.
Éviter de payer deux fois
Si vous enrichissez à nouveau la même personne plus tard, vous risquez de dépenser à nouveau des crédits pour les mêmes données. Apollo.io suggère de convertir les personnes enrichies en contacts. Un contact appartient à votre organisation, de sorte que ses données restent accessibles.
Limites de débit de l’API Apollo.io
Les limites de débit s’appliquent par équipe, et non par clé ou par utilisateur. Elles s’appliquent également par endpoint et fonctionnent simultanément sur trois fenêtres : une minute, une heure et une journée. Vous devez respecter chacune des fenêtres applicables.
| Limite | Gratuit | Basic | Professional | Organization |
|---|---|---|---|---|
| Requêtes par minute | 50 | 200 | 200 | 200 |
| Requêtes par heure | 200 | 400 | 400 | 600 |
| Requêtes par jour | 600 | 2 000 | 2 000 | 6 000 |
Ce tableau correspond aux valeurs par défaut. Les endpoints de recherche et d’enrichissement bénéficient de limites plus élevées avec les forfaits payants :
- Endpoints d’enrichissement : 1 000 requêtes par minute avec les forfaits payants, sans plafond horaire ni quotidien. Les comptes gratuits bénéficient de 50 requêtes par minute, et de 20 sur les endpoints groupés.
- Endpoints de recherche : 200 par minute, 6 000 par heure et 50 000 par jour avec les forfaits payants.
- Limites inférieures : le rapport d’analyse des requêtes autorise 5 requêtes par heure.
La documentation d’Apollo.io précise que la limite élevée d’enrichissement n’est pas une autorisation d’envoyer un nombre illimité d’appels. Le solde de vos crédits contrôle toujours la quantité de données que vous pouvez enrichir.

Capture d’écran : la page Usage du portail développeur Apollo.io, avec les limites quotidiennes et horaires des endpoints d’enrichissement, d’après la documentation d’Apollo.io.
En-têtes de réponse et erreur 429
Apollo.io ajoute des en-têtes aux appels authentifiés. Ils indiquent la limite, l’utilisation actuelle et le nombre de requêtes restantes pour chaque fenêtre :
x-rate-limit-minute,x-rate-limit-hourlyetx-rate-limit-24-hourx-minute-usage,x-hourly-usageetx-24-hour-usagex-minute-requests-left,x-hourly-requests-leftetx-24-hour-requests-leftretry-after, envoyé avec une erreur429, indique le nombre de secondes avant la réinitialisation de la fenêtre
Lorsque vous dépassez une limite, vous recevez une erreur 429. Lisez retry-after et patientez. La fenêtre s’ouvre lors de votre première requête et n’est pas liée à l’heure de l’horloge. Le corps de l’erreur contient un objet error_details. Son code est USAGE.RATE_LIMIT.API_RATE_LIMIT_EXCEEDED pour votre propre limite.
Pour lire les limites actuelles de votre équipe dans le code, appelez l’endpoint d’affichage des statistiques d’utilisation de l’API. Un seul appel peut couvrir jusqu’à 74 chemins d’endpoint, sans aucun coût en crédits.
Crédits API Apollo.io : ce qui coûte de l’argent
De nombreux appels ne coûtent rien. Apollo.io indique que les endpoints qui créent, mettent à jour, répertorient ou gèrent des enregistrements consomment 0 crédit. Les crédits sont utilisés pour l’enrichissement, la recherche d’organisations, la recherche d’actualités et les endpoints d’informations issues de l’IA, et uniquement lorsqu’ils renvoient des données admissibles.
| Endpoint | Coût en crédits |
|---|---|
| Enrichissement des personnes | 1 à 9 par personne : 1 pour les données démographiques ou l’email, plus 8 si un téléphone mobile est renvoyé |
| Enrichissement groupé des personnes | Même logique, jusqu’à 10 personnes par requête |
| Enrichissement des organisations | 1 par organisation |
| Recherche d’organisations | 1 par page, jusqu’à 100 résultats par page |
| Recherche d’articles d’actualité | 1 par page, jusqu’à 25 résultats par page |
| Offres d’emploi des organisations | 1 par page |
| Obtenir toutes les informations sur une personne | 1 par personne |
| Tâche de l’assistant | Variable, définie par les actions effectuées par l’assistant |
La recherche de personnes est gratuite : une configuration judicieuse consiste donc à rechercher d’abord, puis à enrichir uniquement les meilleurs résultats. Parcourir les pages d’un endpoint qui consomme des crédits utilise des crédits pour chaque page. Apollo.io recommande d’effectuer un petit test et de consulter votre utilisation avant de passer à l’échelle supérieure.
L’enrichissement en cascade peut coûter plus cher. La cascade d’emails utilise généralement 1 à 4 crédits, et certaines configurations en utilisent 20 ou plus. La cascade de téléphones utilise généralement 8 à 25 crédits, et certaines en utilisent 45 ou plus.
Pour suivre vos dépenses, ouvrez Settings > Billing and credits > Credit usage dans l’application. L’onglet Usage du tableau de bord des développeurs affiche les crédits de téléphone et d’email utilisés pendant le cycle de facturation actuel. Les anciens forfaits peuvent différer : consultez donc la page About credits de votre espace de travail.
Erreurs et codes d’état
La plupart des points de terminaison de l’API Apollo.io partagent une courte liste de codes d’état :
| Code | Signification | Cause courante |
|---|---|---|
401 | Non autorisé | Clé manquante, invalide ou provenant d’un compte inactif |
403 | Interdit | Le forfait n’autorise pas l’accès à l’API, ou une clé avec portée limitée n’autorise pas ce point de terminaison |
404 | Introuvable | L’enregistrement n’existe pas ou n’est pas visible pour vous |
422 | Non traitable | Paramètre invalide ou manquant |
429 | Trop de requêtes | Vous avez dépassé une limite de débit |
500 | Erreur du serveur | Un problème du côté d’Apollo.io, réessayez donc |
Apollo.io uniformise progressivement le format des erreurs. Lorsqu’un point de terminaison a été migré, la réponse inclut un objet error_details contenant un code stable, un message, des suggestions et un context. Basez les embranchements de votre code sur error_details.code, jamais sur le texte du message. Apollo.io prévoit de supprimer les anciens champs d’erreur au niveau racine le 16 février 2027 ; utilisez donc dès maintenant le nouvel objet.
Le serveur MCP d’Apollo.io
MCP est une norme qui permet aux outils d’IA d’appeler des services externes. Le serveur MCP d’Apollo.io relie Claude, ChatGPT et des clients similaires à votre compte Apollo.io. Vous pouvez ensuite demander en langage courant : trouver des responsables marketing de niveau VP dans des entreprises SaaS, ou enrichir ces dix prospects.

Capture d’écran : la page MCP d’Apollo.io dans la documentation destinée aux développeurs, octobre 2026.
Trois façons de se connecter
| Méthode | Fonctionnement |
|---|---|
| Connecteurs d’IA | Intégrations intégrées à ChatGPT, Claude, Perplexity, Replit et Cursor. Aucune configuration de serveur. |
| Plug-ins de codage | Plug-ins propriétaires pour des outils tels que Codex. |
| Serveur MCP autonome | Dirigez n’importe quel client MCP prenant en charge les serveurs distants vers une seule URL. |
Les paramètres autonomes sont courts :
| Paramètre | Valeur |
|---|---|
| Point de terminaison | https://mcp.apollo.io/mcp |
| Transport | HTTP diffusé en continu |
| Connexion | OAuth 2.0 |
| Installation locale | Non nécessaire |
| Clé API | Non nécessaire, sauf si le client ne possède pas de navigateur |
Dans Claude Code, une commande ajoute le serveur. Exécutez-la, puis saisissez /mcp et terminez la connexion OAuth :
claude mcp add --transport http apollo https://mcp.apollo.io/mcp
Si vous gérez plusieurs espaces de travail, ajoutez la même URL sous un nom différent pour chacun. Connectez-vous séparément à chaque connexion.
Serveurs sans navigateur
OAuth nécessite une fenêtre de navigateur. Une tâche cron ou un pipeline CI n’en possède pas. Pour ces cas, le serveur accepte une clé API envoyée dans X-Api-Key. La clé doit être une clé principale. Une clé limitée renvoie une erreur 403 avec le code API_INACCESSIBLE, car le serveur MCP ne fait pas partie des points de terminaison que vous pouvez sélectionner.
Conservez cette clé comme n’importe quel secret de production. Elle agit comme l’administrateur de l’espace de travail et dépense ses crédits. Les nouveaux outils MCP accèdent immédiatement à une clé principale, mais votre client peut conserver une liste d’outils mise en cache. Reconnectez-vous et appelez tools/list pour l’actualiser.
Ce que le serveur MCP d’Apollo.io peut faire
La liste d’outils couvre la recherche et la prospection, l’enrichissement des personnes et des entreprises, les contacts, les listes, les séquences, les emails ponctuels, les tâches, les vérifications de domaines d’email et les analyses. Les actions d’enrichissement utilisent des crédits. La plupart des autres actions n’en utilisent aucun. Apollo.io avertit que la recherche de personnes ne renvoie ni emails ni numéros de téléphone ; votre assistant doit donc exécuter une étape d’enrichissement pour les obtenir.
Limites pratiques indiquées dans la documentation :
- La connexion n’entraîne aucuns frais supplémentaires. Votre forfait, vos autorisations et vos crédits s’appliquent.
- Les actions destructrices, telles que la suppression en masse, ne sont pas prises en charge.
- Le serveur respecte vos autorisations. Avec OAuth, il agit en tant qu’utilisateur connecté.
- Apollo.io MCP utilise des limites de débit distinctes et ne renvoie pas les en-têtes de limite de débit.
- Apollo.io interdit l’entraînement des modèles d’IA sur ses données MCP ; désactivez donc d’abord l’entraînement dans votre client d’IA.
Apollo.io recommande de définir les actions qui consomment des crédits sur « Approbation requise », afin qu’un assistant bavard ne puisse pas épuiser les crédits de son propre chef.
Autres façons d'utiliser l'API Apollo.io
- CLI Apollo.io. Un outil en ligne de commande offrant un accès à l'API complète. Installez-le avec Homebrew, un binaire précompilé ou depuis les sources. Il utilise OAuth, et n'a donc pas besoin de clé.
- OAuth 2.0. Les partenaires l'utilisent pour appeler l'API au nom de clients communs, et la documentation répertorie une application de marketplace pour les intégrations finalisées.
- Extension Chrome. Pour cliquer plutôt que coder, consultez notre guide de l'extension Chrome Apollo.
Vérifiez les adresses via l'API Apollo.io avant d'envoyer
Quelle que soit la méthode choisie, les données ont un point faible. Elles proviennent d'une base de données. Les gens changent de poste et les entreprises passent à de nouveaux domaines. Le champ email_status est le propre libellé d'Apollo.io, pas un test récent. Un email à froid envoyé à une adresse inactive rebondit, et les rebonds nuisent à votre réputation d'expéditeur.
Ajoutez donc une vérification entre l'enrichissement et votre séquence. BillionVerify teste chaque adresse sans envoyer de message. Il vérifie la syntaxe, le domaine, les enregistrements MX et, si vous le demandez, la boîte aux lettres via SMTP. Il signale les adresses jetables et les adresses de rôle. Il indique les résultats catch-all séparément au lieu de les compter comme valides. Les résultats inconnus ne coûtent rien, et une nouvelle vérification dans les 24 heures est gratuite. Avant de connecter l'API, vous pouvez vérifier manuellement si une adresse email existe grâce au vérificateur web gratuit.

BillionVerify renvoie un statut, un indicateur de délivrabilité et un motif pour chaque adresse.
Un petit pipeline
Un pipeline simple comporte quatre étapes :
- Effectuez une recherche gratuite de personnes via l'API.
- Enrichissez uniquement les meilleures correspondances.
- Envoyez chaque adresse à l'API REST de BillionVerify.
- Ajoutez uniquement les adresses livrables à votre séquence.
L'appel à BillionVerify est un seul POST. Envoyez la clé dans l'en-tête BV-API-KEY et définissez check_smtp sur true pour effectuer un test en direct de la boîte aux lettres :
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 réponse contient status, is_deliverable, is_catchall, is_role, is_disposable et un reason. Pour vérifier jusqu'à 50 adresses en un seul appel, utilisez l'endpoint groupé. Pour un export complet, importez un fichier CSV, TXT ou XLSX et téléchargez les résultats plus tard. La référence complète se trouve dans la documentation BillionVerify.
Vérifier depuis le client IA
Si vous connectez déjà la configuration MCP d'Apollo.io à un client IA, ajoutez le serveur MCP hébergé de BillionVerify à ses côtés. Il se trouve à https://mcp.billionverify.com/mcp et utilise OAuth pour la connexion. Votre assistant peut alors enrichir un prospect via Apollo.io et vérifier l'adresse au cours d'une seule conversation. Indiquez-lui votre politique, notamment les statuts à accepter et la marche à suivre pour les résultats catch-all.
Autres vérifications
- Notre page vérification d'email Apollo couvre le processus d'exportation.
- Un contact suspect peut passer par notre recherche inversée d'email gratuite, qui indique ce qui est publiquement associé à une adresse.
- Les numéros de téléphone renvoyés par le webhook méritent également un test. Notre validateur gratuit de numéros de téléphone indique si un numéro est valide pour son pays et quel est son type de ligne.
BillionVerify vous offre 20 crédits gratuits chaque jour où vous utilisez votre compte, jusqu'à 600 par mois. Ils n'expirent jamais et aucune carte bancaire n'est requise.
Conseils pour développer avec l’API Apollo.io
- Commencez par une clé limitée par intégration. Si l’une d’elles fuite, vous ne révoquez que celle-ci.
- Exécutez d’abord le contrôle de santé. Il écarte les problèmes de clé avant que vous ne déboguiez le code.
- Lisez l’encadré des éléments essentiels de l’endpoint. La documentation de recherche de personnes de l’API Apollo.io indique le coût en crédits dès le départ.
- Recherchez avant d’enrichir. La recherche est gratuite, contrairement à l’enrichissement.
- Testez avec
per_page=10. Les petites exécutions affichent les coûts en crédits avant qu’ils ne deviennent problématiques. - Respectez
retry-after. Marteler un endpoint limité ne fait que prolonger l’attente. - Lisez
error_details.code. Le texte du message peut changer sans préavis. - Vérifiez avant d’envoyer. Dépenser un crédit pour une adresse qui rebondit est deux fois du gaspillage.
FAQ
Apollo.io dispose-t-il d'une API ?
Oui, Apollo.io dispose d'une API REST. Elle vous permet de rechercher des personnes et des entreprises, d'enrichir des contacts et de mettre à jour des comptes, des opportunités et des séquences. L'accès de base est inclus dans chaque offre. Votre forfait détermine les points de terminaison que vous pouvez appeler, la vitesse d'appel et le coût de chaque appel.
Comment obtenir une clé API Apollo.io ?
Une clé Apollo.io s'obtient depuis la section Intégrations des Paramètres : ouvrez Clés API et choisissez Créer une nouvelle clé. Donnez-lui un nom, cochez les points de terminaison qu'elle peut appeler, puis confirmez et copiez immédiatement le secret. Un administrateur ou un utilisateur disposant du profil d'autorisation approprié peut effectuer cette opération.
Où trouver ma clé API Apollo.io ?
La liste de vos clés API Apollo.io se trouve sur la page Clés API, accessible depuis l'application ou le tableau de bord développeur. Le secret complet s'affiche lors de la création de la clé. Si vous perdez le secret, vous devez régénérer la clé, ce qui en crée une nouvelle.
L'API Apollo.io est-elle gratuite ?
Les appels de l'API Apollo.io qui créent, répertorient ou mettent à jour des enregistrements sont gratuits, tout comme la recherche de personnes. L'enrichissement et certains points de terminaison de recherche utilisent des crédits lorsqu'ils renvoient des données. Les comptes gratuits peuvent appeler l'API dans les limites de l'offre gratuite, mais certains points de terminaison nécessitent une adresse email professionnelle.
Quelle est la limite de débit de l'API Apollo.io ?
Avec une offre payante, la plupart des points de terminaison de l'API Apollo.io acceptent 200 appels par minute, avec des plafonds horaires et quotidiens qui varient selon l'offre. L'offre gratuite accepte 50 appels par minute, 200 par heure et 600 par jour. Les limites s'appliquent par équipe et par point de terminaison, et une réponse 429 signifie que vous avez dépassé l'une d'elles.
Comment tester le contrôle d'état de l'API Apollo.io ?
Le contrôle d'état d'Apollo.io est une requête GET vers le chemin auth/health, avec l'en-tête de clé configuré. Une réponse contenant healthy: true et is_logged_in: true signifie que la clé fonctionne. Aucun crédit n'est dépensé.
La recherche de personnes de l'API Apollo.io renvoie-t-elle des emails ?
Non, le point de terminaison de recherche de personnes d'Apollo.io renvoie uniquement des profils, sans emails ni numéros de téléphone. Exécutez le point de terminaison d'enrichissement de personnes ou d'enrichissement groupé de personnes sur les résultats pour obtenir les coordonnées, ce qui coûte des crédits.
Où trouver la documentation de l'API Apollo.io ?
La documentation de l'API Apollo.io se trouve à l'adresse docs.apollo.io. Chaque point de terminaison possède sa propre page avec ses paramètres, un panneau de test et un exemple de réponse. Vous pouvez également télécharger le fichier OpenAPI et l'importer dans Postman.
Qu'est-ce que le serveur MCP d'Apollo.io ?
Le serveur MCP d'Apollo.io relie les clients d'IA à votre espace de travail via le protocole Model Context. Son URL est https://mcp.apollo.io/mcp, il utilise Streamable HTTP et OAuth, et ne nécessite aucune installation locale. Votre forfait, vos autorisations et vos crédits continuent de s'appliquer.
Quel est le meilleur serveur MCP pour Apollo.io ?
Apollo.io publie un serveur MCP officiel, celui décrit dans sa documentation. Nous n'avons pas testé les options tierces. Choisissez le serveur officiel si vous souhaitez bénéficier des mêmes autorisations et règles de crédit que dans l'application.
Dois-je vérifier les emails provenant de l'API Apollo.io ?
Oui, vérifiez chaque adresse email provenant de l'API Apollo.io avant une campagne. Le champ email_status reflète les propres données d'Apollo.io, et les personnes changent d'emploi. Une vérification rapide via l'API BillionVerify supprime les adresses invalides et protège votre réputation d'expéditeur.
Regarder la vidéo : Comment valider un numéro de téléphone : validateur gratuit
Regarder la vidéo : Comment vérifier les e-mails Apollo avant l'envoi
