Apollo
Person and company enrichment, people search, company job postings and news. Requires Felo administrative permission.
Vyhledávání v People API
Vyhledává osoby odpovídající kritériím, místo aby obohacovalo někoho, koho jste již identifikovali. Filtrujte podle pracovní pozice, seniority, lokality, domény společnosti, počtu zaměstnanců a odvětví a stránkujte pomocí page a per_page. Vrací total_entries a pole people. Všimněte si, co vyhledávání záměrně nezveřejňuje: záznamy nesou last_name_obfuscated a logické příznaky — has_email, has_direct_phone, has_city, has_state, has_country — místo samotných hodnot. Vyhledávání říká, že shoda existuje; obohacení odhalí kontaktní údaje. Předejte ID do post_apollo_people_match nebo post_apollo_people_bulk_match, abyste získali e-maily a telefonní čísla — tam se také spotřebovávají kredity. Vyžaduje administrátorské oprávnění Felo.
Referenční údaje o cenách
- Měření: pevná nákladová základna za úspěšný požadavek.
- Referenční odhad požadavku: USD 0.012.
Pouze referenční metadata — nejde o nabídku pro účet, garantovanou cenu ani limit útraty. Kredity prostředků nejsou kredity Felo. Konečné účtování se řídí fakturačními záznamy Felo.
- Typ: array string[]contact
_email _status[] E-mailové statusy osob, které chcete najít. Přidáním více statusů rozšíříte vyhledávání. Prohledávatelné statusy: verified unverified likely to engage unavailable
- Typ: array string[]currently
_not _using _any _of _technology _uids[] Vyloučí osoby z vyhledávání podle kterékoli z technologií, které používá jejich současný zaměstnavatel. Apollo podporuje filtrování podle více než 1500 technologií. Apollo vypočítává data o technologiích z více zdrojů. Tato data se pravidelně aktualizují. Úplný seznam podporovaných technologií získáte stažením tohoto souboru CSV. U technologií uvedených v souboru CSV nahraďte mezery a tečky podtržítky (_). Příklady: salesforce; google_analytics; wordpress_org
- Typ: array string[]currently
_using _all _of _technology _uids[] Najde osoby podle všech technologií, které používá jejich současný zaměstnavatel. Apollo podporuje filtrování podle více než 1500 technologií. Apollo vypočítává data o technologiích z více zdrojů. Tato data se pravidelně aktualizují. Úplný seznam podporovaných technologií získáte stažením tohoto souboru CSV. U technologií uvedených v souboru CSV nahraďte mezery a tečky podtržítky (_). Příklady: salesforce; google_analytics; wordpress_org
- Typ: array string[]currently
_using _any _of _technology _uids[] Najde osoby podle kterékoli z technologií, které používá jejich současný zaměstnavatel. Apollo podporuje filtrování podle více než 1500 technologií. Apollo vypočítává data o technologiích z více zdrojů. Tato data se pravidelně aktualizují. Úplný seznam podporovaných technologií získáte stažením tohoto souboru CSV. U technologií uvedených v souboru CSV nahraďte mezery a tečky podtržítky (_). Příklady: salesforce; google_analytics; wordpress_org
- Typ: booleaninclude
_similar _titles Tento parametr určuje, zda se v odpovědi vrací osoby s pracovními pozicemi podobnými k pozicím, které zadáte v parametru person_titles[]. Při použití person_titles[] k vrácení pouze striktních shod pracovních pozic nastavte tento parametr na false.
- Typ: array string[]organization
_ids[] ID Apollo společností (zaměstnavatelů), které chcete zahrnout do výsledků vyhledávání. Každé společnosti v databázi Apollo je přiřazeno jedinečné ID. ID najdete voláním endpointu Organization Search a zjištěním hodnot organization_id. Příklad: 5e66b6381e05b4008c8331b8
- Typ: array string[]organization
_job _locations[] Lokality pracovních míst, na která zaměstnavatel osoby aktivně nabírá. Příklady: atlanta; japan
- Typ: stringorganization
_job _posted _at _range[max] Nejzazší datum, kdy současný zaměstnavatel osoby zveřejnil pracovní nabídky. Tento parametr použijte společně s organization_job_posted_at_range[min] k nastavení rozsahu dat zveřejnění nabídek. Příklad: 2025-09-25
- Typ: stringorganization
_job _posted _at _range[min] Nejčasnější datum, kdy současný zaměstnavatel osoby zveřejnil pracovní nabídky. Tento parametr použijte společně s organization_job_posted_at_range[max] k nastavení rozsahu dat zveřejnění nabídek. Příklad: 2025-07-25
- Typ: array string[]organization
_locations[] Lokalita sídla společnosti, která je současným zaměstnavatelem osoby. Můžete prohledávat města, státy USA a země. Má-li společnost několik poboček, výsledky se stále řídí lokalitou sídla. Pokud například hledáte chicago, ale sídlo společnosti je v boston, osoby pracující pro bostonskou společnost se ve výsledcích neobjeví, i když odpovídají ostatním parametrům. Chcete-li najít osoby podle jejich osobní lokality, použijte parametr person_locations. Příklady: texas; tokyo; spain
- Typ: array string[]organization
_num _employees _ranges[] Rozsah počtu zaměstnanců pracujících v současné společnosti dané osoby. Umožňuje najít osoby podle počtu zaměstnanců jejich zaměstnavatele. Přidáním více rozsahů rozšíříte výsledky vyhledávání. Každý přidaný rozsah musí být řetězec, v němž jsou horní a dolní číslo rozsahu oddělena pouze čárkou. Příklady: 1,10; 250,500; 10000,20000
- Typ: integerorganization
_num _jobs _range[max] Maximální počet aktivních pracovních nabídek u současného zaměstnavatele osoby. Tento parametr použijte společně s organization_num_jobs_range[min] k nastavení rozsahu pracovních nabídek. Příklady: 50; 500
- Typ: integerorganization
_num _jobs _range[min] Minimální počet aktivních pracovních nabídek u současného zaměstnavatele osoby. Tento parametr použijte společně s organization_num_jobs_range[max] k nastavení rozsahu pracovních nabídek. Příklady: 50; 500
- Typ: integerpage
Číslo stránky dat Apollo, kterou chcete načíst. Tento parametr použijte společně s parametrem per_page, aby byla navigace ve výsledcích vyhledávání snazší a abyste zlepšili výkon endpointu. Příklad: 4
- Typ: integerper
_page Počet výsledků vyhledávání, které se mají vrátit na každé stránce. Omezení počtu výsledků na stránku zlepšuje výkon endpointu. Pomocí parametru page procházejte jednotlivé stránky dat. Příklad: 10
- Typ: array string[]person
_locations[] Lokalita, kde osoby žijí. Můžete prohledávat města, státy USA a země. Chcete-li najít osoby podle sídel jejich současného zaměstnavatele, použijte parametr organization_locations. Příklady: california; ireland; chicago
- Typ: array string[]person
_seniorities[] Pracovní seniorita, kterou osoby zastávají u svého současného zaměstnavatele. Umožňuje najít osoby, které aktuálně zastávají pozice na určitých úrovních reportingu, například na úrovni Director nebo senior IC. Aby byla osoba zahrnuta do výsledků vyhledávání, stačí, když odpovídá 1 z přidaných seniorit. Přidání dalších seniorit rozšiřuje výsledky vyhledávání. Vyhledávání vrací výsledky pouze podle současné pracovní pozice, takže hledání zaměstnanců na úrovni Director vrací jen osoby, které aktuálně zastávají pozici na úrovni Director. Pokud někdo byl dříve ředitelem, ale nyní je VP, nebude do výsledků zahrnut. Tento parametr použijte společně s parametrem person_titles[] k nalezení osob podle konkrétních pracovních funkcí a úrovní seniority. Pro tento parametr lze použít následující možnosti: owner founder c_suite partner vp head director manager senior entry intern
- Typ: array string[]person
_titles[] Pracovní pozice, které zastávají osoby, jež chcete najít. Aby byla osoba zahrnuta do výsledků vyhledávání, stačí, když odpovídá 1 z přidaných pozic. Přidání dalších pozic rozšiřuje výsledky vyhledávání. Výsledky zahrnují i pozice se stejnými výrazy, i když nejde o přesnou shodu. Například hledání marketing manager může vrátit osoby s pozicí content marketing manager. Tento parametr použijte společně s parametrem person_seniorities[] k nalezení osob podle konkrétních pracovních funkcí a úrovní seniority. Příklady: sales development representative; marketing manager; research analyst
- Typ: stringq
_keywords Řetězec slov, podle kterého chceme filtrovat výsledky.
- Typ: array string[]q
_organization _domains _list[] Název domény zaměstnavatele osoby. Může jít o současného nebo předchozího zaměstnavatele. Neuvádějte www., symbol @ ani podobné. Tento parametr přijímá až 1 000 domén v jednom požadavku. Příklady: apollo.io; microsoft.com
- Typ: array string[]q
_organization _job _titles[] Pracovní pozice uvedené v aktivních pracovních nabídkách u současného zaměstnavatele osoby. Příklady: sales manager; research analyst
- Typ: integerrevenue
_range[max] Maximální příjem, který generuje současný zaměstnavatel osoby. Tento parametr použijte společně s revenue_range[min] k nastavení rozsahu příjmů. Do čísla neuvádějte symboly měn, čárky ani desetinné tečky. Příklady: 500000; 1500000
- Typ: integerrevenue
_range[min] Minimální příjem, který generuje současný zaměstnavatel osoby. Tento parametr použijte společně s revenue_range[max] k nastavení rozsahu příjmů. Do čísla neuvádějte symboly měn, čárky ani desetinné tečky. Příklady: 500000; 1500000
- Typ: object200
Úspěšná odpověď
- Typ: array string[]people
Array odpovědi
- Typ: integertotal
_entries Pole odpovědi
application/json - 400
Požadavek se nepodařilo zpracovat. Zkontrolujte parametry požadavku.
- 401
Je vyžadován platný API klíč Felo.
- 402
V požadavku nelze pokračovat, protože není splněn požadavek na fakturaci.
- 403
Účet nemá oprávnění tuto operaci provést.
- 429
Byl dosažen limit požadavků nebo útraty.
- 502
Služba nemohla požadavek dokončit.
- 503
API nebo fakturační služba je dočasně nedostupná.
- 504
Při zpracování požadavku vypršel časový limit služby.
- default
Chybová odpověď; odpovědi předávané přímo od upstream poskytovatele mohou používat formáty poskytovatele
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"
]
}