// tomba cli

Inteligencia de Email a Partir do Seu Terminal

Pesquise dominios, encontre emails, verifique enderecos e enriqueca contactos tudo sem sair do seu terminal. Instale com um unico comando. Funciona em macOS, Linux e Windows.

Instalar Tomba CLI Ver no GitHub

macOS · Linux · WindowsSaída em JSON, YAML ou CSVLogin OAuth por dispositivo

zsh

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

// 01 · instalação

Um único binário para macOS, Linux e Windows

Os scripts de instalação verificam o checksum SHA-256 da versão e configuram o autocompletar do shell. As versões estão no 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 · comandos

Todos os endpoints a partir do terminal

Passe a entrada com --target; adicione --json, --yaml ou --csv para saída legível por máquina e --output para gravar um arquivo.

tomba search
Os endereços de email que a Tomba tem para um domínio
GET /v1/domain-search
tomba finder
O email de uma pessoa a partir do nome e do domínio da empresa
GET /v1/email-finder
tomba author
O email do autor de um artigo
GET /v1/author-finder
tomba enrich
A pessoa por trás de um endereço de email
GET /v1/enrich
tomba enrichment person
O perfil de uma pessoa a partir de um email
GET /v1/people/find
tomba enrichment company
O perfil de uma empresa a partir de um domínio
GET /v1/companies/find
tomba enrichment combined
Pessoa e empresa em uma única requisição
GET /v1/combined/find
tomba verify
Se um endereço de email pode receber mensagens
GET /v1/email-verifier
tomba linkedin
O email de um perfil do LinkedIn
GET /v1/linkedin
tomba sources
As páginas públicas onde um endereço foi encontrado
GET /v1/email-sources
tomba count
Endereços de um domínio, por departamento e senioridade
GET /v1/email-count
tomba status
Se um domínio é webmail ou descartável
GET /v1/domain-status
tomba format
Os padrões de endereço que um domínio usa
GET /v1/email-format
tomba location
O número de funcionários de uma empresa por localização
GET /v1/location
tomba autocomplete
Empresas e domínios a partir de parte de um nome
GET /v1/domain-suggestions
tomba phone-finder
Números de telefone a partir de um email, domínio ou perfil do LinkedIn
GET /v1/phone-finder
tomba phone-validator
Se um número de telefone é válido, seus formatos e a operadora
GET /v1/phone-validator
tomba reveal
Empresas a partir de uma consulta em linguagem natural ou de filtros
POST /v1/reveal/search
tomba similar
Empresas semelhantes a um domínio
GET /v1/similar
tomba technology
As tecnologias no site de um domínio
GET /v1/technology
tomba lead · leads-list · attribute
Gerencie leads, listas de leads e atributos personalizados
/v1/leads, /v1/leads_lists, /v1/attributes
tomba flag create · list
Reporte dados incorretos e liste seus relatos
POST /v1/flag, GET /v1/flag
tomba key list · get · create · delete
Gerencie as chaves de API do seu workspace
/v1/keys
tomba whoami · usage · logs
Sua conta, o uso diário e as requisições recentes
GET /v1/me, /v1/usage, /v1/logs

Comando	Retorna	Chama
tomba search	Os endereços de email que a Tomba tem para um domínio	GET /v1/domain-search
tomba finder	O email de uma pessoa a partir do nome e do domínio da empresa	GET /v1/email-finder
tomba author	O email do autor de um artigo	GET /v1/author-finder
tomba enrich	A pessoa por trás de um endereço de email	GET /v1/enrich
tomba enrichment person	O perfil de uma pessoa a partir de um email	GET /v1/people/find
tomba enrichment company	O perfil de uma empresa a partir de um domínio	GET /v1/companies/find
tomba enrichment combined	Pessoa e empresa em uma única requisição	GET /v1/combined/find
tomba verify	Se um endereço de email pode receber mensagens	GET /v1/email-verifier
tomba linkedin	O email de um perfil do LinkedIn	GET /v1/linkedin
tomba sources	As páginas públicas onde um endereço foi encontrado	GET /v1/email-sources
tomba count	Endereços de um domínio, por departamento e senioridade	GET /v1/email-count
tomba status	Se um domínio é webmail ou descartável	GET /v1/domain-status
tomba format	Os padrões de endereço que um domínio usa	GET /v1/email-format
tomba location	O número de funcionários de uma empresa por localização	GET /v1/location
tomba autocomplete	Empresas e domínios a partir de parte de um nome	GET /v1/domain-suggestions
tomba phone-finder	Números de telefone a partir de um email, domínio ou perfil do LinkedIn	GET /v1/phone-finder
tomba phone-validator	Se um número de telefone é válido, seus formatos e a operadora	GET /v1/phone-validator
tomba reveal	Empresas a partir de uma consulta em linguagem natural ou de filtros	POST /v1/reveal/search
tomba similar	Empresas semelhantes a um domínio	GET /v1/similar
tomba technology	As tecnologias no site de um domínio	GET /v1/technology
tomba lead · leads-list · attribute	Gerencie leads, listas de leads e atributos personalizados	/v1/leads, /v1/leads_lists, /v1/attributes
tomba flag create · list	Reporte dados incorretos e liste seus relatos	POST /v1/flag, GET /v1/flag
tomba key list · get · create · delete	Gerencie as chaves de API do seu workspace	/v1/keys
tomba whoami · usage · logs	Sua conta, o uso diário e as requisições recentes	GET /v1/me, /v1/usage, /v1/logs

// 03 · em massa

Processe um CSV a partir da sua máquina

tomba bulk envia uma requisição de API por linha e grava os resultados em um novo CSV à medida que as linhas são concluídas. Cada linha é cobrada e limitada como uma requisição individual; para jobs no servidor, use a 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: Executa na sua máquina, uma requisição por linha, cada uma cobrada como uma chamada individual
POST /v1/bulk/{type}: Executa nos servidores da Tomba como um único job, cobrado no primeiro download

Referência da Bulk API

// 04 · entrar

Login pelo navegador ou uma chave de API

tomba login usa o fluxo de dispositivo do OAuth 2.0, então funciona via SSH; para scripts, entre com uma chave. As credenciais são salvas em ~/.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"

// perguntas frequentes

Perguntas sobre o Tomba CLI

Ainda tem dúvidas? Visite a central de ajuda