// get /v1/people/find
API Person
Récupérez les détails sociaux liés à une adresse email nom, localisation, genre, emploi, Twitter, LinkedIn, GitHub, Gravatar et statut de vérification. Un remplacement direct de l'API Clearbit Person.
1 search credit
// console api
ExempleExemple de réponse tiré de la référence de l'API
- name.fullName
- Richard Hendricks
- richard@piedpiper.com
- employment.name
- Pied Piper
- employment.title
- CEO
- employment.seniority
- executive
- location
- Palo Alto, California, United States
- verification.status
- valid
- phone
- true
// 01 · requête
Person Enrichment 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
/people/findemailobligatoire- Work email
curl -G https://api.tomba.io/v1/people/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/people/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/people/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
/people/finddata.nameobject- fullName, givenName, familyName
data.employmentobject- Company, domain, title, role, sub-role, seniority
data.location, data.geostring | null, object- Where the person is, as text and as city, state, country, coordinates
data.linkedin, data.twitter, data.github, data.facebookobject- Social handles (twitter and github with their public counts)
data.verificationobject- valid, accept_all, invalid or unknown, and the date of the check
data.phoneboolean- Tomba holds a phone number for the person
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 /people/find
200 OK· 1 search credit
{
"data": {
"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
},
"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
1search 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
Nom complet, email, localisation, genre, données géographiques, emploi (entreprise, titre, rôle, niveau hiérarchique), profils sociaux (LinkedIn, Twitter, GitHub, Facebook, Gravatar), statut de vérification email, disponibilité du téléphone et horodatages d'activité.
Oui. L'API Person est un remplacement direct de l'API Clearbit Person Enrichment, retournant des données compatibles à une fraction du coût.
1 crédit par recherche de personne. Les recherches échouées pour des emails inconnus ne sont pas facturées.
Les profils LinkedIn, Twitter/X, GitHub, Facebook et Gravatar lorsque disponibles.
Oui. Chaque réponse inclut le statut de vérification en temps réel (valide, invalide, catch-all) et la date de vérification.
13 SDK officiels : Python, Node.js, PHP, Ruby, Go, Dart, Lua, R et Elixir.
Les profils de personnes sont continuellement mis à jour. Chaque enregistrement inclut un horodatage indexedAt pour connaître la fraîcheur des données.