Что возвращает комбинированный API?

Единый ответ, содержащий данные о персоне (имя, местоположение, работа, социальные профили, верификация) и данные о компании (фирмографика, технологический стек, WHOIS, SIC/NAICS, метрики, социальные профили) для email-адреса.

Это замена Clearbit?

Да. Комбинированный API является полноценной заменой Clearbit Combined Enrichment API. Один email на вход, данные о персоне + компании на выходе.

Сколько кредитов за поиск?

2 кредита поиска за запрос, который возвращает человека: данные о человеке и компании в одном вызове. Запросы, которые никого не находят, бесплатны.

Что если компания не найдена?

Объект персоны всё равно возвращается. Объект компании будет null, если данные о компании для домена email недоступны.

Какие социальные профили включены?

Персона: LinkedIn, Twitter, GitHub, Facebook, Gravatar. Компания: LinkedIn, Twitter, Facebook.

Какие SDK доступны?

13 официальных SDK: C#, Dart, Deno, Elixir, Go, Lua, Node.js, Perl, PHP, Python, R, Ruby и Rust.

Насколько актуальны данные?

Записи персон и компаний включают временные метки indexedAt. Данные постоянно обновляются из нашего обхода 2B+ веб-страниц ежемесячно.

// get /v1/combined/find

Combined API

Получите данные о персоне и компании по одному email-адресу социальные профили, данные о работе, фирмографику, технологический стек и бизнес-метрики одним API-запросом. Замена Clearbit Combined API.

Получить бесплатный API-ключ Справочник API

2 search credits

// консоль api

ПримерПример ответа из справочника 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 · запрос

«Person + Company» — это один HTTPS-запрос

Отправьте параметры с вашим ключом и секретом. Все SDK, CLI и MCP-сервер выполняют этот же вызов.

GET/combined/find

emailобязательный: 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 · ответ

Что возвращается

JSON, одинаковый на любом языке. Поля, которые Tomba не знает, равны null — без догадок.

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 · стоимость и лимиты

Сколько стоит вызов

Вызов оплачивается только при условии, указанном ниже. Лимиты запросов зависят от вашего тарифа.

// стоимость

2search 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. Лимиты запросов

// faq

Вопросы о Combined API

Остались вопросы? Перейти в справочный центр

Combined API

«Person + Company» — это один HTTPS-запрос

Что возвращается

Сколько стоит вызов

Связанные эндпоинты

Вопросы о Combined API

Узнайте, кого Tomba найдёт в любой компании