// plateforme développeur
API Puissante pour l'Intelligence Email
Intégrez la recherche, la vérification et l'enrichissement d'emails dans vos applications. API RESTful avec des SDK pour tous les principaux langages.
api.tomba.io/v1X-Tomba-Key · X-Tomba-SecretOpenAPI 3
ExempleExemple de réponse tiré de la référence de l'API
- organization.organization
- Pied Piper
- organization.industries
- computer software
- organization.company_size
- 11-50
- organization.pattern
- {first}
- organization.accept_all
- false
- emails
- 2 items
- emails[0].email
- dinesh@piedpiper.com
- emails[0].position
- Software Engineer
- emails[0].verification.status
- valid
// 01 · endpoints
Chaque endpoint, son coût et sa page de référence
REST sur HTTPS, JSON en entrée et en sortie, deux en-têtes pour l'authentification. URL de base https://api.tomba.io/v1.
EndpointCoûtFacturé quand
GET/email-finderA person's work email from their name and company domainCoût:1 search creditFacturé quand:An address is returned with a status other than unknown; 6 search credits instead of 1 with phone data (enrich_mobile).
GET/domain-searchThe email addresses at a company, with names, roles and the company profileCoût:1 search credit per 10 resultsFacturé quand:At least one address is returned. 1 credit per 10 results requested with limit.
GET/email-verifierWhether an address is deliverable: syntax, MX, SMTP, catch-all and greylisting checksCoût:1 verification creditFacturé quand:The status is not disposable or unknown. Phone numbers returned with enrich_mobile cost 5 search credits each, from the search allowance.
GET/enrichThe person behind an email address: name, role, company and profilesCoût:1 search creditFacturé quand:An address is returned with a status other than unknown; 6 search credits instead of 1 with phone data (enrich_mobile).
GET/linkedinThe work email of the person behind a LinkedIn profile URLCoût:1 search creditFacturé quand:An address is returned; 6 search credits instead of 1 with phone data (enrich_mobile).
GET/author-finderThe email of the person who wrote an articleCoût:1 search creditFacturé quand:An address is returned.
GET/phone-finderA person's phone number from their email, domain or LinkedIn URLCoût:5 search creditsFacturé quand:A valid number is returned; 1 search credit instead of 5 when you search by domain.
GET/phone-validatorWhether a phone number is valid, its line type, carrier and regionCoût:1 search creditFacturé quand:Every successful response, including one with no data.
POST/reveal/searchCompanies that match a plain-language query or filtersCoût:1 search creditFacturé quand:At least one company is returned.
GET/combined/findThe person and their company from one email addressCoût:2 search creditsFacturé quand:A person is returned.
GET/companies/findA company profile from its domain: industry codes, size, location, socialsCoût:1 search creditFacturé quand:A company is returned.
GET/technologyThe technologies a website runs, by categoryCoût:FreeFacturé quand:Not charged; needs a positive search balance.
GET/email-countHow many addresses Tomba holds for a domain, by department and seniorityCoût:1 email count creditFacturé quand:Every call.
GET/similarCompanies similar to a domain, with their industryCoût:1 search credit per 10 resultsFacturé quand:Results are returned. 1 credit per 10 results requested with limit.
GET/email-formatThe address patterns a company uses, with their shareCoût:1 email count creditFacturé quand:Every successful call, including an empty result.
GET/locationWhere a company's people are, by countryCoût:1 email count creditFacturé quand:Every successful call, including an empty result.
GET/people/findA person profile from a work email: name, employment, location, social handlesCoût:1 search creditFacturé quand:A person is returned.
URL de base
https://api.tomba.io/v1 · Envoyez X-Tomba-Key et X-Tomba-Secret avec chaque requête.Tous les endpoints dans la référence de l'API // 02 · en masse
Des tâches en masse pour des listes jusqu'à 25 000 lignes
Envoyez en POST une liste, des lignes ou un CSV à /bulk/, recevez un webhook signé à la fin, et payez une seule fois au premier téléchargement.
| Type de tâche | Entrée | Lignes max. | |
|---|---|---|---|
POST/bulk/search | Domains or company names | 25,000 | |
POST/bulk/similar | Domains or company names | 5,000 | |
POST/bulk/company | Domains or company names | 25,000 | |
POST/bulk/finder | Names, with a domain or company name | 10,000 | |
POST/bulk/enrich | Email addresses | 20,000 | |
POST/bulk/linkedin | LinkedIn profile URLs | 20,000 | |
POST/bulk/author | Article URLs | 5,000 | |
POST/bulk/verifier | Email addresses | 20,000 | |
POST/bulk/phone-finder | Email addresses, LinkedIn URLs or domains | 10,000 | |
POST/bulk/phone-validator | Phone numbers, with an optional country | 10,000 |
Faites défiler horizontalement pour voir toutes les colonnes
// 03 · limites de débit
Débit par offre
Les limites s'appliquent par compte, sur l'ensemble de ses clés. Les tâches en masse ont leurs propres limites.
// limites de débit
Requêtes par seconde / minute / jour| Free | Basic | Growth | Pro | |
|---|---|---|---|---|
| Search, finder, similar, technology | 1 / 2 / 5 | 3 / 50 / 500 | 5 / 80 / 1,000 | 8 / 150 / 4,000 |
| Email verifier | 1 / 2 / 10 | 2 / 40 / 500 | 3 / 60 / 1,000 | 5 / 100 / 4,000 |
Faites défiler horizontalement pour voir toutes les colonnes
Pro Plus, Scale and credit packs of 50,000 or more: no limit on these endpoints. Enterprise: no per-second or per-minute limit, 100,000 requests a day. Daily limits reset at 00:00 UTC. Limites de débit
// 04 · sdk et outils
13 SDK, une CLI et un serveur MCP
Les bibliothèques officielles encapsulent les mêmes endpoints ; la CLI et le serveur MCP utilisent votre clé ou OAuth.
- Python
pip install tomba-io - Node.js
npm install tomba - PHP
composer require tomba-io/php - Ruby
gem install tomba - Go
go get github.com/tomba-io/go - C#
dotnet add package Tomba - Rust
cargo add tomba - Deno
deno add jsr:@tomba/sdk - Dart
dart pub add tomba - Elixir
{:tomba, "~> 1.0"} - Lua
luarocks install tomba - Perl
cpanm Tomba::Finder - R
remotes::install_github("tomba-io/r")
Nous proposons des endpoints pour la recherche de domaine, la recherche d'email, la vérification d'email, la recherche d'auteur, l'enrichissement d'email, l'enrichissement d'entreprise, la recherche LinkedIn, la recherche de téléphone, la validation de téléphone et la recherche de domaines similaires.
Nous avons des SDK officiels pour C#, Dart, Deno, Elixir, Go, Lua, Node.js, Perl, PHP, Python, R, Ruby, Rust et C#. Tout langage capable d'effectuer des requêtes HTTP fonctionne avec notre API REST.
Les limites dépendent de l'endpoint et du plan. Avec le plan Free, la plupart des endpoints acceptent 1 requête par seconde et 5 à 20 par jour ; avec Pro, 5 à 8 par seconde et jusqu'à 4 000 par jour. Pro Plus et Scale n'ont aucune limite, et Enterprise autorise 100 000 requêtes par jour sans limite par seconde. GET /v1/rate-limits renvoie les limites de votre compte ; consultez Limites de débit.
Chaque requête nécessite deux en-têtes : X-Tomba-Key (votre clé API) et X-Tomba-Secret (votre secret API). Vous pouvez trouver les deux dans votre tableau de bord Tomba.
Oui. Le plan Free inclut 25 crédits de recherche tous les 30 jours, sans carte bancaire.
Oui, nous avons des endpoints dédiés au traitement en masse pour la recherche de domaine, la recherche d'email, la vérification d'email et plus encore. Téléchargez des fichiers CSV ou envoyez des requêtes par lot pour le traitement à haut volume.
Toutes les réponses API sont retournées au format JSON. Chaque réponse inclut les données demandées ainsi que des métadonnées comme les informations de limite de requêtes et le statut de la requête.
Oui, Tomba est entièrement conforme au RGPD. Toutes les données proviennent d'informations publiquement disponibles et nous fournissons des mécanismes permettant aux personnes concernées de demander la suppression de leurs données.