// tomba cli

Email-аналитика из вашего терминала

Ищите по доменам, находите email-адреса, проверяйте их и обогащайте контакты не покидая терминала. Установка одной командой. Работает на macOS, Linux и Windows.

Установить Tomba CLI Смотреть на GitHub

macOS · Linux · WindowsВывод в JSON, YAML или CSVВход через OAuth device flow

zsh

$ tomba verify --target richard@piedpiper.com --json
{
  "data": {
    "email": {
      "email": "richard@piedpiper.com",
      "result": "deliverable",
      "status": "valid",
      "score": 99
    }
  }
}

// 01 · установка

Один исполняемый файл для macOS, Linux и Windows

Скрипты установки проверяют контрольную сумму SHA-256 релиза и настраивают автодополнение в оболочке. Релизы опубликованы на GitHub.

install tomba

curl -sSL https://releases.tomba.io/install.sh | sh

brew install --cask tomba-io/tap/tomba

irm https://releases.tomba.io/install.ps1 | iex

scoop bucket add tomba https://github.com/tomba-io/scoop-bucket.git
scoop install tomba

sudo snap install tomba

// 02 · команды

Все эндпоинты из терминала

Передайте входные данные через --target; добавьте --json, --yaml или --csv для машиночитаемого вывода и --output, чтобы записать файл.

tomba search
Email-адреса, которые есть у Tomba для домена
GET /v1/domain-search
tomba finder
Email человека по имени и домену компании
GET /v1/email-finder
tomba author
Email автора статьи
GET /v1/author-finder
tomba enrich
Человек за email-адресом
GET /v1/enrich
tomba enrichment person
Профиль человека по email
GET /v1/people/find
tomba enrichment company
Профиль компании по домену
GET /v1/companies/find
tomba enrichment combined
Человек и компания в одном запросе
GET /v1/combined/find
tomba verify
Доставляем ли email-адрес
GET /v1/email-verifier
tomba linkedin
Email для профиля LinkedIn
GET /v1/linkedin
tomba sources
Публичные страницы, где был найден адрес
GET /v1/email-sources
tomba count
Адреса домена по отделам и уровню должности
GET /v1/email-count
tomba status
Является ли домен веб-почтой или одноразовым
GET /v1/domain-status
tomba format
Шаблоны адресов, которые использует домен
GET /v1/email-format
tomba location
Число сотрудников компании по местоположению
GET /v1/location
tomba autocomplete
Компании и домены по части названия
GET /v1/domain-suggestions
tomba phone-finder
Номера телефонов по email, домену или профилю LinkedIn
GET /v1/phone-finder
tomba phone-validator
Действителен ли номер телефона, его форматы и оператор
GET /v1/phone-validator
tomba reveal
Компании по запросу на естественном языке или фильтрам
POST /v1/reveal/search
tomba similar
Компании, похожие на домен
GET /v1/similar
tomba technology
Технологии на сайте домена
GET /v1/technology
tomba lead · leads-list · attribute
Управление лидами, списками лидов и пользовательскими атрибутами
/v1/leads, /v1/leads_lists, /v1/attributes
tomba flag create · list
Сообщайте о неверных данных и просматривайте свои сообщения
POST /v1/flag, GET /v1/flag
tomba key list · get · create · delete
Управление API-ключами рабочего пространства
/v1/keys
tomba whoami · usage · logs
Ваш аккаунт, использование за день и последние запросы
GET /v1/me, /v1/usage, /v1/logs

Команда	Возвращает	Вызывает
tomba search	Email-адреса, которые есть у Tomba для домена	GET /v1/domain-search
tomba finder	Email человека по имени и домену компании	GET /v1/email-finder
tomba author	Email автора статьи	GET /v1/author-finder
tomba enrich	Человек за email-адресом	GET /v1/enrich
tomba enrichment person	Профиль человека по email	GET /v1/people/find
tomba enrichment company	Профиль компании по домену	GET /v1/companies/find
tomba enrichment combined	Человек и компания в одном запросе	GET /v1/combined/find
tomba verify	Доставляем ли email-адрес	GET /v1/email-verifier
tomba linkedin	Email для профиля LinkedIn	GET /v1/linkedin
tomba sources	Публичные страницы, где был найден адрес	GET /v1/email-sources
tomba count	Адреса домена по отделам и уровню должности	GET /v1/email-count
tomba status	Является ли домен веб-почтой или одноразовым	GET /v1/domain-status
tomba format	Шаблоны адресов, которые использует домен	GET /v1/email-format
tomba location	Число сотрудников компании по местоположению	GET /v1/location
tomba autocomplete	Компании и домены по части названия	GET /v1/domain-suggestions
tomba phone-finder	Номера телефонов по email, домену или профилю LinkedIn	GET /v1/phone-finder
tomba phone-validator	Действителен ли номер телефона, его форматы и оператор	GET /v1/phone-validator
tomba reveal	Компании по запросу на естественном языке или фильтрам	POST /v1/reveal/search
tomba similar	Компании, похожие на домен	GET /v1/similar
tomba technology	Технологии на сайте домена	GET /v1/technology
tomba lead · leads-list · attribute	Управление лидами, списками лидов и пользовательскими атрибутами	/v1/leads, /v1/leads_lists, /v1/attributes
tomba flag create · list	Сообщайте о неверных данных и просматривайте свои сообщения	POST /v1/flag, GET /v1/flag
tomba key list · get · create · delete	Управление API-ключами рабочего пространства	/v1/keys
tomba whoami · usage · logs	Ваш аккаунт, использование за день и последние запросы	GET /v1/me, /v1/usage, /v1/logs

// 03 · массовая обработка

Обработайте CSV на своём компьютере

tomba bulk отправляет один запрос к API на строку и записывает результаты в новый CSV по мере обработки строк. Каждая строка оплачивается и учитывается в лимитах как отдельный запрос; для серверных задач используйте Bulk API.

tomba bulk

# One API request per row, from your machine
tomba bulk --file leads.csv --type verify --column "Email Address"
tomba bulk --file prospects.csv --type finder --domain-col company_domain --first-col first --last-col last
tomba bulk --file domains.csv --type search --domain-col domain --output domain-search.csv

tomba bulk: Выполняется на вашем компьютере, один запрос на строку, каждый оплачивается как отдельный вызов
POST /v1/bulk/{type}: Выполняется на серверах Tomba одной задачей, оплачивается при первой загрузке

Справочник Bulk API

// 04 · вход

Вход через браузер или API-ключ

tomba login использует OAuth 2.0 device flow, поэтому работает через SSH; для скриптов входите с ключом. Учётные данные сохраняются в ~/.tomba.json.

tomba login

tomba login

tomba login --api-key
tomba whoami

tomba verify --target richard@piedpiper.com --key "$TOMBA_API_KEY" --secret "$TOMBA_SECRET_KEY"

// частые вопросы

Вопросы о Tomba CLI

Остались вопросы? Перейти в справочный центр