// tomba cli

Intelligence email depuis votre terminal

Recherchez des domaines, trouvez des emails, verifiez des adresses et enrichissez des contacts, le tout sans quitter votre terminal. Installation en une seule commande. Compatible macOS, Linux et Windows.

Installer Tomba CLI Voir sur GitHub

macOS · Linux · WindowsSortie JSON, YAML ou CSVConnexion OAuth par appareil

zsh

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

// 01 · installation

Un seul binaire pour macOS, Linux et Windows

Les scripts d'installation vérifient la somme de contrôle SHA-256 de la version et configurent l'autocomplétion du shell. Les versions sont publiées sur 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 · commandes

Chaque endpoint depuis le terminal

Passez l'entrée avec --target ; ajoutez --json, --yaml ou --csv pour une sortie lisible par machine et --output pour écrire un fichier.

tomba search
Les adresses e-mail que Tomba connaît pour un domaine
GET /v1/domain-search
tomba finder
L'e-mail d'une personne à partir de son nom et du domaine de son entreprise
GET /v1/email-finder
tomba author
L'e-mail de l'auteur d'un article
GET /v1/author-finder
tomba enrich
La personne derrière une adresse e-mail
GET /v1/enrich
tomba enrichment person
Le profil d'une personne à partir d'un e-mail
GET /v1/people/find
tomba enrichment company
Le profil d'une entreprise à partir d'un domaine
GET /v1/companies/find
tomba enrichment combined
La personne et l'entreprise en une seule requête
GET /v1/combined/find
tomba verify
Si une adresse e-mail est délivrable
GET /v1/email-verifier
tomba linkedin
L'e-mail d'un profil LinkedIn
GET /v1/linkedin
tomba sources
Les pages publiques où une adresse a été trouvée
GET /v1/email-sources
tomba count
Les adresses d'un domaine, par service et niveau hiérarchique
GET /v1/email-count
tomba status
Si un domaine est un webmail ou jetable
GET /v1/domain-status
tomba format
Les formats d'adresse qu'utilise un domaine
GET /v1/email-format
tomba location
Les effectifs d'une entreprise par localisation
GET /v1/location
tomba autocomplete
Des entreprises et domaines à partir d'une partie d'un nom
GET /v1/domain-suggestions
tomba phone-finder
Des numéros de téléphone à partir d'un e-mail, d'un domaine ou d'un profil LinkedIn
GET /v1/phone-finder
tomba phone-validator
Si un numéro de téléphone est valide, ses formats et son opérateur
GET /v1/phone-validator
tomba reveal
Des entreprises à partir d'une requête en langage naturel ou de filtres
POST /v1/reveal/search
tomba similar
Des entreprises similaires à un domaine
GET /v1/similar
tomba technology
Les technologies du site web d'un domaine
GET /v1/technology
tomba lead · leads-list · attribute
Gérez les leads, les listes de leads et les attributs personnalisés
/v1/leads, /v1/leads_lists, /v1/attributes
tomba flag create · list
Signalez des données erronées et listez vos signalements
POST /v1/flag, GET /v1/flag
tomba key list · get · create · delete
Gérez les clés API de votre espace de travail
/v1/keys
tomba whoami · usage · logs
Votre compte, votre consommation du jour et vos requêtes récentes
GET /v1/me, /v1/usage, /v1/logs

Commande	Renvoie	Appelle
tomba search	Les adresses e-mail que Tomba connaît pour un domaine	GET /v1/domain-search
tomba finder	L'e-mail d'une personne à partir de son nom et du domaine de son entreprise	GET /v1/email-finder
tomba author	L'e-mail de l'auteur d'un article	GET /v1/author-finder
tomba enrich	La personne derrière une adresse e-mail	GET /v1/enrich
tomba enrichment person	Le profil d'une personne à partir d'un e-mail	GET /v1/people/find
tomba enrichment company	Le profil d'une entreprise à partir d'un domaine	GET /v1/companies/find
tomba enrichment combined	La personne et l'entreprise en une seule requête	GET /v1/combined/find
tomba verify	Si une adresse e-mail est délivrable	GET /v1/email-verifier
tomba linkedin	L'e-mail d'un profil LinkedIn	GET /v1/linkedin
tomba sources	Les pages publiques où une adresse a été trouvée	GET /v1/email-sources
tomba count	Les adresses d'un domaine, par service et niveau hiérarchique	GET /v1/email-count
tomba status	Si un domaine est un webmail ou jetable	GET /v1/domain-status
tomba format	Les formats d'adresse qu'utilise un domaine	GET /v1/email-format
tomba location	Les effectifs d'une entreprise par localisation	GET /v1/location
tomba autocomplete	Des entreprises et domaines à partir d'une partie d'un nom	GET /v1/domain-suggestions
tomba phone-finder	Des numéros de téléphone à partir d'un e-mail, d'un domaine ou d'un profil LinkedIn	GET /v1/phone-finder
tomba phone-validator	Si un numéro de téléphone est valide, ses formats et son opérateur	GET /v1/phone-validator
tomba reveal	Des entreprises à partir d'une requête en langage naturel ou de filtres	POST /v1/reveal/search
tomba similar	Des entreprises similaires à un domaine	GET /v1/similar
tomba technology	Les technologies du site web d'un domaine	GET /v1/technology
tomba lead · leads-list · attribute	Gérez les leads, les listes de leads et les attributs personnalisés	/v1/leads, /v1/leads_lists, /v1/attributes
tomba flag create · list	Signalez des données erronées et listez vos signalements	POST /v1/flag, GET /v1/flag
tomba key list · get · create · delete	Gérez les clés API de votre espace de travail	/v1/keys
tomba whoami · usage · logs	Votre compte, votre consommation du jour et vos requêtes récentes	GET /v1/me, /v1/usage, /v1/logs

// 03 · en masse

Traitez un CSV depuis votre machine

tomba bulk envoie une requête API par ligne et écrit les résultats dans un nouveau CSV au fur et à mesure. Chaque ligne est facturée et soumise aux limites de débit comme une requête unique ; pour des tâches côté serveur, utilisez la 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: S'exécute sur votre machine, une requête par ligne, chacune facturée comme un appel unique
POST /v1/bulk/{type}: S'exécute sur les serveurs de Tomba en une seule tâche, facturée au premier téléchargement

Référence de la Bulk API

// 04 · connexion

Connexion par navigateur ou par clé API

tomba login utilise le flux d'appareil OAuth 2.0 et fonctionne donc via SSH ; pour les scripts, connectez-vous avec une clé. Les identifiants sont enregistrés dans ~/.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"

// faq

Questions sur Tomba CLI

D'autres questions ? Consultez le centre d'aide