People API-zoekopdracht

De e-mailstatussen van de personen die je wilt vinden. Je kunt meerdere statussen toevoegen om je zoekopdracht uit te breiden. De statussen waarop je kunt zoeken zijn: verified unverified likely to engage unavailable

Sluit personen uit van je zoekopdracht op basis van een van de technologieën die hun huidige werkgever gebruikt. Apollo ondersteunt filteren op meer dan 1.500 technologieën. Apollo berekent technologiedata uit meerdere bronnen. Deze gegevens worden regelmatig bijgewerkt. Download dit CSV-bestand voor de volledige lijst met ondersteunde technologieën. Vervang spaties en punten door underscores (_) voor de technologieën die in het CSV-bestand staan. Voorbeelden: salesforce; google_analytics; wordpress_org

Vind personen op basis van alle technologieën die hun huidige werkgever gebruikt. Apollo ondersteunt filteren op meer dan 1.500 technologieën. Apollo berekent technologiedata uit meerdere bronnen. Deze gegevens worden regelmatig bijgewerkt. Download dit CSV-bestand voor de volledige lijst met ondersteunde technologieën. Vervang spaties en punten door underscores (_) voor de technologieën die in het CSV-bestand staan. Voorbeelden: salesforce; google_analytics; wordpress_org

Vind personen op basis van een van de technologieën die hun huidige werkgever gebruikt. Apollo ondersteunt filteren op meer dan 1.500 technologieën. Apollo berekent technologiedata uit meerdere bronnen. Deze gegevens worden regelmatig bijgewerkt. Download dit CSV-bestand voor de volledige lijst met ondersteunde technologieën. Vervang spaties en punten door underscores (_) voor de technologieën die in het CSV-bestand staan. Voorbeelden: salesforce; google_analytics; wordpress_org

Deze parameter bepaalt of personen met functietitels die lijken op de titels die je in person_titles[] opgeeft, in de respons worden geretourneerd. Stel deze parameter in op false wanneer je met person_titles[] alleen strikte overeenkomsten voor functietitels wilt retourneren.

De Apollo-ID's van de bedrijven (werkgevers) die je in je zoekresultaten wilt opnemen. Elk bedrijf in de Apollo-database krijgt een unieke ID. Roep het endpoint Organization Search aan om de ID's te vinden en lees de waarden voor organization_id. Voorbeeld: 5e66b6381e05b4008c8331b8

De locaties van de vacatures waarvoor de werkgever van de persoon actief werft. Voorbeelden: atlanta; japan

De laatste datum waarop de huidige werkgever van de persoon vacatures heeft geplaatst. Gebruik deze parameter samen met organization_job_posted_at_range[min] om een periode in te stellen waarin vacatures zijn geplaatst. Voorbeeld: 2025-09-25

De vroegste datum waarop de huidige werkgever van de persoon vacatures heeft geplaatst. Gebruik deze parameter samen met organization_job_posted_at_range[max] om een periode in te stellen waarin vacatures zijn geplaatst. Voorbeeld: 2025-07-25

De locatie van het hoofdkantoor van de huidige werkgever van de persoon. Je kunt zoeken in steden, Amerikaanse staten en landen. Heeft een bedrijf meerdere kantoren, dan zijn de resultaten nog steeds gebaseerd op de hoofdvestiging. Als je bijvoorbeeld chicago zoekt maar het hoofdkantoor van een bedrijf in boston staat, verschijnen personen die voor dat bedrijf in Boston werken niet in je resultaten, ook al voldoen ze aan andere parameters. Gebruik de parameter person_locations om personen op basis van hun persoonlijke locatie te vinden. Voorbeelden: texas; tokyo; spain

Het bereik van het aantal medewerkers van het huidige bedrijf van de persoon. Hiermee vind je personen op basis van de omvang van hun werkgever. Je kunt meerdere bereiken toevoegen om je zoekresultaten uit te breiden. Elk bereik moet een tekenreeks zijn, waarbij de onder- en bovengrens alleen door een komma worden gescheiden. Voorbeelden: 1,10; 250,500; 10000,20000

Het maximale aantal actieve vacatures bij de huidige werkgever van de persoon. Gebruik deze parameter samen met organization_num_jobs_range[min] om een vacaturebereik in te stellen. Voorbeelden: 50; 500

Het minimale aantal actieve vacatures bij de huidige werkgever van de persoon. Gebruik deze parameter samen met organization_num_jobs_range[max] om een vacaturebereik in te stellen. Voorbeelden: 50; 500

Het paginanummer van de Apollo-gegevens die je wilt ophalen. Gebruik deze parameter samen met per_page om de zoekresultaten overzichtelijk te maken en de prestaties van het endpoint te verbeteren. Voorbeeld: 4

Het aantal zoekresultaten dat per pagina wordt geretourneerd. Het beperken van het aantal resultaten per pagina verbetert de prestaties van het endpoint. Gebruik de parameter page om de verschillende gegevenspagina's te doorzoeken. Voorbeeld: 10

De woonlocatie van personen. Je kunt zoeken in steden, Amerikaanse staten en landen. Gebruik de parameter organization_locations om personen te vinden op basis van de hoofdvestiging van hun huidige werkgever. Voorbeelden: california; ireland; chicago

De functiesenioriteit die personen binnen hun huidige werkgever bekleden. Hiermee vind je personen die momenteel functies op bepaalde rapportagelagen bekleden, zoals Director-niveau of senior IC-niveau. Om in de zoekresultaten te worden opgenomen, hoeft een persoon slechts aan 1 van de toegevoegde senioriteiten te voldoen. Meer senioriteiten toevoegen breidt je zoekresultaten uit. Zoekopdrachten retourneren alleen resultaten op basis van de huidige functietitel, dus zoeken naar medewerkers op Director-niveau retourneert alleen personen die momenteel een titel op Director-niveau hebben. Iemand die eerder Director was maar nu VP is, wordt niet in je zoekresultaten opgenomen. Gebruik deze parameter samen met person_titles[] om personen te vinden op basis van specifieke functiegebieden en senioriteitsniveaus. Voor deze parameter zijn de volgende opties beschikbaar: owner founder c_suite partner vp head director manager senior entry intern

Functietitels van de personen die je wilt vinden. Om in de zoekresultaten te worden opgenomen, hoeft een persoon slechts aan 1 van de toegevoegde functietitels te voldoen. Meer functietitels toevoegen breidt je zoekresultaten uit. Resultaten bevatten ook functietitels met dezelfde termen, zelfs als ze niet exact overeenkomen. Zoeken naar marketing manager kan bijvoorbeeld personen opleveren met de functietitel content marketing manager. Gebruik deze parameter samen met person_seniorities[] om personen te vinden op basis van specifieke functiegebieden en senioriteitsniveaus. Voorbeelden: sales development representative; marketing manager; research analyst

Een tekenreeks van woorden waarop de resultaten worden gefilterd.

De domeinnaam van de werkgever van de persoon. Dit kan de huidige of een vroegere werkgever zijn. Voeg geen www., @-teken of iets dergelijks toe. Deze parameter accepteert maximaal 1.000 domeinen per verzoek. Voorbeelden: apollo.io; microsoft.com

De functietitels in actieve vacatures bij de huidige werkgever van de persoon. Voorbeelden: sales manager; research analyst

De maximale omzet van de huidige werkgever van de persoon. Gebruik deze parameter samen met revenue_range[min] om een omzetbereik in te stellen. Voer geen valutasymbolen, komma's of decimalen in de waarde in. Voorbeelden: 500000; 1500000

De minimale omzet van de huidige werkgever van de persoon. Gebruik deze parameter samen met revenue_range[max] om een omzetbereik in te stellen. Voer geen valutasymbolen, komma's of decimalen in de waarde in. Voorbeelden: 500000; 1500000

Geslaagde respons

Het verzoek kon niet worden verwerkt. Controleer de verzoekparameters.

Een geldige Felo-API-sleutel is vereist.

Het verzoek kan niet doorgaan omdat niet aan een factureringsvoorwaarde is voldaan.

Het account mag deze bewerking niet uitvoeren.

Een verzoek- of bestedingslimiet is bereikt.

De dienst kon het verzoek niet voltooien.

De API of factureringsdienst is tijdelijk niet beschikbaar.

Er is een time-out opgetreden bij het verwerken van het verzoek.

Foutrespons; upstream-passthrough-responsen kunnen indelingen van de provider gebruiken