Apollo
Person and company enrichment, people search, company job postings and news. Requires Felo administrative permission.
Wyszukiwanie w People API
Wyszukuje osoby spełniające kryteria, zamiast wzbogacać kogoś, kogo już zidentyfikowano. Filtruj według stanowiska, szczebla, lokalizacji, domeny firmy, liczby pracowników i branży, a stronicuj za pomocą page i per_page. Zwraca total_entries oraz tablicę people. Zwróć uwagę, czego wyszukiwanie celowo nie ujawnia: wpisy zawierają last_name_obfuscated i flagi logiczne — has_email, has_direct_phone, has_city, has_state, has_country — zamiast samych wartości. Wyszukiwanie mówi, że dopasowanie istnieje; wzbogacenie ujawnia dane kontaktowe. Przekaż identyfikatory do post_apollo_people_match lub post_apollo_people_bulk_match, aby uzyskać adresy e-mail i numery telefonów — tam też zużywane są kredyty. Wymaga uprawnień administracyjnych Felo.
Informacje referencyjne o rozliczaniu
- Rozliczanie: stała podstawa kosztu za udane żądanie.
- Referencyjny szacunek żądania: USD 0.012.
Wyłącznie metadane referencyjne — nie stanowią oferty dla konta, gwarantowanej ceny ani limitu wydatków. Kredyty zasobów nie są kredytami Felo. Ostateczne obciążenia są zgodne z zapisami rozliczeniowymi Felo.
- Typ: array string[]contact
_email _status[] Statusy e-mail osób, które chcesz znaleźć. Możesz dodać wiele statusów, aby rozszerzyć wyszukiwanie. Statusy dostępne w wyszukiwaniu: verified unverified likely to engage unavailable
- Typ: array string[]currently
_not _using _any _of _technology _uids[] Wyklucza osoby z wyszukiwania na podstawie dowolnej z technologii używanych przez ich obecnego pracodawcę. Apollo obsługuje filtrowanie według ponad 1500 technologii. Apollo oblicza dane o technologiach z wielu źródeł. Dane te są regularnie aktualizowane. Pełną listę obsługiwanych technologii znajdziesz, pobierając ten plik CSV. W technologiach wymienionych w pliku CSV zastąp spacje i kropki podkreśleniami (_). Przykłady: salesforce; google_analytics; wordpress_org
- Typ: array string[]currently
_using _all _of _technology _uids[] Znajduje osoby na podstawie wszystkich technologii używanych przez ich obecnego pracodawcę. Apollo obsługuje filtrowanie według ponad 1500 technologii. Apollo oblicza dane o technologiach z wielu źródeł. Dane te są regularnie aktualizowane. Pełną listę obsługiwanych technologii znajdziesz, pobierając ten plik CSV. W technologiach wymienionych w pliku CSV zastąp spacje i kropki podkreśleniami (_). Przykłady: salesforce; google_analytics; wordpress_org
- Typ: array string[]currently
_using _any _of _technology _uids[] Znajduje osoby na podstawie dowolnej z technologii używanych przez ich obecnego pracodawcę. Apollo obsługuje filtrowanie według ponad 1500 technologii. Apollo oblicza dane o technologiach z wielu źródeł. Dane te są regularnie aktualizowane. Pełną listę obsługiwanych technologii znajdziesz, pobierając ten plik CSV. W technologiach wymienionych w pliku CSV zastąp spacje i kropki podkreśleniami (_). Przykłady: salesforce; google_analytics; wordpress_org
- Typ: booleaninclude
_similar _titles Ten parametr określa, czy w odpowiedzi zwracane są osoby o stanowiskach podobnych do zdefiniowanych w parametrze person_titles[]. Ustaw ten parametr na false, gdy używasz person_titles[], aby zwracać wyłącznie ścisłe dopasowania stanowisk.
- Typ: array string[]organization
_ids[] Identyfikatory Apollo firm (pracodawców), które chcesz uwzględnić w wynikach wyszukiwania. Każdej firmie w bazie Apollo przypisano unikalny identyfikator. Aby znaleźć identyfikatory, wywołaj endpoint Organization Search i odczytaj wartości organization_id. Przykład: 5e66b6381e05b4008c8331b8
- Typ: array string[]organization
_job _locations[] Lokalizacje stanowisk, na które aktywnie rekrutuje pracodawca osoby. Przykłady: atlanta; japan
- Typ: stringorganization
_job _posted _at _range[max] Najpóźniejsza data publikacji ofert pracy przez obecnego pracodawcę osoby. Użyj tego parametru razem z organization_job_posted_at_range[min], aby ustawić zakres dat publikacji ofert. Przykład: 2025-09-25
- Typ: stringorganization
_job _posted _at _range[min] Najwcześniejsza data publikacji ofert pracy przez obecnego pracodawcę osoby. Użyj tego parametru razem z organization_job_posted_at_range[max], aby ustawić zakres dat publikacji ofert. Przykład: 2025-07-25
- Typ: array string[]organization
_locations[] Lokalizacja siedziby firmy będącej obecnym pracodawcą osoby. Możesz przeszukiwać miasta, stany USA i kraje. Jeśli firma ma kilka biur, wyniki nadal opierają się na lokalizacji siedziby. Na przykład jeśli wyszukasz chicago, a siedziba firmy znajduje się w boston, osoby pracujące w firmie z Bostonu nie pojawią się w wynikach, nawet jeśli pasują do innych parametrów. Aby znaleźć osoby według ich osobistej lokalizacji, użyj parametru person_locations. Przykłady: texas; tokyo; spain
- Typ: array string[]organization
_num _employees _ranges[] Zakres liczby pracowników zatrudnionych w obecnej firmie osoby. Pozwala znajdować osoby według liczby pracowników ich pracodawcy. Możesz dodać wiele zakresów, aby rozszerzyć wyniki wyszukiwania. Każdy dodany zakres musi być ciągiem znaków, w którym górna i dolna liczba zakresu są rozdzielone wyłącznie przecinkiem. Przykłady: 1,10; 250,500; 10000,20000
- Typ: integerorganization
_num _jobs _range[max] Maksymalna liczba aktywnych ofert pracy u obecnego pracodawcy osoby. Użyj tego parametru razem z organization_num_jobs_range[min], aby ustawić zakres ofert pracy. Przykłady: 50; 500
- Typ: integerorganization
_num _jobs _range[min] Minimalna liczba aktywnych ofert pracy u obecnego pracodawcy osoby. Użyj tego parametru razem z organization_num_jobs_range[max], aby ustawić zakres ofert pracy. Przykłady: 50; 500
- Typ: integerpage
Numer strony danych Apollo do pobrania. Użyj tego parametru razem z parametrem per_page, aby ułatwić nawigację po wynikach wyszukiwania i poprawić wydajność endpointu. Przykład: 4
- Typ: integerper
_page Liczba wyników wyszukiwania zwracanych na stronę. Ograniczenie liczby wyników na stronę poprawia wydajność endpointu. Użyj parametru page, aby przeszukiwać kolejne strony danych. Przykład: 10
- Typ: array string[]person
_locations[] Lokalizacja, w której mieszkają osoby. Możesz przeszukiwać miasta, stany USA i kraje. Aby znaleźć osoby według lokalizacji siedzib ich obecnego pracodawcy, użyj parametru organization_locations. Przykłady: california; ireland; chicago
- Typ: array string[]person
_seniorities[] Szczebel stanowiska osób u obecnego pracodawcy. Pozwala znajdować osoby zajmujące obecnie stanowiska na określonych poziomach raportowania, takich jak poziom Director lub starszy IC. Aby osoba znalazła się w wynikach wyszukiwania, wystarczy dopasowanie do 1 z dodanych szczebli. Dodanie większej liczby szczebli rozszerza wyniki wyszukiwania. Wyszukiwanie zwraca wyniki tylko na podstawie obecnego stanowiska, więc wyszukiwanie pracowników na poziomie Director zwraca wyłącznie osoby, które obecnie mają stanowisko na poziomie Director. Jeśli ktoś był wcześniej dyrektorem, ale obecnie jest VP, nie znajdzie się w wynikach. Użyj tego parametru razem z parametrem person_titles[], aby znajdować osoby według konkretnych funkcji i szczebli stanowisk. Dla tego parametru dostępne są następujące opcje: owner founder c_suite partner vp head director manager senior entry intern
- Typ: array string[]person
_titles[] Stanowiska zajmowane przez osoby, które chcesz znaleźć. Aby osoba znalazła się w wynikach wyszukiwania, wystarczy dopasowanie do 1 z dodanych stanowisk. Dodanie większej liczby stanowisk rozszerza wyniki wyszukiwania. Wyniki obejmują także stanowiska zawierające te same wyrazy, nawet jeśli nie są dokładnym dopasowaniem. Na przykład wyszukiwanie marketing manager może zwrócić osoby ze stanowiskiem content marketing manager. Użyj tego parametru razem z parametrem person_seniorities[], aby znajdować osoby według konkretnych funkcji i szczebli stanowisk. Przykłady: sales development representative; marketing manager; research analyst
- Typ: stringq
_keywords Ciąg słów, według którego filtrujemy wyniki.
- Typ: array string[]q
_organization _domains _list[] Nazwa domeny pracodawcy osoby. Może to być obecny lub poprzedni pracodawca. Nie podawaj www., symbolu @ ani podobnych. Ten parametr przyjmuje do 1000 domen w jednym żądaniu. Przykłady: apollo.io; microsoft.com
- Typ: array string[]q
_organization _job _titles[] Stanowiska wymienione w aktywnych ofertach pracy u obecnego pracodawcy osoby. Przykłady: sales manager; research analyst
- Typ: integerrevenue
_range[max] Maksymalny przychód generowany przez obecnego pracodawcę osoby. Użyj tego parametru razem z revenue_range[min], aby ustawić zakres przychodów. Nie wpisuj w liczbie symboli walut, przecinków ani kropek dziesiętnych. Przykłady: 500000; 1500000
- Typ: integerrevenue
_range[min] Minimalny przychód generowany przez obecnego pracodawcę osoby. Użyj tego parametru razem z revenue_range[max], aby ustawić zakres przychodów. Nie wpisuj w liczbie symboli walut, przecinków ani kropek dziesiętnych. Przykłady: 500000; 1500000
- Typ: object200
Pomyślna odpowiedź
- Typ: array string[]people
Tablica odpowiedzi
- Typ: integertotal
_entries Pole odpowiedzi
application/json - 400
Nie można przetworzyć żądania. Sprawdź parametry żądania.
- 401
Wymagany jest prawidłowy klucz API Felo.
- 402
Nie można kontynuować żądania, ponieważ nie spełniono wymogu rozliczeniowego.
- 403
Konto nie ma uprawnień do wykonania tej operacji.
- 429
Osiągnięto limit żądań lub wydatków.
- 502
Usługa nie mogła ukończyć żądania.
- 503
API lub usługa rozliczeniowa jest tymczasowo niedostępna.
- 504
Upłynął limit czasu usługi podczas przetwarzania żądania.
- default
Odpowiedź błędu; odpowiedzi przekazywane bezpośrednio od dostawcy upstream mogą używać formatów dostawcy
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"
]
}