// get /v1/people/find
Person API
Получите социальные данные по email-адресу имя, местоположение, пол, место работы, Twitter, LinkedIn, GitHub, Gravatar и статус верификации. Замена Clearbit Person API.
1 search credit
// консоль api
ПримерПример ответа из справочника 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 · запрос
«Person Enrichment» — это один HTTPS-запрос
Отправьте параметры с вашим ключом и секретом. Все SDK, CLI и MCP-сервер выполняют этот же вызов.
GET
/people/findemailобязательный- 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 · ответ
Что возвращается
JSON, одинаковый на любом языке. Поля, которые Tomba не знает, равны null — без догадок.
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 · стоимость и лимиты
Сколько стоит вызов
Вызов оплачивается только при условии, указанном ниже. Лимиты запросов зависят от вашего тарифа.
// стоимость
1search credit
Когда списывается: A person is returned.
Ошибки, ответы 429 и 451, а также повтор того же запроса в пределах окна использования ничего не стоят.
Как работают кредиты// лимиты запросов
Запросов в секунду / минуту / день| 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 |
Прокрутите вбок, чтобы увидеть все столбцы
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. Лимиты запросов
Полное имя, email, местоположение, пол, геоданные, данные о работе (компания, должность, роль, уровень), социальные профили (LinkedIn, Twitter, GitHub, Facebook, Gravatar), статус верификации email, наличие телефона и временные метки активности.
Да. API персоны является полноценной заменой Clearbit Person Enrichment API, возвращая совместимые данные за долю стоимости.
1 кредит за поиск персоны. Неудачные поиски по неизвестным email не тарифицируются.
Профили LinkedIn, Twitter/X, GitHub, Facebook и Gravatar при наличии.
Да. Каждый ответ включает статус верификации в реальном времени (валидный, невалидный, catch-all) и дату верификации.
13 официальных SDK: C#, Dart, Deno, Elixir, Go, Lua, Node.js, Perl, PHP, Python, R, Ruby и Rust.
Профили персон постоянно обновляются. Каждая запись включает временную метку indexedAt, чтобы вы знали актуальность данных.