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
Ответ с ошибкой; сквозные ответы upstream могут использовать форматы провайдера
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"
]
}