Hunter
Поиск и проверка рабочих email через Hunter.io в процессах Pailot
Hunter.io — сервис поиска и проверки рабочих email: адреса по домену, вероятный email человека, проверка доставляемости и данные о компании.
С Hunter в Pailot вы можете:
- Искать компании по запросу, домену, размеру и технологиям
- Собирать email по домену: источники, шаблон адреса, отдел и уровень
- Находить наиболее вероятный email по имени и домену компании
- Проверять, дойдёт ли письмо (deliverable / undeliverable / risky)
- Считать, сколько адресов найдено по домену или названию компании
Нужен ключ API (Application Programming Interface — программный интерфейс) Hunter.io.
Блок ставят на холст как отдельный шаг или прикрепляют к агенту. Ключ — в переменных окружения рабочего пространства.
Компании по заданным критериям: поиск Hunter.io с опорой на модель.
| Параметр | Тип | Обязательный | Описание |
|---|
query | string | Нет | Поисковый запрос компаний обычным языком |
domain | string | Нет | Домены компаний для фильтра |
headcount | string | Нет | Размер компании (например 1-10, 11-50) |
company_type | string | Нет | Тип организации |
technology | string | Нет | Технологии, которые использует компания |
apiKey | string | Да | Ключ API Hunter.io |
| Параметр | Тип | Описание |
|---|
results | array | Компании, подходящие под критерии: domain, name, headcount, technologies, email_count |
Все найденные email для одного домена — со источниками.
| Параметр | Тип | Обязательный | Описание |
|---|
domain | string | Да | Домен, по которому искать email |
limit | number | Нет | Максимум адресов (по умолчанию 10) |
offset | number | Нет | Сколько адресов пропустить |
type | string | Нет | Фильтр: личные или общие ящики |
seniority | string | Нет | Уровень: junior, senior или executive |
department | string | Нет | Отдел (например sales, marketing) |
apiKey | string | Да | Ключ API Hunter.io |
| Параметр | Тип | Описание |
|---|
domain | string | Искомый домен |
disposable | boolean | Принимает ли домен одноразовые адреса |
webmail | boolean | Является ли домен веб-почтой |
accept_all | boolean | Принимает ли домен любые адреса (catch-all) |
pattern | string | Шаблон email в организации |
organization | string | Название организации |
description | string | Описание организации |
industry | string | Отрасль |
twitter | string | Профиль организации в Twitter |
facebook | string | Профиль организации в Facebook |
linkedin | string | Профиль организации в LinkedIn |
instagram | string | Профиль организации в Instagram |
youtube | string | Канал организации на YouTube |
technologies | array | Технологии организации |
country | string | Страна |
state | string | Регион / штат |
city | string | Город |
postal_code | string | Почтовый индекс |
street | string | Улица |
emails | array | Найденные адреса: value, type, confidence, sources и данные человека |
Наиболее вероятный email человека по имени и домену компании.
| Параметр | Тип | Обязательный | Описание |
|---|
domain | string | Да | Домен компании |
first_name | string | Да | Имя |
last_name | string | Да | Фамилия |
company | string | Нет | Название компании |
apiKey | string | Да | Ключ API Hunter.io |
| Параметр | Тип | Описание |
|---|
email | string | Найденный адрес |
score | number | Оценка уверенности в адресе |
sources | array | Источники: domain, uri, extracted_on, last_seen_on, still_on_page |
verification | object | Проверка: дата и статус |
Проверка доставляемости email и подробный статус.
| Параметр | Тип | Обязательный | Описание |
|---|
email | string | Да | Адрес для проверки |
apiKey | string | Да | Ключ API Hunter.io |
| Параметр | Тип | Описание |
|---|
result | string | Доставляемость: deliverable, undeliverable или risky |
score | number | Оценка уверенности в результате |
email | string | Проверенный адрес |
regexp | boolean | Соответствует ли адрес обычному шаблону |
gibberish | boolean | Похож ли адрес на бессмысленный набор символов |
disposable | boolean | Адрес с одноразового почтового сервиса |
webmail | boolean | Адрес веб-почты |
mx_records | boolean | Есть ли MX-записи у домена |
smtp_server | boolean | Доступен ли SMTP-сервер |
smtp_check | boolean | Успешна ли проверка SMTP |
accept_all | boolean | Принимает ли домен любые адреса |
block | boolean | Заблокирован ли адрес |
status | string | Статус: valid, invalid, accept_all, webmail, disposable или unknown |
sources | array | Источники, где адрес встречался |
Данные о компании по домену.
| Параметр | Тип | Обязательный | Описание |
|---|
domain | string | Да | Домен компании |
apiKey | string | Да | Ключ API Hunter.io |
| Параметр | Тип | Описание |
|---|
person | object | Данные человека (для этого инструмента не заполняется) |
company | object | Компания: name, domain, industry, size, country, linkedin, twitter |
Сколько email найдено по домену или названию компании.
| Параметр | Тип | Обязательный | Описание |
|---|
domain | string | Нет | Домен (обязателен, если не указан company) |
company | string | Нет | Название компании (обязательно, если не указан domain) |
type | string | Нет | Только личные или только общие ящики |
apiKey | string | Да | Ключ API Hunter.io |
| Параметр | Тип | Описание |
|---|
total | number | Всего найденных адресов |
personal_emails | number | Личных адресов |
generic_emails | number | Общих адресов |
department | object | Разбивка по отделам (executive, it, finance, management, sales, legal, support, hr, marketing, communication) |
seniority | object | Разбивка по уровню (junior, senior, executive) |
