Перейти к основному содержимому
Чёрная пятница: скидка 20% на все тарифы до 1 дек.Смотреть предложение

API Apollo.io: ключ, эндпоинты, лимиты и MCP-сервер

Leo
LeoFounder, BillionVerify

Руководство по API Apollo.io: создайте API-ключ, запустите проверку, вызовите поиск и обогащение людей, узнайте лимиты и кредиты, подключите MCP-сервер.

Панель API Apollo.io с ключами, эндпоинтами, лимитами запросов, MCP Server и проверкой email

API Apollo.io позволяет вашему коду искать людей, обогащать записи и управлять рабочим процессом продаж. Вы обращаетесь к нему через HTTPS с API-ключом Apollo.io. Также можно пропустить ключ и предоставить AI-клиенту доступ к тем же данным через MCP-сервер Apollo.io. Оба способа расходуют кредиты вашего тарифного плана и подчиняются его ограничениям.

Это руководство описывает API Apollo.io — от первого клика до первого вызова. В нём показано, как создать ключ и где его найти. Рассматриваются документация по API Apollo.io, проверка работоспособности, поиск людей, обогащение данных, ограничения частоты запросов и стоимость кредитов. В конце описан официальный MCP-сервер Apollo.io и процедура проверки адресов, возвращаемых API. Всё основано на официальной документации разработчика на docs.apollo.io, изученной в октябре 2026 года. Apollo.io отмечает несколько страниц как недавно обновлённые, поэтому проверяйте детали в день разработки.

Мы не связаны с Apollo.io. BillionVerify — сервис проверки электронной почты. Чтобы получить более широкое представление о платформе, прочитайте наше руководство по Apollo.io.

Ключевые факты (проверено в октябре 2026 года):

  • Каждый тариф, включая бесплатный, предоставляет некоторый доступ к API. Бесплатным аккаунтам для определённых конечных точек нужен рабочий адрес электронной почты.
  • API Apollo.io передаёт ключ в заголовке x-api-key, а базовый URL — https://api.apollo.io/api/v1.
  • Область действия ключа API Apollo.io ограничивает доступ только отмеченными вами конечными точками. Главный ключ даёт доступ ко всем.
  • Большинство конечных точек допускают 200 вызовов в минуту на платном тарифе против 50 на бесплатном.
  • MCP-сервер Apollo.io находится по адресу https://mcp.apollo.io/mcp и выполняет вход через OAuth.

Что делает API Apollo.io

Apollo.io описывает свой API как способ программно искать, обогащать, создавать и управлять данными. В его основе лежит база данных, содержащая более 240 миллионов контактов и 30 миллионов компаний. Документация разделяет работу на три задачи:

  • Создание интеграций. Подключайте свой продукт к данным Apollo.io, создавайте аккаунты и запускайте последовательности.
  • Обогащение данных. Заполняйте записи о людях и компаниях по одной или массово.
  • Поиск людей. Ищите по должности, местоположению, уровню должности и множеству других фильтров.

Ваш тариф определяет, какие конечные точки вы можете использовать, как часто можете их вызывать и сколько стоит каждый вызов. Apollo.io также сообщает, что его инструменты не могут выполнять действия, недоступные в приложении. Если в вашем аккаунте нет определённой функции, API не откроет к ней доступ.

Какие тарифы включают API?

В разделе часто задаваемых вопросов для разработчиков сказано, что каждый тариф предоставляет базовый доступ. Более продвинутые функции доступны только на определённых тарифах. В нашем руководстве по ценам Apollo.io перечислены тарифы и доступные в них пакеты кредитов.

Для бесплатных аккаунтов действует одно ограничение. Для некоторых конечных точек поиска людей, обогащения и работы с записями требуется аккаунт, зарегистрированный с рабочим адресом электронной почты. Это указано на странице каждой затронутой конечной точки. Платных аккаунтов это ограничение не касается.

Для кого предназначен API Apollo.io?

Чаще всего им пользуются три группы:

  1. Команды продаж и RevOps, которые хотят передавать обогащённые данные в CRM или хранилище данных.
  2. Разработчики программных компаний, которые встраивают данные Apollo.io в собственный продукт.
  3. Партнёры, создающие интеграции с маркетплейсами. Они входят через OAuth 2.0, а не с помощью ключа.

Apollo.io также добавляет примечание о лицензировании. Для передачи, раскрытия или перепродажи его данных людям, которые не являются пользователями Apollo.io, требуется отдельный договор.

Документация API Apollo.io: где всё находится

Документация API Apollo.io находится по адресу docs.apollo.io. Верхняя панель разделяет её на разделы Get Started, API, MCP, CLI, OpenAPI и Changelog. В разделе API для каждой конечной точки есть отдельная страница.

Страница документации API Apollo.io для поиска через People API с панелью учётных данных и примером ответа

Скриншот: страница People API Search в документации разработчика Apollo.io из руководства Apollo.io по тестированию ключа.

Каждая страница конечной точки оформлена одинаково. В верхней части блока «Основные сведения о конечной точке» указаны основной путь доступа, область OAuth, пользователи, которые могут её применять, и стоимость в кредитах. Ниже перечислены параметры. Справа находятся переключатель языка, поле учётных данных, запрос cURL и пример ответа.

Вы можете протестировать запрос прямо на странице. Вставьте ключ в поле заголовка, заполните обязательные параметры и нажмите «Попробовать». Код 200 означает, что вызов выполнен успешно. Даже без ключа можно открыть пример ответа, чтобы просмотреть схему.

Файл OpenAPI

Apollo.io публикует весь API в одном файле OpenAPI 3 по адресу https://docs.apollo.io/openapi/apollo-rest-api.json. Он пересобирается при каждом изменении документации. Загрузите его в Postman или другой клиент API, и каждая конечная точка будет импортирована вместе со своими параметрами. Также его можно передать генератору кода, чтобы создать типизированный клиент на нужном вам языке.

В Postman храните ключ в заранее настроенной авторизации API Key и задайте переменную apiKey. В документации предупреждается, что вставка ключа в качестве токена Bearer приводит к ошибке 401. Токены Bearer предназначены для партнёров OAuth.

Индекс в машиночитаемом формате

В документации также публикуется текстовый индекс по адресу docs.apollo.io/llms.txt. В нём каждая страница указана как ссылка Markdown. Инструменты AI для программирования могут читать этот индекс, чтобы находить нужную страницу конечной точки без обхода сайта.

Как получить API-ключ Apollo.io

API-ключ Apollo.io создаётся внутри приложения, а не на сайте документации. Путь: Settings, затем Integrations, затем API Keys. Сделать это могут только администраторы и пользователи, чей профиль разрешений включает работу с ключами.

Пошаговый способ получить доступ к API-ключу Apollo.io:

  1. Откройте Apollo.io и нажмите Settings > Integrations > API Keys. На панели разработчика по адресу developer.apollo.io отображается та же страница.
  2. Нажмите Create new key.
  3. Введите название и описание.
  4. Отметьте каждый эндпоинт, который может вызывать ключ, или включите Set as master key.
  5. Нажмите Create API key.
  6. Нажмите Copy и вставьте ключ в безопасное место.

Диалоговое окно Apollo.io для создания нового API-ключа с названием, описанием, выбором API и переключателем мастер-ключа

Скриншот: диалоговое окно Create new API key на портале разработчика Apollo.io из документации Apollo.io.

В конце Apollo.io отображает полный ключ. Скопируйте его сразу. Если вы его потеряете, создайте новый на панели управления.

Где найти существующий API-ключ Apollo.io

Если вам нужно найти API-ключ Apollo.io, который вы создали ранее, вернитесь на панель разработчика и откройте API keys. Каждый созданный вами ключ находится в этом списке. На боковой панели портала также есть страницы Quick Start, Usage и Subscription. В той же боковой панели находится страница OAuth Registration для партнёров.

Apollo.io позволяет выполнить с существующим ключом два действия. Regenerate создаёт новый секрет и копирует его. Delete навсегда удаляет ключ. Считайте оба действия необратимыми: каждый скрипт, использовавший старый ключ, перестанет работать.

Мастер-ключ или ключ с ограниченной областью?

Этот выбор важнее любого другого при создании API-ключа Apollo.io.

ТипК чему даёт доступДля чего использовать
Ключ с ограниченной областью (по умолчанию)Только к отмеченным эндпоинтамБольшинство интеграций
Мастер-ключКо всем эндпоинтамЭндпоинты, которым он необходим, и MCP-сервер через ключ

Если ключ с ограниченной областью вызывает неотмеченный эндпоинт, вы получите 403. Некоторые эндпоинты, например список пользователей рабочего пространства, работают только с мастер-ключом. Apollo.io рекомендует обращаться с мастер-ключом как с паролем. Он может выполнять любые действия API, разрешённые вашей учётной записи.

От имени какого пользователя действует ключ?

API-ключ Apollo.io идентифицирует ваше рабочее пространство, а не конкретного человека. Apollo.io не может определить, какой сотрудник его использовал. Каждый запрос выполняется от имени самого старого активного администратора рабочего пространства, и этот пользователь становится владельцем всего, что создаёт вызов. Чтобы узнать, кто это, вызовите эндпоинт получения профиля текущего пользователя — он не расходует кредиты.

Это удивляет команды, которые создают ключ из учётной записи с ограниченными разрешениями. Ключ не сужает доступ кода.

Проверка работоспособности API Apollo.io

Самый быстрый способ проверить новый ключ — выполнить один запрос проверки состояния. Это один GET-запрос к auth/health, при этом кредиты не расходуются.

curl --request GET \
  --url 'https://api.apollo.io/api/v1/auth/health' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY'

Если всё настроено правильно, проверка состояния API Apollo.io возвращает два значения:

{ "healthy": true, "is_logged_in": true }

Когда оба значения равны true, ключ работает. Если одно из них равно false, проверьте наличие лишних пробелов или переносов строк после ключа, затем отправьте запрос снова. В Postman установите тип авторизации No Auth и добавьте ключ вместо этого в заголовок.

Не работает ли API Apollo.io?

Люди, которые ищут этот термин, иногда хотят получить другой ответ. Они хотят узнать, не отключён ли сам сервис. Вызов auth/health проверяет ваш ключ и вход в систему, а не всю платформу. При сбоях Apollo.io поддерживает страницу состояния по адресу status.apollo.io.

Ответ 429 с кодом USAGE.RATE_LIMIT.PLATFORM_RATE_LIMIT означает, что платформа отклоняет трафик из-за высокой общей нагрузки. Это не связано с вашим тарифным планом. В документации рекомендуется подождать 60 секунд и повторить попытку.

Основные группы эндпоинтов в API Apollo.io

В справочнике перечислены десятки эндпоинтов. Они объединены в шесть групп.

ГруппаЧто включаетПримеры
Поиск и обогащениеПоиск людей и компаний, заполнение записейПоиск через People API, обогащение данных о людях, поиск организаций
Управление записямиАккаунты, контакты, сделки, списки, заметкиСоздание контакта, массовое обновление аккаунтов, добавление записей в список
Взаимодействие с потенциальными клиентамиПоследовательности, электронные письма, звонки, задачи, разговорыДобавление контактов в последовательность, немедленная отправка письма
AI-помощникПередача задачи встроенному помощникуЗапуск задачи помощника, проверка задачи помощника
Рабочее пространствоПользователи, почтовые ящики, пользовательские поляПолучение списка пользователей, создание пользовательского поля
Аналитика и использованиеОтчёты, статистика использования, результаты вебхуковЗапрос аналитического отчёта, просмотр статистики использования

Управление записями, последовательности и большинство вызовов рабочего пространства используют 0 кредитов. Стоимость связана с поиском и обогащением, которые мы рассмотрим ниже.

Поиск — это не обогащение

Именно здесь часто ошибаются новые пользователи. Поиск в базе данных Apollo.io возвращает профили. Результаты не содержат электронных адресов или номеров телефонов. Чтобы получить их, нужен второй вызов — к эндпоинту обогащения. Поиск собственных сохранённых контактов выполняется через другой набор эндпоинтов, и для него действуют иные ограничения.

Документация по поиску людей через API Apollo.io

Документация по поиску людей через API Apollo.io охватывает одну конечную точку POST: /mixed_people/api_search. Apollo.io описывает людей как новых потенциальных клиентов, которых вы ещё не сохранили в качестве контактов.

curl --request POST \
  --url 'https://api.apollo.io/api/v1/mixed_people/api_search?person_titles[]=sales%20director&person_locations[]=california&per_page=10' \
  --header 'accept: application/json' \
  --header 'x-api-key: YOUR_API_KEY'

Параметры указываются в строке запроса. Вы можете сузить поиск по следующим критериям:

  • Должности: person_titles[], а также person_not_titles[] для исключения определённых должностей.
  • Уровень должности: person_seniorities[].
  • Местоположение: person_locations[] — где живут люди, organization_locations[] — где находятся штаб-квартиры компаний.
  • Размер и выручка компании: organization_num_employees_ranges[] и revenue_range[min].
  • Технологии: фильтры для более чем 1 500 технологий, используемых компанией.
  • Сигналы найма: q_organization_job_titles[] и количество объявлений о вакансиях.
  • Статус Email: contact_email_status[] со значениями вроде подтверждённого, неподтверждённого, вероятного к взаимодействию и недоступного.
  • Постраничная навигация: page и per_page.

Конечная точка поиска людей использует 0 кредитов. Она возвращает до 100 записей на страницу. Также действует лимит отображения в 50 000 записей, то есть 500 страниц. Добавляйте фильтры, чтобы не превышать его.

Что возвращает поиск людей через API Apollo.io

Ответ поиска людей содержит количество total_entries и список people. Email-адреса и номера телефонов в нём отсутствуют. Чтобы получить контактные данные, передайте каждый результат в конечную точку обогащения данных.

Для поиска действуют собственные ограничения, перечисленные в разделе ниже об ограничении частоты запросов.

Если вы выполняете поиск по contact_email_status[], помните, откуда берётся это значение. Оно описывает собственную запись Apollo.io об адресе. Это не проверка работоспособности почтового ящика в реальном времени.

Как быстрее изучить документацию по поиску людей через API Apollo.io

Начните с блока «Основные сведения о конечной точке». Проверьте строки об использовании кредитов и доступе для бесплатной учётной записи. Затем просмотрите список параметров и найдите нужные фильтры. Наконец, выполните один небольшой запрос с per_page=10, прежде чем загружать по страницам тысячи результатов.

Обогащение данных о людях с помощью API Apollo.io

Обогащение обновляет записи, которые уже хранятся у вас. Apollo.io предлагает два endpoint для людей:

  • Обогащение данных о человеке: POST /people/match, по одному человеку за вызов.
  • Массовое обогащение данных о людях: до 10 человек в одном запросе.

Apollo.io требуется достаточно данных, чтобы сопоставить нужного человека. Одного адреса электронной почты достаточно. Также подойдут имя и домен компании. Endpoint также принимает URL LinkedIn, название организации или идентификатор человека в Apollo.io. Если отправить только имя, можно получить ответ 200, который не содержит обогащённых данных.

Проверяйте match_confidence в каждом ответе. Это значение может быть high, medium, low или none.

curl --request POST \
  --url 'https://api.apollo.io/api/v1/people/match?email=mark%40sumware.com' \
  --header 'accept: application/json' \
  --header 'x-api-key: YOUR_API_KEY'

Ответ содержит должность человека, историю трудоустройства, данные компании и значение email_status, например verified. Этот статус является собственной меткой Apollo.io. Наша последующая проверка в этом руководстве тестирует сам адрес.

Телефоны, личные адреса и каскадный поиск

Три необязательных переключателя меняют получаемые данные:

  • reveal_personal_emails=true добавляет личные адреса. Apollo.io не раскрывает их для людей из регионов, подпадающих под GDPR.
  • reveal_phone_number=true добавляет все номера телефонов, включая мобильные. Для этого требуется webhook_url. Apollo.io асинхронно проверяет номера и отправляет их на ваш webhook, что может занять несколько минут.
  • run_waterfall_email и run_waterfall_phone сначала выполняют поиск в Apollo.io, а затем у настроенных внешних поставщиков данных. Итоговые результаты также поступают через webhook.

Не платите дважды

Если позже снова обогащать данные о том же человеке, можно повторно потратить кредиты на те же данные. Apollo.io рекомендует преобразовывать обогащённых людей в контакты. Контакт принадлежит вашей организации, поэтому его данные остаются доступными.

Ограничения частоты запросов API Apollo.io

Ограничения частоты применяются ко всей команде, а не к отдельному ключу или пользователю. Они также действуют для каждой конечной точки и одновременно рассчитываются в трёх окнах: минутном, часовом и суточном. Необходимо соблюдать все применимые окна.

ОграничениеFreeBasicProfessionalOrganization
Запросов в минуту50200200200
Запросов в час200400400600
Запросов в день6002 0002 0006 000

Эта таблица показывает значения по умолчанию. Конечные точки поиска и обогащения данных имеют более высокие ограничения на платных тарифах:

  • Конечные точки обогащения: 1 000 запросов в минуту на платных тарифах без часового или суточного ограничения. Бесплатные аккаунты получают 50 запросов в минуту и 20 запросов для массовых конечных точек.
  • Конечные точки поиска: 200 запросов в минуту, 6 000 в час и 50 000 в день на платных тарифах.
  • Более низкие ограничения: отчёт аналитики запросов допускает 5 запросов в час.

В документации Apollo.io отмечается, что высокое ограничение для обогащения не даёт права отправлять неограниченное количество вызовов. Баланс кредитов по-прежнему определяет, какой объём данных можно обогатить.

Страница Usage на портале разработчика Apollo.io с отображением суточных и часовых ограничений частоты для обогащения данных

Скриншот страницы Usage на портале разработчика Apollo.io с суточными и часовыми ограничениями для конечных точек обогащения данных, из документации Apollo.io.

Заголовки ответа и ошибка 429

Apollo.io добавляет заголовки к аутентифицированным вызовам. Они показывают ограничение, текущее использование и количество оставшихся запросов для каждого окна:

  • x-rate-limit-minute, x-rate-limit-hourly и x-rate-limit-24-hour
  • x-minute-usage, x-hourly-usage и x-24-hour-usage
  • x-minute-requests-left, x-hourly-requests-left и x-24-hour-requests-left
  • retry-after, отправляемый вместе с 429, показывает количество секунд до сброса окна

При превышении ограничения вы получите 429. Прочитайте retry-after и подождите. Окно начинается с вашего первого запроса и не привязано к часам. Тело ошибки содержит объект error_details. Его поле code имеет значение USAGE.RATE_LIMIT.API_RATE_LIMIT_EXCEEDED при превышении собственного ограничения.

Чтобы программно прочитать текущие ограничения вашей команды, вызовите конечную точку API статистики использования. Один вызов может охватывать до 74 путей конечных точек, и кредиты за это не списываются.

Кредиты API Apollo.io: за что нужно платить

Многие вызовы ничего не стоят. Apollo.io сообщает, что конечные точки, которые создают, обновляют, перечисляют или управляют записями, расходуют 0 кредитов. Кредиты списываются за обогащение данных, поиск организаций, поиск новостей и конечные точки аналитических данных AI — только если они возвращают подходящие данные.

Конечная точкаСтоимость в кредитах
Обогащение данных о людяхОт 1 до 9 на человека: 1 за демографические данные или email, плюс 8, если возвращается мобильный телефон
Массовое обогащение данных о людяхТа же логика, до 10 человек за запрос
Обогащение данных об организациях1 на организацию
Поиск организаций1 за страницу, до 100 результатов на странице
Поиск новостных статей1 за страницу, до 25 результатов на странице
Вакансии организаций1 за страницу
Получение полной информации о человеке1 на человека
Задача ассистентаПеременная величина, определяется действиями, которые выполняет ассистент

Поиск людей бесплатен, поэтому разумно сначала выполнять поиск, а затем обогащать данные только для наиболее подходящих совпадений. При постраничной загрузке конечной точки, которая расходует кредиты, кредиты списываются за каждую страницу. Apollo.io рекомендует провести небольшой тестовый запуск и проверить использование перед масштабированием.

Каскадное обогащение может стоить дороже. При каскадном поиске email обычно используется от 1 до 4 кредитов, а в некоторых конфигурациях — 20 и более. При каскадном поиске телефона обычно используется от 8 до 25 кредитов, а в некоторых конфигурациях — 45 и более.

Чтобы отслеживать расходы, откройте в приложении «Настройки» > «Оплата и кредиты» > «Использование кредитов». На вкладке «Использование» панели разработчика отображается количество использованных кредитов телефона и email в текущем расчётном цикле. Старые тарифные планы могут отличаться, поэтому проверьте страницу «О кредитах» для своего рабочего пространства.

Ошибки и коды состояния

Большинство конечных точек API Apollo.io используют небольшой список кодов состояния:

КодЗначениеРаспространённая причина
401Не авторизованКлюч отсутствует, недействителен или принадлежит неактивной учётной записи
403Доступ запрещёнТарифный план не предоставляет доступ к API или ключ с ограниченной областью действия не имеет доступа к конечной точке
404Не найденоЗапись не существует или недоступна для просмотра
422Обработать невозможноНедействительный или отсутствующий параметр
429Слишком много запросовВы превысили ограничение частоты запросов
500Ошибка сервераСбой на стороне Apollo.io, поэтому повторите попытку

Apollo.io переводит ошибки на единый формат. Если конечная точка уже переведена, ответ содержит объект error_details со стабильными полями code, message, suggestions и context. Стройте логику кода на основе error_details.code, а не текста сообщения. Apollo.io планирует удалить старые поля ошибок на корневом уровне 16 февраля 2027 года, поэтому уже сейчас используйте новый объект.

MCP-сервер Apollo.io

MCP — это стандарт, который позволяет AI-инструментам вызывать внешние сервисы. MCP-сервер Apollo.io связывает Claude, ChatGPT и аналогичные клиенты с вашей учётной записью Apollo.io. После этого вы можете задавать запросы обычным языком: найти руководителей маркетинга уровня VP в SaaS-компаниях или обогатить данные этих десяти потенциальных клиентов.

Страница документации MCP Apollo.io, показывающая три способа подключения: AI-коннекторы, плагины для программирования и автономный MCP-сервер

Скриншот: страница MCP Apollo.io в документации для разработчиков, октябрь 2026 года.

Три способа подключения

СпособКак это работает
AI-коннекторыВстроенные интеграции в ChatGPT, Claude, Perplexity, Replit и Cursor. Настройка сервера не требуется.
Плагины для программированияОфициальные плагины для таких инструментов, как Codex.
Автономный MCP-серверУкажите любой MCP-клиент с поддержкой удалённых серверов на один URL.

Настройки автономного сервера просты:

НастройкаЗначение
Конечная точкаhttps://mcp.apollo.io/mcp
ТранспортПотоковый HTTP
ВходOAuth 2.0
Локальная установкаНе требуется
API-ключНе требуется, если у клиента нет браузера

В Claude Code сервер добавляется одной командой. Выполните её, затем введите /mcp и завершите вход через OAuth:

claude mcp add --transport http apollo https://mcp.apollo.io/mcp

Если вы управляете несколькими рабочими пространствами, добавьте тот же URL под отдельным именем для каждого из них. Войдите в каждое подключение отдельно.

Серверы без браузера

Для OAuth требуется окно браузера. У задания cron или CI-конвейера его нет. Для таких случаев сервер принимает API-ключ, переданный в заголовке X-Api-Key. Ключ должен быть главным ключом. Ограниченный ключ возвращает ошибку 403 с кодом API_INACCESSIBLE, поскольку MCP-сервер не относится к конечным точкам, которые можно выбрать.

Храните этот ключ так же, как любой производственный секрет. Он действует как администратор рабочего пространства и расходует его кредиты. Новые MCP-инструменты сразу получают доступ к главному ключу, но ваш клиент может сохранять список инструментов в кэше. Переподключитесь и вызовите tools/list, чтобы обновить его.

Что умеет MCP-сервер Apollo.io

Список инструментов охватывает поиск и работу с потенциальными клиентами, обогащение данных о людях и компаниях, контакты, списки, последовательности, разовые письма, задачи, проверку доменов электронной почты и аналитику. Действия по обогащению данных используют кредиты. Большинство других действий — нет. Apollo.io предупреждает, что поиск людей не возвращает адреса электронной почты или номера телефонов, поэтому ассистент должен выполнить для них этап обогащения.

Практические ограничения из документации:

  • Дополнительная плата за подключение отсутствует. Применяются ваш тариф, разрешения и кредиты.
  • Разрушающие действия, например массовое удаление, не поддерживаются.
  • Сервер соблюдает ваши разрешения. При использовании OAuth он действует от имени вошедшего пользователя.
  • MCP Apollo.io использует отдельные ограничения частоты запросов и не возвращает заголовки с этой информацией.
  • Apollo.io запрещает обучение AI-моделей на данных MCP, поэтому сначала отключите обучение в своём AI-клиенте.

Apollo.io рекомендует для действий, расходующих кредиты, установить статус «Требуется подтверждение», чтобы разговорчивый ассистент не мог самостоятельно израсходовать все кредиты.

Другие способы использования API Apollo.io

  • CLI Apollo.io. Инструмент командной строки с доступом ко всему API. Установите его через Homebrew, готовый бинарный файл или из исходного кода. Он использует OAuth, поэтому ключ не требуется.
  • OAuth 2.0. Партнёры используют его для вызова API от имени общих клиентов, а в документации указано приложение marketplace для готовых интеграций.
  • Расширение Chrome. Если вы предпочитаете клики программированию, ознакомьтесь с нашим руководством по расширению Apollo для Chrome.

Проверьте адреса через API Apollo.io перед отправкой

Какой бы способ вы ни выбрали, у данных есть одно слабое место. Они поступают из базы данных. Люди меняют работу, а компании переходят на новые домены. Поле email_status — это собственная метка Apollo.io, а не результат свежей проверки. Холодное письмо на несуществующий адрес возвращается с ошибкой, а такие возвраты вредят репутации отправителя.

Поэтому добавьте проверку между обогащением данных и вашей последовательностью. BillionVerify проверяет каждый адрес, не отправляя сообщение. Сервис проверяет синтаксис, домен, записи MX и, если вы запросите это, почтовый ящик через SMTP. Он помечает одноразовые и ролевые адреса. Результат catch-all отображается отдельно, а не засчитывается как действительный. Неизвестные результаты ничего не стоят, а повторная проверка в течение 24 часов бесплатна. До подключения API вы можете вручную проверить, существует ли адрес электронной почты с помощью бесплатного веб-проверщика.

Результаты проверки электронной почты API BillionVerify со статусом, флагом доступности и причиной

BillionVerify возвращает статус, флаг доступности и причину для каждого адреса.

Небольшой конвейер

Простой конвейер состоит из четырёх шагов:

  1. Выполните бесплатный поиск людей через API.
  2. Обогащайте данными только лучшие совпадения.
  3. Отправьте каждый адрес в REST API BillionVerify.
  4. Добавьте в последовательность только доступные адреса.

Вызов BillionVerify — это один POST-запрос. Передайте ключ в заголовке BV-API-KEY и установите check_smtp в значение true для проверки почтового ящика в реальном времени:

curl -X POST https://api.billionverify.com/v1/verify/single \
  -H "BV-API-KEY: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"email":"mark@sumware.com","check_smtp":true}'

Ответ содержит status, is_deliverable, is_catchall, is_role, is_disposable и reason. Для проверки до 50 адресов за один вызов используйте массовой маршрут. Для полного экспорта загрузите файл CSV, TXT или XLSX и скачайте результаты позже. Полная справочная информация приведена в документации BillionVerify.

Проверка из AI-клиента

Если вы уже подключили настройку MCP Apollo.io к AI-клиенту, добавьте рядом с ней размещённый MCP-сервер BillionVerify. Он находится по адресу https://mcp.billionverify.com/mcp и использует OAuth для входа. После этого ваш ассистент сможет обогатить данные о потенциальном клиенте через Apollo.io и проверить адрес в одном разговоре. Сообщите ему вашу политику — например, какие статусы принимать и что делать с catch-all.

Другие проверки

BillionVerify предоставляет 20 бесплатных кредитов каждый день использования аккаунта — до 600 в месяц. Они никогда не истекают, и кредитная карта не требуется.

Советы по работе с API Apollo.io

  • Начинайте с одного ключа с ограниченной областью действия для каждой интеграции. Если один ключ утечёт, вы отзовёте только его.
  • Сначала выполните проверку работоспособности. Она исключит проблемы с ключом, прежде чем вы начнёте отлаживать код.
  • Прочитайте блок с основными сведениями о Endpoint. В документации Apollo.io API по поиску людей стоимость кредитов указана заранее.
  • Сначала выполняйте поиск, затем обогащение. Поиск бесплатен, а обогащение — нет.
  • Тестируйте с per_page=10. Небольшие запуски показывают стоимость в кредитах до того, как она станет ощутимой.
  • Учитывайте retry-after. Частые запросы к ограниченному Endpoint лишь продлевают ожидание.
  • Читайте error_details.code. Текст сообщения может измениться без предупреждения.
  • Проверяйте адрес перед отправкой. Кредит, потраченный на адрес, с которого письма возвращаются, теряется дважды.

Часто задаваемые вопросы

Есть ли у Apollo.io API?

Да, у Apollo.io есть REST API. Он позволяет искать людей и компании, обогащать контакты и обновлять аккаунты, сделки и последовательности. Базовый доступ предоставляется на каждом тарифе. Ваш план определяет, какие конечные точки можно вызывать, с какой скоростью и сколько стоит каждый вызов.

Как получить ключ Apollo.io API?

Ключ Apollo.io можно получить в разделе Integrations в Settings: откройте API Keys и выберите Create new key. Назовите его, отметьте конечные точки, которые он может вызывать, подтвердите действие и сразу скопируйте секрет. Это может сделать администратор или пользователь с подходящим профилем разрешений.

Где найти ключ Apollo.io API?

Список ключей Apollo.io API находится на странице API Keys, которую можно открыть из приложения или панели разработчика. Полный секрет отображается при создании ключа. Если секрет утерян, ключ нужно создать заново — будет выдан новый.

Является ли Apollo.io API бесплатным?

Вызовы Apollo.io API для создания, просмотра или обновления записей бесплатны, как и поиск людей. За обогащение и некоторые конечные точки поиска взимаются кредиты при возврате данных. Бесплатные аккаунты могут вызывать API в пределах ограничений бесплатного плана, но для некоторых конечных точек требуется рабочий email.

Каково ограничение частоты запросов Apollo.io API?

На платном тарифе большинство конечных точек Apollo.io API принимают 200 вызовов в минуту, а почасовые и ежедневные ограничения зависят от тарифа. Бесплатный тариф допускает 50 вызовов в минуту, 200 в час и 600 в день. Ограничения применяются для каждой команды и конечной точки, а ответ 429 означает, что вы превысили одно из них.

Как проверить работоспособность Apollo.io API?

Проверка работоспособности Apollo.io выполняется GET-запросом к пути auth/health с установленным заголовком ключа. Ответ healthy: true и is_logged_in: true означает, что ключ работает. Кредиты не расходуются.

Возвращает ли поиск людей через Apollo.io API email-адреса?

Нет, конечная точка поиска людей Apollo.io возвращает только профили, без email-адресов и телефонов. Для получения контактных данных запустите обогащение людей или массовое обогащение людей по результатам поиска; это стоит кредитов.

Где находится документация Apollo.io API?

Документация Apollo.io API находится на сайте docs.apollo.io. У каждой конечной точки есть отдельная страница с параметрами, панелью тестирования и примером ответа. Также можно скачать файл OpenAPI и импортировать его в Postman.

Что такое MCP-сервер Apollo.io?

MCP-сервер Apollo.io связывает клиентов с AI и вашим рабочим пространством через Model Context Protocol. Его URL — https://mcp.apollo.io/mcp; он использует Streamable HTTP и OAuth и не требует локальной установки. Ваш план, разрешения и кредиты по-прежнему действуют.

Какой MCP-сервер лучше всего подходит для Apollo.io?

Apollo.io публикует один официальный MCP-сервер — именно его описывает документация. Мы не тестировали сторонние варианты. Выберите официальный сервер, если хотите использовать те же разрешения и правила начисления кредитов, что и в приложении.

Нужно ли проверять email-адреса, полученные через Apollo.io API?

Да, проверяйте каждый email-адрес, полученный через Apollo.io API, перед запуском кампании. Поле email_status отражает собственные записи Apollo.io, а люди меняют работу. Быстрая проверка через BillionVerify API удаляет недействительные адреса и защищает репутацию отправителя.

Смотреть видео: Как проверить номер телефона: бесплатный валидатор номеров

Смотреть видео: Как проверить email из Apollo перед отправкой

Leo
LeoFounder, BillionVerify
Аналитика проверки Email

Начните проверку сегодня

Начните проверять email с BillionVerify уже сегодня. Получите 20 бесплатных кредитов за каждый день входа в систему, до 600 в месяц — кредитная карта не требуется. Присоединяйтесь к тысячам компаний, улучшающих ROI email-маркетинга с помощью точной проверки email.

Кредитная карта не требуется · API в реальном времени и массовая верификация · Неопределённые результаты бесплатны

0
Кредиты за неопределённые результаты
Мгновенно
Скорость API
$0.00014
За e-mail
600/мес
Бесплатно навсегда