Que retourne l'API Combined ?

Une réponse unique contenant les données de la personne (nom, localisation, emploi, profils sociaux, vérification) et les données de l'entreprise (firmographie, stack technologique, WHOIS, SIC/NAICS, métriques, profils sociaux) pour l'adresse email.

Est-ce un remplacement de Clearbit ?

Oui. L'API Combined est un remplacement direct de l'API Clearbit Combined Enrichment. Un email en entrée, données personne + entreprise en sortie.

Combien de crédits par recherche ?

2 crédits de recherche par recherche qui renvoie une personne, pour la personne et l'entreprise en un seul appel. Les recherches qui ne trouvent personne sont gratuites.

Que se passe-t-il si l'entreprise n'est pas trouvée ?

L'objet personne est quand même retourné. L'objet entreprise sera null si aucune donnée d'entreprise n'est disponible pour le domaine de l'email.

Quels profils sociaux sont inclus ?

Personne : LinkedIn, Twitter, GitHub, Facebook, Gravatar. Entreprise : LinkedIn, Twitter, Facebook.

Quels SDK sont disponibles ?

13 SDK officiels : Python, Node.js, PHP, Ruby, Go, Dart, Lua, R et Elixir.

Quelle est la fraîcheur des données ?

Les enregistrements personne et entreprise incluent des horodatages indexedAt. Les données sont continuellement mises à jour depuis notre exploration de 2B+ pages web par mois.

// get /v1/combined/find

API Combined

Obtenez les données de la personne et de l'entreprise à partir d'une seule adresse email profils sociaux, emploi, firmographie, stack technologique et métriques commerciales en un seul appel API. Un remplacement direct de l'API Clearbit Combined.

Obtenir une clé API gratuite Référence de l'API

2 search credits

// console api

ExempleExemple de réponse tiré de la référence de l'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 · requête

Person + Company tient en une requête HTTPS

Envoyez les paramètres avec votre clé et votre secret. Chaque SDK, la CLI et le serveur MCP effectuent ce même appel.

GET/combined/find

emailobligatoire: 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 · réponse

Ce qui est renvoyé

Du JSON, identique dans tous les langages. Les champs que Tomba ne connaît pas valent null, jamais une supposition.

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 · coût et limites

Ce que coûte un appel

Un appel n'est facturé que dans la condition ci-dessous. Les limites de débit dépendent de votre offre.

// coût

2search credit

Facturé quand: A person is returned.

Les erreurs, les réponses 429 et 451, ainsi que la même requête répétée dans votre fenêtre d'utilisation ne coûtent rien.

Comment fonctionnent les crédits

// 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

// faq

Questions sur l'API Combined

D'autres questions ? Consultez le centre d'aide

API Combined

Person + Company tient en une requête HTTPS

Ce qui est renvoyé

Ce que coûte un appel

Endpoints associés

Questions sur l'API Combined

Découvrez qui Tomba trouve dans n'importe quelle entreprise