Vai al contenuto
Home page di Tomba
Inizia gratis

// piattaforma per sviluppatori

API Potente per l'Email Intelligence

Integra la ricerca, la verifica e l'arricchimento delle email nelle tue applicazioni. API RESTful con SDK per tutti i principali linguaggi.

Ottieni una chiave API gratuitaRiferimento API
api.tomba.io/v1X-Tomba-Key · X-Tomba-SecretOpenAPI 3
GETapi.tomba.io/v1/domain-search
Esempio
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 · endpoint

Ogni endpoint, il suo costo e la sua pagina di riferimento

REST su HTTPS, JSON in ingresso e in uscita, due header per l'autenticazione. URL di base https://api.tomba.io/v1.

GET/email-finderA person's work email from their name and company domainCosto:1 search creditAddebitato quando: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 profileCosto:1 search credit per 10 resultsAddebitato quando: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 checksCosto:1 verification creditAddebitato quando: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 profilesCosto:1 search creditAddebitato quando: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 URLCosto:1 search creditAddebitato quando: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 articleCosto:1 search creditAddebitato quando:An address is returned.
GET/phone-finderA person's phone number from their email, domain or LinkedIn URLCosto:5 search creditsAddebitato quando: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 regionCosto:1 search creditAddebitato quando:Every successful response, including one with no data.
POST/reveal/searchCompanies that match a plain-language query or filtersCosto:1 search creditAddebitato quando:At least one company is returned.
GET/combined/findThe person and their company from one email addressCosto:2 search creditsAddebitato quando:A person is returned.
GET/companies/findA company profile from its domain: industry codes, size, location, socialsCosto:1 search creditAddebitato quando:A company is returned.
GET/technologyThe technologies a website runs, by categoryCosto:FreeAddebitato quando:Not charged; needs a positive search balance.
GET/email-countHow many addresses Tomba holds for a domain, by department and seniorityCosto:1 email count creditAddebitato quando:Every call.
GET/similarCompanies similar to a domain, with their industryCosto:1 search credit per 10 resultsAddebitato quando:Results are returned. 1 credit per 10 results requested with limit.
GET/email-formatThe address patterns a company uses, with their shareCosto:1 email count creditAddebitato quando:Every successful call, including an empty result.
GET/locationWhere a company's people are, by countryCosto:1 email count creditAddebitato quando:Every successful call, including an empty result.
GET/people/findA person profile from a work email: name, employment, location, social handlesCosto:1 search creditAddebitato quando:A person is returned.
URL di base https://api.tomba.io/v1 · Invia X-Tomba-Key e X-Tomba-Secret con ogni richiesta.Tutti gli endpoint nel riferimento API

// 02 · in blocco

Job in blocco per liste fino a 25.000 righe

Invia con POST una lista, delle righe o un CSV a /bulk/, ricevi un webhook firmato quando termina e paga una sola volta al primo download.

Tipo di jobInputRighe max
POST/bulk/searchDomains or company names25,000
POST/bulk/similarDomains or company names5,000
POST/bulk/companyDomains or company names25,000
POST/bulk/finderNames, with a domain or company name10,000
POST/bulk/enrichEmail addresses20,000
POST/bulk/linkedinLinkedIn profile URLs20,000
POST/bulk/authorArticle URLs5,000
POST/bulk/verifierEmail addresses20,000
POST/bulk/phone-finderEmail addresses, LinkedIn URLs or domains10,000
POST/bulk/phone-validatorPhone numbers, with an optional country10,000

Scorri in orizzontale per vedere tutte le colonne

// 03 · limiti di frequenza

Throughput per piano

I limiti sono per account, su tutte le sue chiavi. I job in blocco hanno limiti propri.

// limiti di frequenza

Richieste al secondo / minuto / giorno
FreeBasicGrowthPro
Search, finder, similar, technology1 / 2 / 53 / 50 / 5005 / 80 / 1,0008 / 150 / 4,000
Email verifier1 / 2 / 102 / 40 / 5003 / 60 / 1,0005 / 100 / 4,000

Scorri in orizzontale per vedere tutte le colonne

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. Limiti di frequenza

// 04 · sdk e strumenti

13 SDK, una CLI e un server MCP

Le librerie ufficiali incapsulano gli stessi endpoint; la CLI e il server MCP usano la tua chiave o OAuth.

// faq

FAQ sulle API

Ha altre domande? Visita il centro assistenza

// avvio rapido

Fai la tua prima chiamata in un minuto

Account gratuito, vera chiave API, gli stessi endpoint usati dai clienti Enterprise.

  1. 01Crea un account gratuito25 crediti di ricerca ogni 30 giorni. Nessuna carta.
  2. 02Copia la chiave e il secretDa Chiavi API nella dashboard.
  3. 03Chiama l'APIIncolla la richiesta; la risposta è in JSON.
Ottieni una chiave API gratuitaLeggi la documentazione
curl -G https://api.tomba.io/v1/email-finder \
  --data-urlencode "domain=piedpiper.com" \
  --data-urlencode "first_name=Richard" \
  --data-urlencode "last_name=Hendricks" \
  -H "X-Tomba-Key: $TOMBA_API_KEY" \
  -H "X-Tomba-Secret: $TOMBA_SECRET_KEY"
Risposta
200 OK
{
  "data": {
    "email": "richard@piedpiper.com",
    "first_name": "Richard",
    "last_name": "Hendricks",
    "full_name": "Richard Hendricks",
    "website_url": "piedpiper.com",
    "company": "Pied Piper",
    "pattern": "{first}",
    "department": "executive",
    "type": "personal",
    "position": "CEO",
    "country": "US",
    "gender": "male",
    "twitter": null,
    "linkedin": "https://www.linkedin.com/in/richard-hendricks",
    "score": 100,
    "accept_all": false,
    "phone_number": true,
    "verification": {
      "date": "2025-01-15T10:32:00+01:00",
      "status": "valid"
    },
    "sources": [
      {
        "uri": "https://piedpiper.com/blog/engineering",
        "website_url": "piedpiper.com",
        "extracted_on": "2024-06-01T09:14:07+01:00",
        "last_seen_on": "2025-01-10T17:02:44+01:00",
        "still_on_page": true
      }
    ],
    "phone_data": []
  }
}