Naar de hoofdinhoud
Black Friday: 20% korting op elk abonnement tot 1 dec.Bekijk de deal

Apollo.io API: sleutel, endpoints, limieten en MCP Server

Leo
LeoFounder, BillionVerify

Apollo.io API-gids: maak een API-sleutel, voer de health check uit, gebruik people search en enrichment, ken rate limits en credits, en koppel de MCP-server.

Apollo.io API-dashboard met sleutels, endpoints, rate limits, MCP Server en e-mailverificatie

Met de Apollo.io API kan je eigen code mensen zoeken, records verrijken en je verkoopworkflow beheren. Je roept deze aan via HTTPS met een Apollo.io API-sleutel. Je kunt de sleutel ook overslaan en een AI-client via de Apollo.io MCP-server toegang geven tot dezelfde gegevens. Beide routes gebruiken de credits van je abonnement en volgen de limieten daarvan.

Deze handleiding behandelt de Apollo.io API vanaf de eerste klik tot de eerste aanroep. Je leert hoe je een sleutel aanmaakt en waar je die vindt. Ook behandelen we de Apollo.io API-documentatie, de gezondheidscontrole, het zoeken naar mensen, verrijking, snelheidslimieten en creditkosten. Tot slot bespreken we de officiële MCP-server voor Apollo.io en een routine om de adressen te controleren die de API retourneert. Alles is afkomstig uit de officiële ontwikkelaarsdocumentatie op docs.apollo.io, geraadpleegd in oktober 2026. Apollo.io markeert verschillende pagina’s als recent bijgewerkt, dus controleer de details op de dag waarop je gaat bouwen.

Wij zijn niet gelieerd aan Apollo.io. BillionVerify is een service voor e-mailverificatie. Lees onze Apollo.io-gids voor een breder overzicht van het platform.

Belangrijke feiten (gecontroleerd in oktober 2026):

  • Elke abonnementslaag, inclusief gratis, biedt enige toegang tot de API. Voor bepaalde endpoints hebben gratis accounts een werk-e-mailadres nodig.
  • De Apollo.io API verstuurt de sleutel in de x-api-key-header en de basis-URL is https://api.apollo.io/api/v1.
  • Een Apollo.io API-sleutel met beperkte scope heeft alleen toegang tot de endpoints die je aanvinkt. Een hoofdsleutel heeft toegang tot alle endpoints.
  • De meeste endpoints accepteren 200 aanroepen per minuut op een betaald abonnement, tegenover 50 op het gratis abonnement.
  • De Apollo.io MCP-server staat op https://mcp.apollo.io/mcp en gebruikt OAuth voor aanmelding.

Wat de Apollo.io API doet

Apollo.io beschrijft zijn API als een manier om programmatisch gegevens te zoeken, verrijken, aan te maken en te beheren. Daarachter bevindt zich een database met meer dan 240 miljoen contactpersonen en 30 miljoen bedrijven. De documentatie verdeelt het werk in drie taken:

  • Integraties bouwen. Verbind je product met Apollo.io-gegevens, maak accounts aan en stuur sequenties aan.
  • Gegevens verrijken. Vul personen- en bedrijfsgegevens één voor één of in bulk aan.
  • Personen vinden. Zoek op functietitel, locatie, senioriteit en vele andere filters.

Je abonnement bepaalt welke endpoints je kunt gebruiken, hoe snel je ze kunt aanroepen en wat elke aanroep kost. Apollo.io zegt ook dat zijn tools niets kunnen doen wat je niet in de app zou kunnen doen. Als je account een functie niet heeft, ontgrendelt de API die niet.

Welke abonnementen bevatten de API?

De FAQ voor ontwikkelaars zegt dat elke abonnementslaag basistoegang heeft. Geavanceerdere functies zijn alleen beschikbaar in bepaalde lagen. Onze Apollo.io-prijsgids vermeldt de lagen en hun kredietpools.

Voor gratis accounts geldt één uitzondering. Voor sommige endpoints voor het zoeken naar personen, verrijking en gegevensrecords is een account nodig dat met een zakelijk e-mailadres is geregistreerd. Elke betreffende endpointpagina vermeldt dit. Betaalde accounts worden niet getroffen.

Voor wie is de Apollo.io API bedoeld?

Drie groepen gebruiken deze API het meest:

  1. Sales- en RevOps-teams die verrijkte gegevens naar een CRM of datawarehouse willen sturen.
  2. Ontwikkelaars bij softwarebedrijven die Apollo.io-gegevens in hun eigen product integreren.
  3. Partners die marketplace-integraties bouwen. Zij melden zich aan met OAuth 2.0 in plaats van een sleutel.

Apollo.io voegt een licentie-opmerking toe. Het delen, openbaar maken of doorverkopen van zijn gegevens aan mensen die geen Apollo.io-gebruikers zijn, vereist een aangepast contract.

Apollo.io API-documentatie: waar alles staat

De API-documentatie van Apollo.io staat op docs.apollo.io. De bovenste balk is verdeeld in Get Started, API, MCP, CLI, OpenAPI en Changelog. De API-sectie bevat één pagina voor elk endpoint.

Apollo.io API-documentatiepagina voor People API Search met het referentiescherm en voorbeeldantwoord

Schermafbeelding: de People API Search-pagina in de ontwikkelaarsdocumentatie van Apollo.io, uit Apollo.io's handleiding voor het testen van een sleutel.

Elke endpointpagina volgt hetzelfde patroon. Een vak met "Endpoint essentials" bovenaan vermeldt het belangrijkste toegangspad, de OAuth-scope, wie het kan gebruiken en hoeveel credits het kost. Daaronder staan de parameters. Rechts vind je een taalkiezer, een veld voor referenties, een cURL-verzoek en een voorbeeldantwoord.

Je kunt rechtstreeks vanaf de pagina live testen. Plak je sleutel in het header-veld, vul de vereiste parameters in en druk op Probeer het. Een 200 betekent dat de aanroep is gelukt. Zelfs zonder sleutel kun je elk voorbeeldantwoord openen om het schema te bekijken.

Het OpenAPI-bestand

Apollo.io publiceert de volledige API als één OpenAPI 3-bestand op https://docs.apollo.io/openapi/apollo-rest-api.json. Het wordt opnieuw opgebouwd wanneer de documentatie verandert. Laad het in Postman of een andere API-client en elk endpoint verschijnt met zijn parameters. Je kunt het ook aan een codegenerator doorgeven om een getypeerde client in je eigen taal te bouwen.

Gebruik in Postman de sleutel in de vooraf geconfigureerde API Key-autorisatie en stel een variabele apiKey in. De documentatie waarschuwt dat het plakken van de sleutel als Bearer-token een 401 oplevert. Bearer-tokens zijn bedoeld voor OAuth-partners.

Een machineleesbare index

De documentatie publiceert ook een index in platte tekst op docs.apollo.io/llms.txt. Deze vermeldt elke pagina als Markdown-link. AI-codeertools kunnen die lezen om de juiste endpointpagina te vinden zonder de site te crawlen.

Een Apollo.io API-sleutel verkrijgen

Een Apollo.io API-sleutel wordt in de app aangemaakt, niet op de documentatiesite. Het pad is Settings, vervolgens Integrations en daarna API Keys. Alleen beheerders kunnen dit doen, evenals gebruikers van wie het machtigingsprofiel toegang tot sleutels omvat.

Zo krijgt u stap voor stap toegang tot een Apollo.io API-sleutel:

  1. Open Apollo.io en klik op Settings > Integrations > API Keys. Het ontwikkelaarsdashboard op developer.apollo.io toont dezelfde pagina.
  2. Klik op Create new key.
  3. Voer een naam en beschrijving in.
  4. Vink elk endpoint aan dat de sleutel mag aanroepen, of schakel Set as master key in.
  5. Klik op Create API key.
  6. Klik op Copy en plak de sleutel op een veilige plek.

Apollo.io-dialoogvenster voor het aanmaken van een nieuwe API-sleutel met naam, beschrijving, API-selectie en de schakelaar voor de master key

Screenshot: het dialoogvenster voor het aanmaken van een nieuwe API-sleutel in het Apollo.io-ontwikkelaarsportaal, uit de documentatie van Apollo.io.

Apollo.io toont de volledige sleutel aan het einde. Kopieer deze dan. Als u de sleutel kwijtraakt, genereert u deze opnieuw vanuit het dashboard.

Waar u een bestaande Apollo.io API-sleutel vindt

Als u een Apollo.io API-sleutel wilt vinden die u eerder hebt aangemaakt, gaat u terug naar het ontwikkelaarsdashboard en opent u API keys. Elke sleutel die u hebt aangemaakt staat in die lijst. De zijbalk van het portaal bevat ook de pagina’s Quick Start, Usage en Subscription. In dezelfde zijbalk staat een OAuth Registration-pagina voor partners.

Met een bestaande sleutel kunt u in Apollo.io twee dingen doen. Regenerate geeft u een nieuw geheim en kopieert dit. Delete verwijdert de sleutel definitief. Beschouw beide als eenrichtingsdeuren, omdat elk script dat de oude sleutel gebruikte, niet meer werkt.

Master key of key met beperkte scope?

Deze keuze is belangrijker dan alle andere wanneer u een Apollo.io API-sleutel aanmaakt.

TypeWaar het toegang toe geeftWaarvoor u het gebruikt
Key met beperkte scope (standaard)Alleen de endpoints die u hebt aangevinktDe meeste integraties
Master keyElk endpointEndpoints die dit vereisen en de MCP-server via een key

Een key met beperkte scope die een endpoint aanroept dat u niet hebt aangevinkt, krijgt een 403. Sommige endpoints, zoals de gebruikerslijst van de workspace, werken alleen met een master key. Apollo.io adviseert u een master key als een wachtwoord te behandelen. Deze kan elke API-actie uitvoeren die uw account toestaat.

Als welke gebruiker handelt een key?

Een Apollo.io API-sleutel identificeert uw workspace, niet een persoon. Apollo.io kan niet zien welke teamgenoot de sleutel heeft gebruikt. Elk verzoek handelt namens de langst actieve beheerder van de workspace, en die gebruiker is eigenaar van alles wat de aanroep aanmaakt. Als u wilt zien wie dat is, roept u het endpoint voor het profiel van de huidige gebruiker aan; dit kost geen credits.

Dit verrast teams die een sleutel aanmaken vanuit een login met beperkte machtigingen. De sleutel beperkt niet waartoe de code toegang heeft.

Apollo.io API-gezondheidscontrole

De snelste manier om een nieuwe sleutel te testen, is één gezondheidsaanroep. Dit is één GET-verzoek naar auth/health, waarbij geen credits worden gebruikt.

curl --request GET \
  --url 'https://api.apollo.io/api/v1/auth/health' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY'

Als alles correct is ingesteld, retourneert de Apollo.io API-gezondheidscontrole twee waarden:

{ "healthy": true, "is_logged_in": true }

Wanneer beide waarden true zijn, werkt de sleutel. Als een van beide false is, controleer dan op overtollige spaties of regeleinden na de sleutel en verstuur het verzoek opnieuw. Stel in Postman het type Autorisatie in op No Auth en voeg de sleutel in plaats daarvan als header toe.

Is de Apollo.io API offline?

Mensen die op deze term zoeken, willen soms een ander antwoord. Ze willen weten of de service zelf offline is. De aanroep auth/health test je sleutel en een aanmelding, niet het hele platform. Voor storingen heeft Apollo.io een statuspagina op status.apollo.io.

Een 429-antwoord met de code USAGE.RATE_LIMIT.PLATFORM_RATE_LIMIT betekent dat het platform verkeer weigert vanwege hoge belasting over de hele linie. Dit heeft niets met je abonnement te maken. In de documentatie staat dat je 60 seconden moet wachten en het opnieuw moet proberen.

Belangrijkste endpointgroepen in de Apollo.io API

De referentie vermeldt tientallen endpoints. Ze vallen uiteen in zes groepen.

GroepWat deze omvatVoorbeelden
Zoeken en verrijkenMensen en bedrijven vinden, gegevens aanvullenZoeken via de People API, personen verrijken, zoeken naar organisaties
Records beherenAccounts, contacten, deals, lijsten, notitiesEen contact aanmaken, accounts in bulk bijwerken, records aan een lijst toevoegen
In gesprek gaan met prospectsSequences, e-mails, gesprekken, taken, conversatiesContacten aan een sequence toevoegen, nu een e-mail versturen
AI-assistentEen taak aan de ingebouwde assistent gevenEen assistenttaak uitvoeren, de status van een assistenttaak opvragen
WorkspaceGebruikers, mailboxen, aangepaste veldenEen lijst met gebruikers ophalen, een aangepast veld aanmaken
Analytics en gebruikRapporten, gebruiksstatistieken, webhookresultatenEen analyticsrapport opvragen, gebruiksstatistieken bekijken

Recordbeheer, sequences en de meeste Workspace-aanroepen gebruiken 0 credits. De kosten zitten in zoeken en verrijken, wat we hieronder behandelen.

Zoeken is geen verrijking

Deze splitsing zorgt bij nieuwe gebruikers vaak voor verwarring. Als je zoekt in de database van Apollo.io met mensen, krijg je profielen. De resultaten bevatten geen e-mailadressen of telefoonnummers. Je hebt een tweede aanroep naar een enrichment-endpoint nodig om die te verkrijgen. Zoeken in je eigen opgeslagen contacten gebruikt een andere set endpoints, met andere beperkingen.

Apollo.io API-documentatie voor personen zoeken

De Apollo.io API-documentatie voor personen zoeken behandelt één POST-endpoint: /mixed_people/api_search. Apollo.io beschrijft personen als nieuwe prospects die je nog niet als contacten hebt opgeslagen.

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'

De parameters komen in de querystring. Je kunt de zoekopdracht verfijnen op:

  • Functietitels: person_titles[], plus person_not_titles[] om bepaalde titels uit te sluiten.
  • Senioriteit: person_seniorities[].
  • Locatie: person_locations[] voor waar mensen wonen, organization_locations[] voor het hoofdkantoor van het bedrijf.
  • Bedrijfsgrootte en omzet: organization_num_employees_ranges[] en revenue_range[min].
  • Technologie: filters voor meer dan 1.500 technologieën die een bedrijf gebruikt.
  • Wervingssignalen: q_organization_job_titles[] en aantallen vacatures.
  • E-mailstatus: contact_email_status[], met waarden zoals geverifieerd, niet geverifieerd, waarschijnlijk bereid tot interactie en niet beschikbaar.
  • Paginering: page en per_page.

Het endpoint voor personen zoeken gebruikt 0 credits. Het retourneert maximaal 100 records per pagina. Er geldt ook een weergavelimiet van 50.000 records, oftewel 500 pagina's. Voeg filters toe om daaronder te blijven.

Wat de Apollo.io API voor personen zoeken retourneert

Een antwoord op een zoekopdracht naar personen bevat een telling total_entries en een lijst people. E-mailadressen en telefoonnummers worden weggelaten. Geef elk resultaat door aan het enrichment-endpoint om contactgegevens te verkrijgen.

Zoeken heeft eigen limieten, die hieronder in het gedeelte over rate limits worden vermeld.

Als je zoekt op contact_email_status[], let dan op waar de waarde vandaan komt. Deze beschrijft Apollo.io's eigen registratie van het adres. Het is geen live test van de mailbox.

De Apollo.io API-documentatie voor personen zoeken sneller lezen

Begin met het vak Endpoint-essentials. Controleer de regels voor creditgebruik en toegang met een gratis account. Scan vervolgens de parameterlijst op de filters die je nodig hebt. Voer ten slotte één kleine aanvraag uit met per_page=10 voordat je door duizenden resultaten bladert.

Verrijk personen met de Apollo.io API

Verrijking vernieuwt records die je al bezit. Apollo.io biedt twee endpoints voor personen:

  • Personenverrijking: POST /people/match, één persoon per aanroep.
  • Bulkpersonenverrijking: maximaal 10 personen in één aanvraag.

Apollo.io heeft voldoende details nodig om de juiste persoon te vinden. Alleen een e-mailadres werkt. Een naam plus een bedrijfsdomein werkt ook. Het endpoint accepteert ook een LinkedIn URL, een organisatienaam of een Apollo.io-persoons-ID. Als je alleen een naam verstuurt, kun je een 200-antwoord krijgen waarin niets is verrijkt.

Controleer match_confidence in elk antwoord. Dit is high, medium, low of 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'

Het antwoord bevat de functietitel, arbeidsgeschiedenis, bedrijfsgegevens en een email_status, zoals verified. Die status is het eigen label van Apollo.io. Onze controle later in deze handleiding test het adres zelf.

Telefoonnummers, privéadressen en waterfall

Drie optionele schakelaars wijzigen wat je terugkrijgt:

  • reveal_personal_emails=true voegt privéadressen toe. Apollo.io onthult deze niet voor personen in GDPR-regio's.
  • reveal_phone_number=true voegt elk telefoonnummer toe, inclusief mobiele nummers. Hiervoor is een webhook_url vereist. Apollo.io controleert de nummers asynchroon en plaatst ze op je webhook, wat enkele minuten kan duren.
  • run_waterfall_email en run_waterfall_phone zoeken eerst in Apollo.io en daarna bij je geconfigureerde externe gegevensleveranciers. Definitieve resultaten komen ook via webhook binnen.

Voorkom dubbele betaling

Als je dezelfde persoon later opnieuw verrijkt, betaal je mogelijk opnieuw credits voor dezelfde gegevens. Apollo.io stelt voor om verrijkte personen om te zetten in contacten. Een contact hoort bij je organisatie, zodat de gegevens ervan toegankelijk blijven.

Apollo.io API-snelheidslimieten

Snelheidslimieten gelden per team, niet per sleutel of per gebruiker. Ze gelden ook per endpoint en lopen tegelijkertijd in drie vensters: een minuut, een uur en een dag. Je moet binnen elk toepasselijk venster blijven.

LimietGratisBasicProfessionalOrganization
Verzoeken per minuut50200200200
Verzoeken per uur200400400600
Verzoeken per dag6002.0002.0006.000

Die tabel is de standaard. Search- en enrichment-endpoints krijgen hogere limieten bij betaalde abonnementen:

  • Enrichment-endpoints: 1.000 verzoeken per minuut bij betaalde abonnementen, zonder limiet per uur of per dag. Gratis accounts krijgen 50 per minuut en 20 voor bulk-endpoints.
  • Search-endpoints: 200 per minuut, 6.000 per uur en 50.000 per dag bij betaalde abonnementen.
  • Lagere limieten: het query analytics-rapport staat 5 verzoeken per uur toe.

In de documentatie van Apollo.io staat dat de hoge enrichment-limiet geen toestemming is om onbeperkt calls te versturen. Je creditsaldo bepaalt nog steeds hoeveel je kunt verrijken.

Apollo.io API-ontwikkelaarsportal met de Usage-pagina, waarop dagelijkse en uurlijkse snelheidslimieten voor enrichment worden weergegeven

Schermafbeelding: de Usage-pagina van het Apollo.io-ontwikkelaarsportal, met dagelijkse en uurlijkse limieten voor de enrichment-endpoints, uit de documentatie van Apollo.io.

Response-headers en de 429-fout

Apollo.io voegt headers toe aan geauthenticeerde calls. Ze tonen de limiet, het verbruik tot nu toe en het aantal resterende verzoeken voor elk venster:

  • x-rate-limit-minute, x-rate-limit-hourly en x-rate-limit-24-hour
  • x-minute-usage, x-hourly-usage en x-24-hour-usage
  • x-minute-requests-left, x-hourly-requests-left en x-24-hour-requests-left
  • retry-after, dat samen met een 429 wordt verzonden, geeft het aantal seconden tot het venster wordt gereset

Wanneer je een limiet overschrijdt, krijg je een 429. Lees retry-after en wacht. Het venster begint bij je eerste verzoek en is niet gekoppeld aan de klok. De fouttekst bevat een error_details-object. De code daarvan is USAGE.RATE_LIMIT.API_RATE_LIMIT_EXCEEDED voor je eigen limiet.

Om de huidige limieten van je team in code te lezen, roep je het endpoint voor het bekijken van API-gebruiksstatistieken aan. Eén call kan maximaal 74 endpointpaden omvatten en kost geen credits.

Apollo.io API-credits: wat geld kost

Veel aanroepen kosten niets. Apollo.io geeft aan dat endpoints die records aanmaken, bijwerken, opsommen of beheren 0 credits verbruiken. Credits gaan naar verrijking, zoeken naar organisaties, zoeken naar nieuws en AI-inzicht-endpoints, en alleen wanneer ze relevante gegevens opleveren.

EndpointKosten in credits
Verrijking van personen1 tot 9 per persoon: 1 voor demografische gegevens of e-mail, plus 8 als er een mobiel telefoonnummer wordt gevonden
Bulkverrijking van personenDezelfde logica, tot 10 personen per verzoek
Verrijking van organisaties1 per organisatie
Zoeken naar organisaties1 per pagina, tot 100 resultaten per pagina
Zoeken naar nieuwsartikelen1 per pagina, tot 25 resultaten per pagina
Vacatures van organisaties1 per pagina
Volledige persoonsinformatie ophalen1 per persoon
AssistenttaakVariabel, bepaald door de acties die de assistent uitvoert

Zoeken naar personen is gratis, dus een verstandige aanpak is om eerst te zoeken en alleen de beste overeenkomsten te verrijken. Door een endpoint dat credits verbruikt pagina voor pagina te doorlopen, besteed je credits aan elke pagina. Apollo.io adviseert een kleine test uit te voeren en je gebruik te bekijken voordat je opschaalt.

Watervalverrijking kan meer kosten. Een e-mailwaterval gebruikt doorgaans 1 tot 4 credits, en sommige configuraties gebruiken 20 of meer. Een telefoonwaterval gebruikt doorgaans 8 tot 25 credits, en sommige gebruiken 45 of meer.

Als je je uitgaven wilt bijhouden, ga je in de app naar Settings > Billing and credits > Credit usage. Het tabblad Usage van het ontwikkelaarsdashboard toont hoeveel telefoon- en e-mailcredits in de huidige factureringscyclus zijn gebruikt. Legacy-abonnementen kunnen afwijken, dus bekijk de pagina About credits voor jouw werkruimte.

Fouten en statuscodes

De meeste Apollo.io API-eindpunten delen een korte lijst met statuscodes:

CodeBetekenisVeelvoorkomende oorzaak
401Niet geautoriseerdSleutel ontbreekt, is ongeldig of komt van een inactief account
403VerbodenAbonnement heeft geen API-toegang, of een sleutel met scope heeft geen toegang tot het eindpunt
404Niet gevondenHet record bestaat niet of is niet voor u zichtbaar
422Niet verwerkbaarOngeldige of ontbrekende parameter
429Te veel verzoekenU heeft een rate limit overschreden
500ServerfoutEen fout aan de kant van Apollo.io; probeer het daarom opnieuw

Apollo.io zet fouten om naar één indeling. Wanneer een eindpunt is overgezet, bevat de respons een error_details-object met een stabiele code, een message, suggestions en context. Laat uw code vertakken op error_details.code, nooit op de tekst van het bericht. Apollo.io is van plan de oude foutvelden op rootniveau op 16 februari 2027 te verwijderen, dus bouw nu al op het nieuwe object.

De Apollo.io MCP-server

MCP is een standaard waarmee AI-tools externe services kunnen aanroepen. De Apollo.io MCP-server koppelt Claude, ChatGPT en vergelijkbare clients aan je Apollo.io-account. Je kunt dan in gewone taal vragen: vind marketingleiders op VP-niveau bij SaaS-bedrijven, of verrijk deze tien prospects.

Apollo.io MCP-documentatiepagina met de drie manieren om verbinding te maken: AI-connectors, programmeerplug-ins en een zelfstandige MCP-server

Schermafbeelding: de Apollo.io MCP-pagina in de ontwikkelaarsdocumentatie, oktober 2026.

Drie manieren om verbinding te maken

RouteHoe het werkt
AI-connectorsIngebouwde integraties in ChatGPT, Claude, Perplexity, Replit en Cursor. Geen serverconfiguratie.
Programmeerplug-insPlug-ins van de eerste partij voor tools zoals Codex.
Zelfstandige MCP-serverVerwijs elke MCP-client die externe servers ondersteunt naar één URL.

De zelfstandige instellingen zijn kort:

InstellingWaarde
Endpointhttps://mcp.apollo.io/mcp
TransportStreamable HTTP
AanmeldenOAuth 2.0
Lokale installatieNiet nodig
API-sleutelNiet nodig, tenzij de client geen browser heeft

In Claude Code voegt één opdracht de server toe. Voer deze uit, typ vervolgens /mcp en voltooi de OAuth-aanmelding:

claude mcp add --transport http apollo https://mcp.apollo.io/mcp

Als je meerdere workspaces beheert, voeg je dezelfde URL onder een andere naam toe voor elke workspace. Meld je afzonderlijk aan bij elke verbinding.

Servers zonder browser

OAuth heeft een browservenster nodig. Een cronjob of CI-pipeline heeft dat niet. Voor dergelijke gevallen accepteert de server een API-sleutel die als X-Api-Key wordt verzonden. De sleutel moet een hoofdsleutel zijn. Een sleutel met beperkte scope geeft een 403 met de code API_INACCESSIBLE, omdat de MCP-server niet een van de endpoints is die je kunt aanvinken.

Bewaar die sleutel zoals elk productiegeheim. De sleutel fungeert als beheerder van de workspace en verbruikt workspace-tegoed. Nieuwe MCP-tools krijgen onmiddellijk toegang tot een hoofdsleutel, maar je client kan een gecachte tool-lijst behouden. Maak opnieuw verbinding en roep tools/list aan om de lijst te vernieuwen.

Wat de Apollo.io MCP-server kan doen

De tool-lijst omvat zoeken en prospecting, verrijking van personen en bedrijven, contacten, lijsten, sequences, eenmalige e-mails, taken, controles van e-maildomeinen en analytics. Verrijkingsacties verbruiken tegoed. De meeste andere acties verbruiken niets. Apollo.io waarschuwt dat zoeken naar personen geen e-mailadressen of telefoonnummers retourneert, dus je assistent moet daarvoor een verrijkingsstap uitvoeren.

Praktische beperkingen uit de documentatie:

  • Er zijn geen extra kosten voor het maken van verbinding. Je abonnement, machtigingen en tegoed zijn van toepassing.
  • Destructieve acties, zoals bulk verwijderen, worden niet ondersteund.
  • De server volgt je machtigingen. Met OAuth handelt hij namens de gebruiker die zich heeft aangemeld.
  • Apollo.io MCP gebruikt afzonderlijke snelheidslimieten en retourneert de headers van die snelheidslimieten niet.
  • Apollo.io verbiedt het trainen van AI-modellen met zijn MCP-gegevens, dus schakel training eerst uit in je AI-client.

Apollo.io raadt aan om acties die tegoed verbruiken in te stellen op Goedkeuring vereist, zodat een praatgrage assistent niet zelfstandig al het tegoed kan verbruiken.

Andere manieren om de Apollo.io API te gebruiken

  • Apollo.io CLI. Een opdrachtregeltool met toegang tot de volledige API. Installeer deze met Homebrew, een vooraf gebouwde binary of vanuit de broncode. De tool gebruikt OAuth en heeft daarom geen sleutel nodig.
  • OAuth 2.0. Partners gebruiken dit om de API aan te roepen voor gezamenlijke klanten, en de documentatie vermeldt een marketplace-applicatie voor voltooide integraties.
  • Chrome-extensie. Als je liever klikt dan code schrijft, lees dan onze handleiding voor de Apollo Chrome-extensie.

Controleer adressen via de Apollo.io API voordat je verzendt

Welke route je ook kiest, de data heeft één zwakke plek. Ze komt uit een database. Mensen veranderen van baan en bedrijven verhuizen naar nieuwe domeinen. Het veld email_status is Apollo.io's eigen label, geen actuele test. Een koude e-mail naar een niet-bestaand adres stuitert terug, en bounces schaden je reputatie als afzender.

Voeg daarom een controle toe tussen verrijking en je sequence. BillionVerify test elk adres zonder een bericht te verzenden. Het controleert de syntaxis, het domein, MX-records en, wanneer je dat vraagt, de mailbox via SMTP. Het markeert wegwerp- en rolgebaseerde adressen. Catch-all wordt als afzonderlijk resultaat gemeld in plaats van als geldig te worden beschouwd. Onbekende resultaten kosten niets, en een nieuwe controle binnen 24 uur is gratis. Voordat je de API koppelt, kun je handmatig via de gratis webchecker controleren of een e-mailadres bestaat.

Resultaten van de BillionVerify e-mailverificatie-API met status-, leverbaarheids- en redenvelden

BillionVerify retourneert voor elk adres een status, een leverbaarheidsvlag en een reden.

Een kleine pipeline

Een eenvoudige pipeline bestaat uit vier stappen:

  1. Voer via de API een gratis zoekopdracht naar personen uit.
  2. Verrijk alleen de beste overeenkomsten.
  3. Stuur elk adres naar de BillionVerify REST API.
  4. Voeg alleen leverbare adressen toe aan je sequence.

De BillionVerify-aanroep is één POST. Stuur de sleutel mee in de BV-API-KEY-header en stel check_smtp in op true voor een live mailboxcontrole:

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}'

Het antwoord bevat status, is_deliverable, is_catchall, is_role, is_disposable en een reason. Gebruik voor maximaal 50 adressen in één aanroep de bulkroute. Upload voor een volledige export een CSV-, TXT- of XLSX-bestand en download de resultaten later. De volledige referentie staat in de BillionVerify-documentatie.

Verifieer vanuit de AI-client

Als je de MCP-configuratie van Apollo.io al met een AI-client verbindt, voeg dan de gehoste MCP-server van BillionVerify eraan toe. Deze staat op https://mcp.billionverify.com/mcp en gebruikt OAuth om in te loggen. Je assistent kan vervolgens een prospect via Apollo.io verrijken en het adres in één gesprek controleren. Vertel de assistent wat je beleid is, bijvoorbeeld welke statussen je accepteert en wat er met catch-all moet gebeuren.

Andere controles

  • Onze pagina over Apollo-e-mailverificatie behandelt de exportworkflow.
  • Een verdacht contact kan via onze gratis omgekeerde e-mailzoekopdracht worden gecontroleerd, die laat zien wat er publiekelijk aan een adres is gekoppeld.
  • Ook telefoonnummers die via de webhook worden geretourneerd, verdienen een controle. Onze gratis telefoonnummer-validator laat zien of een nummer geldig is voor het betreffende land en welk type lijn het is.

BillionVerify geeft je elke dag dat je je account gebruikt 20 gratis credits, tot maximaal 600 per maand. Ze verlopen nooit en je hebt geen creditcard nodig.

Tips voor het bouwen met de Apollo.io API

  • Begin met één afgebakende sleutel per integratie. Als er één uitlekt, hoef je alleen die sleutel in te trekken.
  • Voer eerst de gezondheidscontrole uit. Zo sluit je problemen met sleutels uit voordat je code debugt.
  • Lees het vak Endpoint-essentials. De documentatie voor personen zoeken met de Apollo.io API toont de kredietkosten meteen.
  • Zoek voordat je verrijkt. Zoeken is gratis, verrijking niet.
  • Test met per_page=10. Kleine runs laten de kredietkosten zien voordat ze oplopen.
  • Respecteer retry-after. Een beperkt endpoint blijven bestoken verlengt de wachttijd alleen maar.
  • Lees error_details.code. De berichttekst kan zonder aankondiging veranderen.
  • Verifieer voordat je verzendt. Een krediet dat je besteedt aan een adres dat terugkaatst, is twee keer verspild.

Veelgestelde vragen

Heeft Apollo.io een API?

Ja, Apollo.io heeft een REST API. Hiermee kun je personen en bedrijven zoeken, contacten verrijken en accounts, deals en sequences bijwerken. Basisgebruik is inbegrepen bij elk abonnement. Je abonnement bepaalt welke endpoints je kunt aanroepen, hoe snel en wat elke aanroep kost.

Hoe krijg ik een Apollo.io API-sleutel?

Een Apollo.io-sleutel vind je in het gedeelte Integraties van Instellingen: open API Keys en kies Nieuwe sleutel maken. Geef de sleutel een naam, vink de endpoints aan die de sleutel mag aanroepen en bevestig. Kopieer het geheim vervolgens meteen. Een beheerder of gebruiker met het juiste toestemmingsprofiel kan dit doen.

Waar kan ik mijn Apollo.io API-sleutel vinden?

De lijst met Apollo.io API-sleutels staat op de pagina API Keys, die je vanuit de app of het ontwikkelaarsdashboard kunt openen. Het volledige geheim wordt weergegeven wanneer je de sleutel maakt. Als je het geheim kwijtraakt, moet je de sleutel opnieuw genereren, waarna een nieuwe sleutel wordt uitgegeven.

Is de Apollo.io API gratis?

Apollo.io API-aanroepen waarmee je records maakt, weergeeft of bijwerkt, kosten niets. Ook zoeken naar personen is gratis. Voor verrijking en sommige zoekendpoints worden credits in rekening gebracht wanneer ze gegevens retourneren. Gratis accounts kunnen de API gebruiken binnen de limieten van het gratis abonnement, maar voor sommige endpoints is een zakelijk e-mailadres vereist.

Wat is de snelheidslimiet van de Apollo.io API?

Bij een betaald abonnement verwerken de meeste Apollo.io API-endpoints 200 aanroepen per minuut, met uur- en daglimieten die per abonnement verschillen. Het gratis abonnement staat 50 per minuut, 200 per uur en 600 per dag toe. Limieten gelden per team en per endpoint. Een 429-reactie betekent dat je een limiet hebt overschreden.

Hoe test ik de gezondheidscontrole van de Apollo.io API?

De gezondheidscontrole van Apollo.io is een GET-verzoek naar het pad auth/health, waarbij de sleutelheader is ingesteld. Een reactie met healthy: true en is_logged_in: true betekent dat de sleutel werkt. Er worden geen credits verbruikt.

Retourneert de Apollo.io API voor personen zoeken e-mailadressen?

Nee, het endpoint voor personen zoeken van Apollo.io retourneert alleen profielen, zonder e-mailadressen of telefoonnummers. Voer op de resultaten het endpoint voor personenverrijking of bulkverrijking van personen uit om contactgegevens te verkrijgen. Dit kost credits.

Waar staat de documentatie van de Apollo.io API?

De documentatie van de Apollo.io API staat op docs.apollo.io. Elk endpoint heeft een eigen pagina met parameters, een testpaneel en een voorbeeldreactie. Je kunt ook het OpenAPI-bestand downloaden en in Postman importeren.

Wat is de Apollo.io MCP-server?

De Apollo.io MCP-server koppelt AI-clients via het Model Context Protocol aan je werkruimte. De URL is https://mcp.apollo.io/mcp, de server gebruikt Streamable HTTP en OAuth en vereist geen lokale installatie. Je abonnement, machtigingen en credits blijven van toepassing.

Wat is de beste MCP-server voor Apollo.io?

Apollo.io publiceert één officiële MCP-server en dat is de server die in de documentatie wordt beschreven. We hebben opties van derden niet getest. Kies de officiële server als je dezelfde machtigingen en creditregels als in de app wilt gebruiken.

Moet ik e-mailadressen verifiëren die afkomstig zijn van de Apollo.io API?

Ja, controleer elk e-mailadres uit de Apollo.io API voordat je een campagne start. Het veld email_status weerspiegelt de eigen gegevens van Apollo.io, en mensen veranderen van baan. Een snelle controle via de BillionVerify API verwijdert ongeldige adressen en beschermt de reputatie van je afzender.

Bekijk de video: Een telefoonnummer valideren: gratis telefoonnummervalidator

Bekijk de video: Zo verifieert u Apollo-e-mails voordat u verstuurt

Leo
LeoFounder, BillionVerify
E-mailverificatie-inzichten

Begin Vandaag met Verifiëren

Begin vandaag nog met het verifiëren van e-mails met BillionVerify. Ontvang 20 gratis credits voor elke dag dat u inlogt, tot 600 per maand - geen creditcard vereist. Sluit u aan bij duizenden bedrijven die hun e-mailmarketing-ROI verbeteren met nauwkeurige e-mailverificatie.

Geen creditcard vereist · Realtime API en bulkverificatie · Onbekende resultaten zijn gratis

0
Credits voor onbekende resultaten
Realtime
API-snelheid
$0.00014
Per e-mail
600/mnd
Altijd gratis