# Поиск людей через People API

**API:** Data API

**Endpoint:** `POST /v1/beta/apollo/mixed_people/api_search`

**Tags:** Apollo

Находит людей по критериям, а не обогащает уже известного человека. Фильтруйте по должности, уровню, местоположению, домену компании, численности и отрасли, листайте с помощью `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.

## Base URL

- `https://openapi.felo.ai`

## Authentication

- `FeloBearerAuth` (http bearer, bearer format Felo API Key)
- `FeloApiKey` (apiKey in header `X-API-Key`)

## Parameters

| Name | In | Required | Type | Description |
| --- | --- | --- | --- | --- |
| `contact_email_status[]` | query | no | array | Статусы email для людей, которых вы хотите найти. Можно добавить несколько статусов, чтобы расширить поиск. Доступные для поиска статусы: verified unverified likely to engage unavailable |
| `currently_not_using_any_of_technology_uids[]` | query | no | array | Исключает из поиска людей, если их текущий работодатель использует любую из указанных технологий. Apollo поддерживает фильтрацию по 1,500+ технологиям. Apollo рассчитывает данные о технологиях из нескольких источников. Эти данные регулярно обновляются. Полный список поддерживаемых технологий можно получить, скачав этот CSV-файл. Для технологий из CSV-файла заменяйте пробелы и точки подчёркиваниями (_). Примеры: salesforce; google_analytics; wordpress_org |
| `currently_using_all_of_technology_uids[]` | query | no | array | Находит людей по всем технологиям, которые использует их текущий работодатель. Apollo поддерживает фильтрацию по 1,500+ технологиям. Apollo рассчитывает данные о технологиях из нескольких источников. Эти данные регулярно обновляются. Полный список поддерживаемых технологий можно получить, скачав этот CSV-файл. Для технологий из CSV-файла заменяйте пробелы и точки подчёркиваниями (_). Примеры: salesforce; google_analytics; wordpress_org |
| `currently_using_any_of_technology_uids[]` | query | no | array | Находит людей, если их текущий работодатель использует любую из указанных технологий. Apollo поддерживает фильтрацию по 1,500+ технологиям. Apollo рассчитывает данные о технологиях из нескольких источников. Эти данные регулярно обновляются. Полный список поддерживаемых технологий можно получить, скачав этот CSV-файл. Для технологий из CSV-файла заменяйте пробелы и точки подчёркиваниями (_). Примеры: salesforce; google_analytics; wordpress_org |
| `include_similar_titles` | query | no | boolean | Этот параметр определяет, попадут ли в ответ люди с должностями, похожими на указанные в параметре person_titles[]. Установите этот параметр в false, чтобы person_titles[] возвращал только строгие совпадения должностей. |
| `organization_ids[]` | query | no | array | Apollo ID компаний (работодателей), которые нужно включить в результаты поиска. Каждой компании в базе Apollo присваивается уникальный ID. Чтобы найти ID, вызовите эндпоинт Organization Search и определите значения organization_id. Пример: 5e66b6381e05b4008c8331b8 |
| `organization_job_locations[]` | query | no | array | Местоположения вакансий, которые активно набирает работодатель человека. Примеры: atlanta; japan |
| `organization_job_posted_at_range[max]` | query | no | string | Самая поздняя дата публикации вакансий текущим работодателем человека. Используйте этот параметр вместе с organization_job_posted_at_range[min], чтобы задать диапазон дат публикации. Пример: 2025-09-25 |
| `organization_job_posted_at_range[min]` | query | no | string | Самая ранняя дата публикации вакансий текущим работодателем человека. Используйте этот параметр вместе с organization_job_posted_at_range[max], чтобы задать диапазон дат публикации. Пример: 2025-07-25 |
| `organization_locations[]` | query | no | array | Местоположение головного офиса текущего работодателя человека. Можно искать по городам, штатам США и странам. Если у компании несколько офисов, результаты всё равно определяются местоположением головного офиса. Например, если искать chicago, а головной офис компании находится в boston, сотрудники бостонской компании не попадут в результаты, даже если соответствуют другим параметрам. Чтобы искать людей по их личному местоположению, используйте параметр person_locations. Примеры: texas; tokyo; spain |
| `organization_num_employees_ranges[]` | query | no | array | Диапазон численности сотрудников текущей компании человека. Позволяет находить людей по численности сотрудников работодателя. Можно добавить несколько диапазонов, чтобы расширить результаты поиска. Каждый диапазон должен быть строкой, в которой верхнее и нижнее числа разделены только запятой. Примеры: 1,10; 250,500; 10000,20000 |
| `organization_num_jobs_range[max]` | query | no | integer | Максимальное число активных вакансий у текущего работодателя человека. Используйте этот параметр вместе с organization_num_jobs_range[min], чтобы задать диапазон вакансий. Примеры: 50; 500 |
| `organization_num_jobs_range[min]` | query | no | integer | Минимальное число активных вакансий у текущего работодателя человека. Используйте этот параметр вместе с organization_num_jobs_range[max], чтобы задать диапазон вакансий. Примеры: 50; 500 |
| `page` | query | no | integer | Номер страницы данных Apollo, которые нужно получить. Используйте этот параметр вместе с per_page, чтобы сделать результаты поиска доступными для навигации и повысить производительность эндпоинта. Пример: 4 |
| `per_page` | query | no | integer | Число результатов поиска на страницу. Ограничение числа результатов на страницу повышает производительность эндпоинта. Используйте параметр page, чтобы переходить между страницами данных. Пример: 10 |
| `person_locations[]` | query | no | array | Местоположение, где живут люди. Можно искать по городам, штатам США и странам. Чтобы найти людей по местоположению головного офиса их текущего работодателя, используйте параметр organization_locations. Примеры: california; ireland; chicago |
| `person_seniorities[]` | query | no | array | Должностной уровень, который люди занимают у текущего работодателя. Позволяет находить людей, которые сейчас занимают позиции определённого уровня подчинения, например Director level или senior IC level. Чтобы человек попал в результаты поиска, достаточно совпадения с одним из добавленных уровней. Чем больше уровней добавлено, тем шире результаты. Поиск учитывает только текущую должность, поэтому поиск сотрудников уровня Director возвращает только тех, у кого сейчас должность уровня Director. Если человек раньше был Director, а сейчас VP, он не попадёт в результаты. Используйте этот параметр вместе с person_titles[], чтобы искать по конкретным функциям и уровням. Для этого параметра доступны следующие значения: owner founder c_suite partner vp head director manager senior entry intern |
| `person_titles[]` | query | no | array | Должности людей, которых вы хотите найти. Чтобы человек попал в результаты поиска, достаточно совпадения с одной из добавленных должностей. Чем больше должностей добавлено, тем шире результаты. В результаты также попадают должности с теми же словами, даже если совпадение не точное. Например, по запросу marketing manager могут найтись люди с должностью content marketing manager. Используйте этот параметр вместе с person_seniorities[], чтобы искать по конкретным функциям и уровням. Примеры: sales development representative; marketing manager; research analyst |
| `q_keywords` | query | no | string | Строка слов, по которой нужно отфильтровать результаты. |
| `q_organization_domains_list[]` | query | no | array | Домен работодателя человека. Это может быть текущий или предыдущий работодатель. Не указывайте www., символ @ и подобное. Параметр принимает до 1 000 доменов в одном запросе. Примеры: apollo.io; microsoft.com |
| `q_organization_job_titles[]` | query | no | array | Должности, указанные в активных вакансиях текущего работодателя человека. Примеры: sales manager; research analyst |
| `revenue_range[max]` | query | no | integer | Максимальная выручка текущего работодателя человека. Используйте этот параметр вместе с revenue_range[min], чтобы задать диапазон выручки. Не вводите в число символы валют, запятые и десятичные точки. Примеры: 500000; 1500000 |
| `revenue_range[min]` | query | no | integer | Минимальная выручка текущего работодателя человека. Используйте этот параметр вместе с revenue_range[max], чтобы задать диапазон выручки. Не вводите в число символы валют, запятые и десятичные точки. Примеры: 500000; 1500000 |

## Responses

### 200 — Успешный ответ

Headers:
- `X-Request-Id` (string) — Идентификатор запроса, который нужно указать при обращении в поддержку Felo.

**application/json**

Schema: object

```json
{
  "type": "object",
  "properties": {
    "total_entries": {
      "type": "integer",
      "description": "Поле ответа"
    },
    "people": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Массив ответа"
    }
  }
}
```

### 400 — Запрос не удалось обработать. Проверьте параметры запроса.

### 401 — Требуется действительный API-ключ Felo.

### 402 — Запрос не может быть выполнен: не выполнено требование биллинга.

### 403 — Аккаунту не разрешено выполнять эту операцию.

### 429 — Достигнут лимит запросов или расходов.

### 502 — Сервис не смог выполнить запрос.

### 503 — API или сервис биллинга временно недоступны.

### 504 — Истекло время ожидания обработки запроса.

### default — Ответ с ошибкой; сквозные ответы upstream могут использовать форматы провайдера

**application/json**

Schema:

```json
{}
```