Apollo
Поиск, обогащение и CRM-записи Apollo.io в процессах Pailot
Apollo.io — база контактов и компаний для продаж: поиск, обогащение и CRM (Customer Relationship Management — учёт клиентов). Блок ходит в API (Application Programming Interface — программный интерфейс) по ключу.
С Apollo в Pailot вы можете:
- Искать людей и организации по должности, локации, компании и ключевым словам
- Обогащать карточку человека или компании (в том числе пакетом до 10)
- Создавать и обновлять контакты, аккаунты и сделки; массовые операции требуют master key
- Добавлять контакты в sequence (цепочку писем) и создавать задачи
Нужен ключ API Apollo; для массовых операций и части инструментов — master key. Раскрытие личных email и телефонов расходует кредиты. Блок ставят на холст как отдельный шаг или прикрепляют к агенту. Ключ — в переменных окружения рабочего пространства.
Поиск людей в базе Apollo.
| Параметр | Тип | Обязательный | Описание |
|---|
apiKey | string | Да | Ключ API Apollo |
person_titles | array | Нет | Должности (например, ["CEO", "VP of Sales"]) |
person_locations | array | Нет | Локации (например, ["San Francisco, CA", "New York, NY"]) |
person_seniorities | array | Нет | Уровни (например, ["senior", "executive", "manager"]) |
organization_names | array | Нет | Названия компаний |
q_keywords | string | Нет | Ключевые слова |
page | number | Нет | Номер страницы (по умолчанию 1) |
per_page | number | Нет | Результатов на страницу (по умолчанию 25, максимум 100) |
| Параметр | Тип | Описание |
|---|
people | json | Массив людей по критериям |
page | number | Текущая страница |
per_page | number | Результатов на страницу |
total_entries | number | Всего совпадений |
Обогатить карточку одного человека.
| Параметр | Тип | Обязательный | Описание |
|---|
apiKey | string | Да | Ключ API Apollo |
first_name | string | Нет | Имя |
last_name | string | Нет | Фамилия |
email | string | Нет | Адрес электронной почты |
organization_name | string | Нет | Компания |
domain | string | Нет | Домен компании (например, apollo.io) |
linkedin_url | string | Нет | URL профиля LinkedIn |
reveal_personal_emails | boolean | Нет | Показать личные email (списывает кредиты) |
reveal_phone_number | boolean | Нет | Показать телефоны (списывает кредиты) |
| Параметр | Тип | Описание |
|---|
person | json | Обогащённые данные человека |
enriched | boolean | Карточку удалось обогатить |
Обогатить до 10 человек за один запрос.
| Параметр | Тип | Обязательный | Описание |
|---|
apiKey | string | Да | Ключ API Apollo |
people | array | Да | Массив людей (максимум 10) |
reveal_personal_emails | boolean | Нет | Показать личные email (списывает кредиты) |
reveal_phone_number | boolean | Нет | Показать телефоны (списывает кредиты) |
| Параметр | Тип | Описание |
|---|
people | json | Массив обогащённых карточек |
total | number | Сколько человек обработано |
enriched | number | Сколько карточек обогащено |
Поиск организаций в базе Apollo.
| Параметр | Тип | Обязательный | Описание |
|---|
apiKey | string | Да | Ключ API Apollo |
organization_locations | array | Нет | Локации компаний |
organization_num_employees_ranges | array | Нет | Диапазоны численности (например, ["1-10", "11-50"]) |
q_organization_keyword_tags | array | Нет | Отраслевые или ключевые теги |
q_organization_name | string | Нет | Название организации |
page | number | Нет | Номер страницы |
per_page | number | Нет | Результатов на страницу (максимум 100) |
| Параметр | Тип | Описание |
|---|
organizations | json | Массив организаций по критериям |
page | number | Текущая страница |
per_page | number | Результатов на страницу |
total_entries | number | Всего совпадений |
Обогатить карточку одной организации.
| Параметр | Тип | Обязательный | Описание |
|---|
apiKey | string | Да | Ключ API Apollo |
organization_name | string | Нет | Название организации (нужно имя или домен) |
domain | string | Нет | Домен компании (например, apollo.io; нужно имя или домен) |
| Параметр | Тип | Описание |
|---|
organization | json | Обогащённые данные организации |
enriched | boolean | Карточку удалось обогатить |
Обогатить до 10 организаций за один запрос.
| Параметр | Тип | Обязательный | Описание |
|---|
apiKey | string | Да | Ключ API Apollo |
organizations | array | Да | Массив организаций (максимум 10) |
| Параметр | Тип | Описание |
|---|
organizations | json | Массив обогащённых организаций |
total | number | Сколько организаций обработано |
enriched | number | Сколько карточек обогащено |
Создать контакт в базе Apollo.
| Параметр | Тип | Обязательный | Описание |
|---|
apiKey | string | Да | Ключ API Apollo |
first_name | string | Да | Имя контакта |
last_name | string | Да | Фамилия контакта |
email | string | Нет | Адрес электронной почты |
title | string | Нет | Должность |
account_id | string | Нет | ID аккаунта Apollo |
owner_id | string | Нет | ID владельца контакта |
| Параметр | Тип | Описание |
|---|
contact | json | Созданный контакт |
created | boolean | Контакт создан |
Обновить существующий контакт.
| Параметр | Тип | Обязательный | Описание |
|---|
apiKey | string | Да | Ключ API Apollo |
contact_id | string | Да | ID контакта |
first_name | string | Нет | Имя |
last_name | string | Нет | Фамилия |
email | string | Нет | Адрес электронной почты |
title | string | Нет | Должность |
account_id | string | Нет | ID аккаунта Apollo |
owner_id | string | Нет | ID владельца контакта |
| Параметр | Тип | Описание |
|---|
contact | json | Обновлённый контакт |
updated | boolean | Контакт обновлён |
Поиск контактов команды.
| Параметр | Тип | Обязательный | Описание |
|---|
apiKey | string | Да | Ключ API Apollo |
q_keywords | string | Нет | Ключевые слова |
contact_stage_ids | array | Нет | Фильтр по ID этапов контакта |
page | number | Нет | Номер страницы |
per_page | number | Нет | Результатов на страницу (максимум 100) |
| Параметр | Тип | Описание |
|---|
contacts | json | Массив контактов по критериям |
pagination | json | Данные постраничного вывода |
Создать до 100 контактов. Можно включить дедупликацию. Нужен master key.
| Параметр | Тип | Обязательный | Описание |
|---|
apiKey | string | Да | Ключ API Apollo (нужен master key) |
contacts | array | Да | Массив контактов (максимум 100). У каждого — first_name, last_name; по желанию email, title, account_id, owner_id |
run_dedupe | boolean | Нет | Дедупликация: существующие контакты вернут без изменений |
| Параметр | Тип | Описание |
|---|
created_contacts | json | Новые контакты |
existing_contacts | json | Уже существующие контакты (если включена дедупликация) |
total_submitted | number | Сколько контактов отправили |
created | number | Сколько контактов создано |
existing | number | Сколько уже существовало |
Обновить до 100 контактов. У каждого нужен id. Нужен master key.
| Параметр | Тип | Обязательный | Описание |
|---|
apiKey | string | Да | Ключ API Apollo (нужен master key) |
contacts | array | Да | Массив контактов (максимум 100). У каждого — id; по желанию first_name, last_name, email, title, account_id, owner_id |
| Параметр | Тип | Описание |
|---|
updated_contacts | json | Успешно обновлённые контакты |
failed_contacts | json | Контакты, которые не удалось обновить |
total_submitted | number | Сколько контактов отправили |
updated | number | Сколько обновлено |
failed | number | Сколько не удалось обновить |
Создать аккаунт (компанию) в базе Apollo.
| Параметр | Тип | Обязательный | Описание |
|---|
apiKey | string | Да | Ключ API Apollo |
name | string | Да | Название компании |
website_url | string | Нет | Сайт компании |
phone | string | Нет | Телефон компании |
owner_id | string | Нет | ID владельца аккаунта |
| Параметр | Тип | Описание |
|---|
account | json | Созданный аккаунт |
created | boolean | Аккаунт создан |
Обновить существующий аккаунт.
| Параметр | Тип | Обязательный | Описание |
|---|
apiKey | string | Да | Ключ API Apollo |
account_id | string | Да | ID аккаунта |
name | string | Нет | Название компании |
website_url | string | Нет | Сайт компании |
phone | string | Нет | Телефон компании |
owner_id | string | Нет | ID владельца аккаунта |
| Параметр | Тип | Описание |
|---|
account | json | Обновлённый аккаунт |
updated | boolean | Аккаунт обновлён |
Поиск аккаунтов команды.
| Параметр | Тип | Обязательный | Описание |
|---|
apiKey | string | Да | Ключ API Apollo (нужен master key) |
q_keywords | string | Нет | Ключевые слова по данным аккаунта |
owner_id | string | Нет | Фильтр по ID владельца |
account_stage_ids | array | Нет | Фильтр по ID этапов аккаунта |
page | number | Нет | Номер страницы |
per_page | number | Нет | Результатов на страницу (максимум 100) |
| Параметр | Тип | Описание |
|---|
accounts | json | Массив аккаунтов по критериям |
pagination | json | Данные постраничного вывода |
Создать до 100 аккаунтов. Дедупликации у Apollo нет: похожие имена и домены могут дать дубликаты. Нужен master key.
| Параметр | Тип | Обязательный | Описание |
|---|
apiKey | string | Да | Ключ API Apollo (нужен master key) |
accounts | array | Да | Массив аккаунтов (максимум 100). У каждого — name (обязательно); по желанию website_url, phone, owner_id |
| Параметр | Тип | Описание |
|---|
created_accounts | json | Новые аккаунты |
failed_accounts | json | Аккаунты, которые не удалось создать |
total_submitted | number | Сколько аккаунтов отправили |
created | number | Сколько создано |
failed | number | Сколько не удалось создать |
Обновить до 1000 аккаунтов (лимит выше, чем у контактов). У каждого нужен id. Нужен master key.
| Параметр | Тип | Обязательный | Описание |
|---|
apiKey | string | Да | Ключ API Apollo (нужен master key) |
accounts | array | Да | Массив аккаунтов (максимум 1000). У каждого — id; по желанию name, website_url, phone, owner_id |
| Параметр | Тип | Описание |
|---|
updated_accounts | json | Успешно обновлённые аккаунты |
failed_accounts | json | Аккаунты, которые не удалось обновить |
total_submitted | number | Сколько аккаунтов отправили |
updated | number | Сколько обновлено |
failed | number | Сколько не удалось обновить |
Создать сделку по аккаунту. Нужен master key.
| Параметр | Тип | Обязательный | Описание |
|---|
apiKey | string | Да | Ключ API Apollo (нужен master key) |
name | string | Да | Название сделки |
account_id | string | Да | ID аккаунта сделки |
amount | number | Нет | Сумма сделки |
stage_id | string | Нет | ID этапа сделки |
owner_id | string | Нет | ID владельца сделки |
close_date | string | Нет | Ожидаемая дата закрытия (ISO 8601) |
description | string | Нет | Описание или заметки |
| Параметр | Тип | Описание |
|---|
opportunity | json | Созданная сделка |
created | boolean | Сделка создана |
Поиск сделок команды.
| Параметр | Тип | Обязательный | Описание |
|---|
apiKey | string | Да | Ключ API Apollo |
q_keywords | string | Нет | Ключевые слова по названиям сделок |
account_ids | array | Нет | Фильтр по ID аккаунтов |
stage_ids | array | Нет | Фильтр по ID этапов |
owner_ids | array | Нет | Фильтр по ID владельцев |
page | number | Нет | Номер страницы |
per_page | number | Нет | Результатов на страницу (максимум 100) |
| Параметр | Тип | Описание |
|---|
opportunities | json | Массив сделок по критериям |
page | number | Текущая страница |
per_page | number | Результатов на страницу |
total_entries | number | Всего совпадений |
Карточка сделки по ID.
| Параметр | Тип | Обязательный | Описание |
|---|
apiKey | string | Да | Ключ API Apollo |
opportunity_id | string | Да | ID сделки |
| Параметр | Тип | Описание |
|---|
opportunity | json | Полные данные сделки |
found | boolean | Сделка найдена |
Обновить существующую сделку.
| Параметр | Тип | Обязательный | Описание |
|---|
apiKey | string | Да | Ключ API Apollo |
opportunity_id | string | Да | ID сделки |
name | string | Нет | Название сделки |
amount | number | Нет | Сумма сделки |
stage_id | string | Нет | ID этапа сделки |
owner_id | string | Нет | ID владельца сделки |
close_date | string | Нет | Ожидаемая дата закрытия (ISO 8601) |
description | string | Нет | Описание или заметки |
| Параметр | Тип | Описание |
|---|
opportunity | json | Обновлённая сделка |
updated | boolean | Сделка обновлена |
Поиск цепочек писем (sequences) команды.
| Параметр | Тип | Обязательный | Описание |
|---|
apiKey | string | Да | Ключ API Apollo (нужен master key) |
q_name | string | Нет | Поиск цепочек по названию |
active | boolean | Нет | Фильтр: true — активные, false — неактивные |
page | number | Нет | Номер страницы |
per_page | number | Нет | Результатов на страницу (максимум 100) |
| Параметр | Тип | Описание |
|---|
sequences | json | Массив цепочек по критериям |
page | number | Текущая страница |
per_page | number | Результатов на страницу |
total_entries | number | Всего совпадений |
Добавить контакты в цепочку писем Apollo.
| Параметр | Тип | Обязательный | Описание |
|---|
apiKey | string | Да | Ключ API Apollo (нужен master key) |
sequence_id | string | Да | ID цепочки |
contact_ids | array | Да | Массив ID контактов |
emailer_campaign_id | string | Нет | Необязательный ID email-кампании |
send_email_from_user_id | string | Нет | ID пользователя, от чьего имени слать письма |
| Параметр | Тип | Описание |
|---|
contacts_added | json | ID добавленных контактов |
sequence_id | string | ID цепочки |
total_added | number | Сколько контактов добавлено |
Создать задачу в Apollo.
| Параметр | Тип | Обязательный | Описание |
|---|
apiKey | string | Да | Ключ API Apollo (нужен master key) |
note | string | Да | Текст задачи |
contact_id | string | Нет | ID связанного контакта |
account_id | string | Нет | ID связанного аккаунта |
due_at | string | Нет | Срок в формате ISO |
priority | string | Нет | Приоритет |
type | string | Нет | Тип задачи |
| Параметр | Тип | Описание |
|---|
task | json | Созданная задача |
created | boolean | Задача создана |
Поиск задач в Apollo.
| Параметр | Тип | Обязательный | Описание |
|---|
apiKey | string | Да | Ключ API Apollo (нужен master key) |
contact_id | string | Нет | Фильтр по ID контакта |
account_id | string | Нет | Фильтр по ID аккаунта |
completed | boolean | Нет | Фильтр по завершённости |
page | number | Нет | Номер страницы |
per_page | number | Нет | Результатов на страницу (максимум 100) |
| Параметр | Тип | Описание |
|---|
tasks | json | Массив задач по критериям |
pagination | json | Данные постраничного вывода |
Список почтовых ящиков команды, привязанных в Apollo.
| Параметр | Тип | Обязательный | Описание |
|---|
apiKey | string | Да | Ключ API Apollo (нужен master key) |
| Параметр | Тип | Описание |
|---|
email_accounts | json | Массив почтовых ящиков команды |
total | number | Всего ящиков |