Apollo
Person and company enrichment, people search, company job postings and news. Requires Felo administrative permission.
Пошук людей у People API
Знаходить людей за критеріями, а не збагачує вже відому особу. Фільтруйте за посадою, рівнем, місцезнаходженням, доменом компанії, чисельністю та галуззю, гортайте за допомогою page і per_page. Повертає total_entries і масив people. Зверніть увагу, що пошук навмисно приховує: записи містять last_name_obfuscated і логічні прапорці — has_email, has_direct_phone, has_city, has_state, has_country — замість самих значень. Пошук повідомляє, що збіг існує; збагачення розкриває контактні дані. Передайте id у post_apollo_people_match або post_apollo_people_bulk_match, щоб отримати email і телефони; там само витрачаються кредити. Потрібні адміністративні дозволи Felo.
Довідкові дані про ціни
- Тарифікація: фіксована базова вартість успішного запиту.
- Орієнтовна вартість запиту: USD 0.012.
Довідкові метадані, а не котирування для облікового запису, гарантована ціна чи ліміт витрат. Кредити ресурсів — це не кредити Felo. Остаточні списання здійснюються за записами білінгу Felo.
- Тип: array string[]contact
_email _status[] Статуси email для людей, яких ви хочете знайти. Можна додати кілька статусів, щоб розширити пошук. Доступні для пошуку статуси: verified unverified likely to engage unavailable
- Тип: array string[]currently
_not _using _any _of _technology _uids[] Виключає з пошуку людей, якщо їхній поточний роботодавець використовує будь-яку з указаних технологій. Apollo підтримує фільтрацію за 1,500+ технологіями. Apollo обчислює дані про технології з кількох джерел. Ці дані регулярно оновлюються. Повний список підтримуваних технологій можна отримати, завантаживши цей CSV-файл. Для технологій, наведених у CSV-файлі, замінюйте пробіли й крапки на підкреслення (_). Приклади: salesforce; google_analytics; wordpress_org
- Тип: array string[]currently
_using _all _of _technology _uids[] Знаходить людей за всіма технологіями, які використовує їхній поточний роботодавець. Apollo підтримує фільтрацію за 1,500+ технологіями. Apollo обчислює дані про технології з кількох джерел. Ці дані регулярно оновлюються. Повний список підтримуваних технологій можна отримати, завантаживши цей CSV-файл. Для технологій, наведених у CSV-файлі, замінюйте пробіли й крапки на підкреслення (_). Приклади: salesforce; google_analytics; wordpress_org
- Тип: array string[]currently
_using _any _of _technology _uids[] Знаходить людей, якщо їхній поточний роботодавець використовує будь-яку з указаних технологій. Apollo підтримує фільтрацію за 1,500+ технологіями. Apollo обчислює дані про технології з кількох джерел. Ці дані регулярно оновлюються. Повний список підтримуваних технологій можна отримати, завантаживши цей CSV-файл. Для технологій, наведених у CSV-файлі, замінюйте пробіли й крапки на підкреслення (_). Приклади: salesforce; google_analytics; wordpress_org
- Тип: booleaninclude
_similar _titles Цей параметр визначає, чи потраплять у відповідь люди з посадами, схожими на вказані в параметрі person_titles[]. Установіть цей параметр у false, щоб person_titles[] повертав лише строгі збіги посад.
- Тип: array string[]organization
_ids[] Apollo ID компаній (роботодавців), які потрібно включити в результати пошуку. Кожній компанії в базі Apollo присвоюється унікальний ID. Щоб знайти ID, викличте ендпоінт Organization Search і визначте значення organization_id. Приклад: 5e66b6381e05b4008c8331b8
- Тип: array string[]organization
_job _locations[] Місцезнаходження вакансій, які активно набирає роботодавець людини. Приклади: atlanta; japan
- Тип: stringorganization
_job _posted _at _range[max] Найпізніша дата публікації вакансій поточним роботодавцем людини. Використовуйте цей параметр разом з organization_job_posted_at_range[min], щоб задати діапазон дат публікації. Приклад: 2025-09-25
- Тип: stringorganization
_job _posted _at _range[min] Найраніша дата публікації вакансій поточним роботодавцем людини. Використовуйте цей параметр разом з organization_job_posted_at_range[max], щоб задати діапазон дат публікації. Приклад: 2025-07-25
- Тип: array string[]organization
_locations[] Місцезнаходження головного офісу поточного роботодавця людини. Можна шукати за містами, штатами США та країнами. Якщо компанія має кілька офісів, результати все одно визначаються місцезнаходженням головного офісу. Наприклад, якщо шукати chicago, а головний офіс компанії розташований у boston, співробітники бостонської компанії не потраплять у результати, навіть якщо відповідають іншим параметрам. Щоб шукати людей за їхнім особистим місцезнаходженням, використовуйте параметр person_locations. Приклади: texas; tokyo; spain
- Тип: array string[]organization
_num _employees _ranges[] Діапазон кількості співробітників поточної компанії людини. Дозволяє знаходити людей за чисельністю співробітників роботодавця. Можна додати кілька діапазонів, щоб розширити результати пошуку. Кожен діапазон має бути рядком, у якому верхнє й нижнє числа розділені лише комою. Приклади: 1,10; 250,500; 10000,20000
- Тип: integerorganization
_num _jobs _range[max] Максимальна кількість активних вакансій у поточного роботодавця людини. Використовуйте цей параметр разом з organization_num_jobs_range[min], щоб задати діапазон вакансій. Приклади: 50; 500
- Тип: integerorganization
_num _jobs _range[min] Мінімальна кількість активних вакансій у поточного роботодавця людини. Використовуйте цей параметр разом з organization_num_jobs_range[max], щоб задати діапазон вакансій. Приклади: 50; 500
- Тип: integerpage
Номер сторінки даних Apollo, які потрібно отримати. Використовуйте цей параметр разом з per_page, щоб зробити результати пошуку зручними для навігації та підвищити продуктивність ендпоінта. Приклад: 4
- Тип: integerper
_page Кількість результатів пошуку на сторінку. Обмеження кількості результатів на сторінку підвищує продуктивність ендпоінта. Використовуйте параметр page, щоб переходити між сторінками даних. Приклад: 10
- Тип: array string[]person
_locations[] Місце проживання людей. Можна шукати за містами, штатами США та країнами. Щоб знайти людей за місцезнаходженням головного офісу їхнього поточного роботодавця, використовуйте параметр organization_locations. Приклади: california; ireland; chicago
- Тип: array string[]person
_seniorities[] Посадовий рівень, який люди займають у поточного роботодавця. Дозволяє знаходити людей, які зараз обіймають посади певного рівня підпорядкування, наприклад Director level або senior IC level. Щоб людина потрапила в результати пошуку, достатньо збігу з одним із доданих рівнів. Що більше рівнів додано, то ширші результати. Пошук враховує лише поточну посаду, тому пошук співробітників рівня Director повертає лише тих, хто зараз має посаду рівня Director. Якщо людина раніше була Director, а зараз VP, вона не потрапить у результати. Використовуйте цей параметр разом з person_titles[], щоб шукати за конкретними функціями та рівнями. Для цього параметра доступні такі значення: owner founder c_suite partner vp head director manager senior entry intern
- Тип: array string[]person
_titles[] Посади людей, яких ви хочете знайти. Щоб людина потрапила в результати пошуку, достатньо збігу з однією з доданих посад. Що більше посад додано, то ширші результати. Результати також містять посади з тими самими словами, навіть якщо збіг не точний. Наприклад, за запитом marketing manager можуть знайтися люди з посадою content marketing manager. Використовуйте цей параметр разом з person_seniorities[], щоб шукати за конкретними функціями та рівнями. Приклади: sales development representative; marketing manager; research analyst
- Тип: stringq
_keywords Рядок слів, за яким потрібно відфільтрувати результати.
- Тип: array string[]q
_organization _domains _list[] Домен роботодавця людини. Це може бути поточний або попередній роботодавець. Не вказуйте www., символ @ тощо. Параметр приймає до 1 000 доменів в одному запиті. Приклади: apollo.io; microsoft.com
- Тип: array string[]q
_organization _job _titles[] Посади, указані в активних вакансіях поточного роботодавця людини. Приклади: sales manager; research analyst
- Тип: integerrevenue
_range[max] Максимальний дохід поточного роботодавця людини. Використовуйте цей параметр разом з revenue_range[min], щоб задати діапазон доходу. Не вводьте в число символи валют, коми та десяткові крапки. Приклади: 500000; 1500000
- Тип: integerrevenue
_range[min] Мінімальний дохід поточного роботодавця людини. Використовуйте цей параметр разом з revenue_range[max], щоб задати діапазон доходу. Не вводьте в число символи валют, коми та десяткові крапки. Приклади: 500000; 1500000
- Тип: object200
Успішна відповідь
- Тип: array string[]people
Масив відповіді
- Тип: integertotal
_entries Поле відповіді
application/json - 400
Не вдалося обробити запит. Перевірте параметри запиту.
- 401
Потрібен дійсний API-ключ Felo.
- 402
Запит неможливо виконати: умови білінгу не виконано.
- 403
Обліковий запис не має дозволу на цю операцію.
- 429
Досягнуто ліміту запитів або витрат.
- 502
Служба не змогла виконати запит.
- 503
API або служба білінгу тимчасово недоступні.
- 504
Час очікування обробки запиту вичерпано.
- default
Відповідь із помилкою; наскрізні відповіді апстріму можуть використовувати формати постачальника
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"
]
}