Apollo
Person and company enrichment, people search, company job postings and news. Requires Felo administrative permission.
People-API-Suche
Findet Personen, die den Kriterien entsprechen, statt jemanden anzureichern, den Sie bereits identifiziert haben. Filtern Sie nach Berufsbezeichnung, Seniorität, Standort, Unternehmensdomain, Mitarbeiterzahl und Branche und blättern Sie mit page und per_page. Gibt total_entries und ein people-Array zurück. Beachten Sie, was die Suche bewusst zurückhält: Einträge enthalten last_name_obfuscated und boolesche Flags – has_email, has_direct_phone, has_city, has_state, has_country – statt der Werte selbst. Die Suche zeigt, dass ein Treffer existiert; die Anreicherung liefert die Kontaktdaten. Übergeben Sie die IDs an post_apollo_people_match oder post_apollo_people_bulk_match, um E-Mail-Adressen und Telefonnummern zu erhalten; dort werden auch die Credits verbraucht. Erfordert Felo-Administratorberechtigung.
Preisreferenz
- Abrechnung: Feste Kostenbasis pro erfolgreicher Anfrage.
- Referenzschätzung pro Anfrage: USD 0.012.
Nur Referenzmetadaten, kein Kontenangebot, kein garantierter Preis und keine Ausgabenobergrenze. Ressourcen-Credits sind keine Felo-Credits. Endgültige Abrechnungen richten sich nach den Felo-Abrechnungsbelegen.
- Typ: array string[]contact
_email _status[] Die E-Mail-Status der gesuchten Personen. Sie können mehrere Status hinzufügen, um die Suche zu erweitern. Die durchsuchbaren Status sind: verified unverified likely to engage unavailable
- Typ: array string[]currently
_not _using _any _of _technology _uids[] Schließen Sie Personen anhand einer beliebigen Technologie aus, die ihr aktueller Arbeitgeber verwendet. Apollo unterstützt Filter nach über 1.500 Technologien. Apollo berechnet Technologiedaten aus mehreren Quellen. Diese Daten werden regelmäßig aktualisiert. Laden Sie diese CSV-Datei herunter, um die vollständige Liste der unterstützten Technologien anzuzeigen. Ersetzen Sie bei den in der CSV-Datei aufgeführten Technologien Leerzeichen und Punkte durch Unterstriche (_). Beispiele: salesforce; google_analytics; wordpress_org
- Typ: array string[]currently
_using _all _of _technology _uids[] Finden Sie Personen anhand aller Technologien, die ihr aktueller Arbeitgeber verwendet. Apollo unterstützt Filter nach über 1.500 Technologien. Apollo berechnet Technologiedaten aus mehreren Quellen. Diese Daten werden regelmäßig aktualisiert. Laden Sie diese CSV-Datei herunter, um die vollständige Liste der unterstützten Technologien anzuzeigen. Ersetzen Sie bei den in der CSV-Datei aufgeführten Technologien Leerzeichen und Punkte durch Unterstriche (_). Beispiele: salesforce; google_analytics; wordpress_org
- Typ: array string[]currently
_using _any _of _technology _uids[] Finden Sie Personen anhand einer beliebigen Technologie, die ihr aktueller Arbeitgeber verwendet. Apollo unterstützt Filter nach über 1.500 Technologien. Apollo berechnet Technologiedaten aus mehreren Quellen. Diese Daten werden regelmäßig aktualisiert. Laden Sie diese CSV-Datei herunter, um die vollständige Liste der unterstützten Technologien anzuzeigen. Ersetzen Sie bei den in der CSV-Datei aufgeführten Technologien Leerzeichen und Punkte durch Unterstriche (_). Beispiele: salesforce; google_analytics; wordpress_org
- Typ: booleaninclude
_similar _titles Dieser Parameter legt fest, ob Personen mit Berufsbezeichnungen zurückgegeben werden, die den in person_titles[] definierten Titeln ähneln. Setzen Sie diesen Parameter auf false, wenn person_titles[] nur exakte Übereinstimmungen bei Berufsbezeichnungen liefern soll.
- Typ: array string[]organization
_ids[] Die Apollo-IDs der Unternehmen (Arbeitgeber), die in die Suchergebnisse aufgenommen werden sollen. Jedem Unternehmen in der Apollo-Datenbank ist eine eindeutige ID zugewiesen. Rufen Sie zum Ermitteln der IDs den Endpunkt Organization Search auf und lesen Sie die Werte für organization_id. Beispiel: 5e66b6381e05b4008c8331b8
- Typ: array string[]organization
_job _locations[] Die Standorte der Stellen, die der Arbeitgeber der Person aktiv besetzt. Beispiele: atlanta; japan
- Typ: stringorganization
_job _posted _at _range[max] Das späteste Datum, an dem der aktuelle Arbeitgeber der Person Stellen veröffentlicht hat. Verwenden Sie diesen Parameter zusammen mit organization_job_posted_at_range[min], um einen Zeitraum für die Veröffentlichung von Stellen festzulegen. Beispiel: 2025-09-25
- Typ: stringorganization
_job _posted _at _range[min] Das früheste Datum, an dem der aktuelle Arbeitgeber der Person Stellen veröffentlicht hat. Verwenden Sie diesen Parameter zusammen mit organization_job_posted_at_range[max], um einen Zeitraum für die Veröffentlichung von Stellen festzulegen. Beispiel: 2025-07-25
- Typ: array string[]organization
_locations[] Der Standort des Unternehmenshauptsitzes des aktuellen Arbeitgebers der Person. Sie können nach Städten, US-Bundesstaaten und Ländern suchen. Hat ein Unternehmen mehrere Standorte, richten sich die Ergebnisse dennoch nach dem Hauptsitz. Wenn Sie beispielsweise chicago suchen, der Hauptsitz eines Unternehmens aber in boston liegt, erscheinen dessen Mitarbeiter nicht in Ihren Ergebnissen, auch wenn sie andere Parameter erfüllen. Um Personen anhand ihres persönlichen Standorts zu finden, verwenden Sie den Parameter person_locations. Beispiele: texas; tokyo; spain
- Typ: array string[]organization
_num _employees _ranges[] Der Mitarbeiterzahlenbereich des aktuellen Unternehmens der Person. So finden Sie Personen anhand der Mitarbeiterzahl ihres Arbeitgebers. Sie können mehrere Bereiche hinzufügen, um die Suchergebnisse zu erweitern. Jeder Bereich muss als Zeichenkette angegeben werden, wobei die Unter- und Obergrenze nur durch ein Komma getrennt werden. Beispiele: 1,10; 250,500; 10000,20000
- Typ: integerorganization
_num _jobs _range[max] Die maximale Anzahl aktiver Stellenausschreibungen beim aktuellen Arbeitgeber der Person. Verwenden Sie diesen Parameter zusammen mit organization_num_jobs_range[min], um einen Bereich für Stellenausschreibungen festzulegen. Beispiele: 50; 500
- Typ: integerorganization
_num _jobs _range[min] Die minimale Anzahl aktiver Stellenausschreibungen beim aktuellen Arbeitgeber der Person. Verwenden Sie diesen Parameter zusammen mit organization_num_jobs_range[max], um einen Bereich für Stellenausschreibungen festzulegen. Beispiele: 50; 500
- Typ: integerpage
Die Seitenzahl der Apollo-Daten, die abgerufen werden soll. Verwenden Sie diesen Parameter zusammen mit per_page, um die Suchergebnisse übersichtlich zu machen und die Leistung des Endpunkts zu verbessern. Beispiel: 4
- Typ: integerper
_page Die Anzahl der Suchergebnisse, die pro Seite zurückgegeben werden sollen. Eine Begrenzung der Ergebnisse pro Seite verbessert die Leistung des Endpunkts. Verwenden Sie den Parameter page, um die verschiedenen Datenseiten zu durchsuchen. Beispiel: 10
- Typ: array string[]person
_locations[] Der Wohnort der Personen. Sie können nach Städten, US-Bundesstaaten und Ländern suchen. Um Personen anhand des Hauptsitzes ihres aktuellen Arbeitgebers zu finden, verwenden Sie den Parameter organization_locations. Beispiele: california; ireland; chicago
- Typ: array string[]person
_seniorities[] Die berufliche Seniorität der Personen bei ihrem aktuellen Arbeitgeber. So finden Sie Personen, die derzeit Positionen auf bestimmten Berichtsebenen innehaben, etwa der Director-Ebene oder der Senior-IC-Ebene. Damit eine Person in die Suchergebnisse aufgenommen wird, muss sie nur einer der hinzugefügten Senioritäten entsprechen. Mehr Senioritäten erweitern die Suchergebnisse. Suchen berücksichtigen nur die aktuelle Berufsbezeichnung: Eine Suche nach Director-Positionen liefert daher nur Personen, die derzeit eine Director-Position innehaben. Wer früher Director war, jetzt aber VP ist, wird nicht in die Ergebnisse aufgenommen. Verwenden Sie diesen Parameter zusammen mit person_titles[], um Personen anhand konkreter Funktionsbereiche und Senioritätsstufen zu finden. Für diesen Parameter sind folgende Optionen möglich: owner founder c_suite partner vp head director manager senior entry intern
- Typ: array string[]person
_titles[] Berufsbezeichnungen der gesuchten Personen. Damit eine Person in die Suchergebnisse aufgenommen wird, muss sie nur einer der hinzugefügten Berufsbezeichnungen entsprechen. Mehr Berufsbezeichnungen erweitern die Suchergebnisse. Ergebnisse enthalten auch Berufsbezeichnungen mit denselben Begriffen, selbst wenn sie nicht exakt übereinstimmen. Eine Suche nach marketing manager kann beispielsweise Personen mit der Berufsbezeichnung content marketing manager liefern. Verwenden Sie diesen Parameter zusammen mit person_seniorities[], um Personen anhand konkreter Funktionsbereiche und Senioritätsstufen zu finden. Beispiele: sales development representative; marketing manager; research analyst
- Typ: stringq
_keywords Eine Zeichenkette von Wörtern, nach der die Ergebnisse gefiltert werden.
- Typ: array string[]q
_organization _domains _list[] Der Domainname des Arbeitgebers der Person. Das kann der aktuelle oder ein früherer Arbeitgeber sein. Geben Sie kein www., kein @-Zeichen und Ähnliches an. Dieser Parameter akzeptiert bis zu 1.000 Domains pro Anfrage. Beispiele: apollo.io; microsoft.com
- Typ: array string[]q
_organization _job _titles[] Die Berufsbezeichnungen in aktiven Stellenausschreibungen beim aktuellen Arbeitgeber der Person. Beispiele: sales manager; research analyst
- Typ: integerrevenue
_range[max] Der maximale Umsatz des aktuellen Arbeitgebers der Person. Verwenden Sie diesen Parameter zusammen mit revenue_range[min], um einen Umsatzbereich festzulegen. Geben Sie im Wert keine Währungssymbole, Kommas oder Dezimalpunkte an. Beispiele: 500000; 1500000
- Typ: integerrevenue
_range[min] Der minimale Umsatz des aktuellen Arbeitgebers der Person. Verwenden Sie diesen Parameter zusammen mit revenue_range[max], um einen Umsatzbereich festzulegen. Geben Sie im Wert keine Währungssymbole, Kommas oder Dezimalpunkte an. Beispiele: 500000; 1500000
- Typ: object200
Erfolgreiche Antwort
- Typ: array string[]people
Antwort-Array
- Typ: integertotal
_entries Antwortfeld
application/json - 400
Die Anfrage konnte nicht verarbeitet werden. Prüfen Sie die Anfrageparameter.
- 401
Ein gültiger Felo-API-Schlüssel ist erforderlich.
- 402
Die Anfrage kann nicht fortgesetzt werden, da eine Abrechnungsvoraussetzung nicht erfüllt ist.
- 403
Das Konto ist für diesen Vorgang nicht berechtigt.
- 429
Ein Anfrage- oder Ausgabenlimit wurde erreicht.
- 502
Der Dienst konnte die Anfrage nicht abschließen.
- 503
Die API oder der Abrechnungsdienst ist vorübergehend nicht verfügbar.
- 504
Beim Verarbeiten der Anfrage ist eine Zeitüberschreitung aufgetreten.
- default
Fehlerantwort; Upstream-Passthrough-Antworten können Anbieterformate verwenden
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"
]
}