Cosa restituisce l'API Combined?

Una singola risposta contenente sia i dati persona (nome, posizione, impiego, profili social, verifica) che i dati aziendali (dati firmografici, stack tecnologico, WHOIS, SIC/NAICS, metriche, profili social) per l'indirizzo email.

E un sostituto di Clearbit?

Si. L'API Combined e un sostituto diretto dell'API Clearbit Combined Enrichment. Un'email in ingresso, dati persona + azienda in uscita.

Quanti crediti per ricerca?

2 crediti di ricerca per ogni ricerca che restituisce una persona, per la persona e l'azienda in una sola chiamata. Le ricerche che non trovano nessuno sono gratuite.

Cosa succede se l'azienda non viene trovata?

L'oggetto persona viene comunque restituito. L'oggetto azienda sara null se non sono disponibili dati aziendali per il dominio dell'email.

Quali profili social sono inclusi?

Persona: LinkedIn, Twitter, GitHub, Facebook, Gravatar. Azienda: LinkedIn, Twitter, Facebook.

Quali SDK sono disponibili?

13 SDK ufficiali: Python, Node.js, PHP, Ruby, Go, Dart, Lua, R ed Elixir.

Quanto sono aggiornati i dati?

Sia i record persona che azienda includono timestamp indexedAt. I dati vengono aggiornati continuamente dal nostro crawl di oltre 2 miliardi di pagine web al mese.

// get /v1/combined/find

Combined API

Ottieni dati sulla persona e sull'azienda da un singolo indirizzo email profili social, impiego, dati firmografici, stack tecnologico e metriche aziendali in una sola chiamata API. Un sostituto diretto dell'API Clearbit Combined.

Ottieni una chiave API gratuita Riferimento API

2 search credits

// console api

EsempioEsempio di risposta dal riferimento API

person.name.fullName: Richard Hendricks
person.employment.title: CEO
person.verification.status: valid
company.name: Pied Piper
company.category.industry: Internet Software & Services
company.geo.city: Palo Alto
company.metrics.employees: 11-50
company.foundedYear: 2014

// 01 · richiesta

Person + Company è una sola richiesta HTTPS

Invia i parametri con la tua chiave e il tuo secret. Ogni SDK, la CLI e il server MCP fanno questa stessa chiamata.

GET/combined/find

emailobbligatorio: Work email

GET /combined/find

curl -G https://api.tomba.io/v1/combined/find \
  --data-urlencode "email=richard@piedpiper.com" \
  -H "X-Tomba-Key: $TOMBA_API_KEY" \
  -H "X-Tomba-Secret: $TOMBA_SECRET_KEY"

const params = new URLSearchParams({
  email: "richard@piedpiper.com"
});
const res = await fetch(`https://api.tomba.io/v1/combined/find?${params}`, {
  headers: {
    "X-Tomba-Key": process.env.TOMBA_API_KEY,
    "X-Tomba-Secret": process.env.TOMBA_SECRET_KEY
  }
});
const { data } = await res.json();

import os, requests

res = requests.get(
    "https://api.tomba.io/v1/combined/find",
    params={
        "email": "richard@piedpiper.com",
    },
    headers={
        "X-Tomba-Key": os.environ["TOMBA_API_KEY"],
        "X-Tomba-Secret": os.environ["TOMBA_SECRET_KEY"],
    },
)
data = res.json()["data"]

// 02 · risposta

Cosa ricevi

JSON, uguale in ogni linguaggio. I campi che Tomba non conosce sono null, mai indovinati.

GET/combined/find

data.personobject: Name, employment, location, social handles, verification (as in Person Enrichment)
data.person.employmentobject: Company, domain, title, role, seniority
data.companyobject: Name, industry codes, location, metrics, tech (as in Company Enrichment)
data.company.categoryobject: Sector, industry, SIC and NAICS codes
meta.emailstring: The address you sent
errorsobject: When nothing is found the response is still 200, with errors {type, message, code} instead of data

GET /combined/find

200 OK· 2 search credits

{
  "data": {
    "person": {
      "name": {
        "fullName": "Richard Hendricks",
        "givenName": "Richard",
        "familyName": "Hendricks"
      },
      "email": "richard@piedpiper.com",
      "location": "Palo Alto, California, United States",
      "gender": "male",
      "timeZone": "America/Los_Angeles",
      "utcOffset": -8,
      "geo": {
        "city": "Palo Alto",
        "state": "California",
        "stateCode": "CA",
        "country": "United States",
        "countryCode": "US",
        "lat": 37.4419,
        "lng": -122.143
      },
      "bio": "Founder of Pied Piper.",
      "site": "https://piedpiper.com",
      "avatar": null,
      "employment": {
        "domain": "piedpiper.com",
        "name": "Pied Piper",
        "title": "CEO",
        "role": "executive",
        "subRole": null,
        "seniority": "executive"
      },
      "facebook": {
        "handle": null
      },
      "github": {
        "handle": null,
        "id": null,
        "avatar": null,
        "company": null,
        "blog": null,
        "followers": null,
        "following": null
      },
      "twitter": {
        "handle": null,
        "id": null,
        "bio": null,
        "followers": null,
        "following": null,
        "statuses": null,
        "favorites": null,
        "location": null,
        "site": null,
        "avatar": null
      },
      "linkedin": {
        "handle": "in/richard-hendricks"
      },
      "gravatar": {
        "handle": null,
        "urls": null,
        "avatar": null,
        "avatars": null
      },
      "verification": {
        "date": "2025-01-15T10:32:00+01:00",
        "status": "valid"
      },
      "phone": true,
      "fuzzy": false,
      "emailProvider": "Google",
      "indexedAt": "2025-01-15T10:32:00+01:00",
      "activeAt": "2025-01-15T10:32:00+01:00",
      "inactiveAt": null
    },
    "company": {
      "name": "Pied Piper",
      "legalName": "Pied Piper, Inc.",
      "domain": "piedpiper.com",
      "domainAliases": [],
      "site": {
        "phoneNumbers": [],
        "emailAddresses": [
          "hello@piedpiper.com"
        ]
      },
      "category": {
        "sector": "Information Technology",
        "industryGroup": "Software & Services",
        "industry": "Internet Software & Services",
        "subIndustry": "Internet Software & Services",
        "sicCode": "73",
        "sic4Codes": [
          "7372"
        ],
        "naicsCode": "51",
        "naics6Codes": [
          "511210"
        ],
        "naics6Codes2022": [
          "513210"
        ]
      },
      "tags": [
        "Compression",
        "Decentralized internet"
      ],
      "description": "Middle-out compression for files and video.",
      "foundedYear": "2014",
      "location": "5230 Newell Road, Palo Alto, CA 94303, United States",
      "timeZone": "America/Los_Angeles",
      "utcOffset": -8,
      "geo": {
        "streetNumber": "5230",
        "streetName": "Newell Road",
        "subPremise": null,
        "streetAddress": "5230 Newell Road",
        "city": "Palo Alto",
        "postalCode": "94303",
        "state": "California",
        "stateCode": "CA",
        "country": "United States",
        "countryCode": "US",
        "lat": 37.4419,
        "lng": -122.143
      },
      "logo": "https://logo.tomba.io/piedpiper.com",
      "facebook": {
        "handle": null,
        "likes": null
      },
      "linkedin": {
        "handle": "company/pied-piper"
      },
      "twitter": {
        "handle": null,
        "id": null,
        "bio": null,
        "followers": null,
        "following": null,
        "location": null,
        "site": null,
        "avatar": null
      },
      "whois": {
        "registrar_name": null,
        "created_date": null,
        "referral_url": null
      },
      "emailProvider": "Google",
      "type": "private",
      "ticker": null,
      "identifiers": {
        "usEIN": null
      },
      "metrics": {
        "alexaUsRank": null,
        "alexaGlobalRank": null,
        "trafficRank": null,
        "employees": "11-50",
        "marketCap": null,
        "raised": null,
        "annualRevenue": null,
        "estimatedAnnualRevenue": null,
        "fiscalYearEnd": null
      },
      "indexedAt": "2025-01-15T10:32:00+01:00",
      "tech": [
        "google_apps",
        "intercom"
      ],
      "techCategories": [
        "email_hosting_service",
        "live_chat"
      ],
      "parent": {
        "domain": null
      },
      "ultimateParent": {
        "domain": null
      }
    }
  },
  "meta": {
    "email": "richard@piedpiper.com"
  }
}

// 03 · costi e limiti

Quanto costa una chiamata

Una chiamata viene addebitata solo alla condizione indicata sotto. I limiti di frequenza dipendono dal tuo piano.

// costo

2search credit

Addebitato quando: A person is returned.

Errori, risposte 429 e 451 e la stessa richiesta ripetuta entro la tua finestra di utilizzo non costano nulla.

Come funzionano i crediti

// limiti di frequenza

Richieste al secondo / minuto / giorno

	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

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

// faq

Domande sulla Combined API

Ha altre domande? Visita il centro assistenza

Combined API

Person + Company è una sola richiesta HTTPS

Cosa ricevi

Quanto costa una chiamata

Endpoint correlati

Domande sulla Combined API

Scopri chi trova Tomba in qualsiasi azienda