TombaTomba
Start free
  • Documentation
  • API reference
  • SDKs & CLI
  • AI & MCP
  • Integrations
  • Enterprise
  • Migration guides

Find, verify and enrich B2B contacts from public sources, in the app, your spreadsheet or through the API.

GDPR & CCPA

// docs

  • API changelog
  • Support options
  • Security

// platform

  • Dashboard
  • Pricing
  • API status

// resources

  • Help center
  • Product updates
  • TombaBot crawler

// company

  • Website
  • Contact us
  • Edit or remove your data

© 2021–2026 Tomba.io

  • Terms of service
  • Privacy policy
  • Cookie policy
  • Security policy
  • GDPR
  • CCPA
Clearbit
    OverviewCompany APIPerson APICombined API
Email verifiers
Email finders
Phone finders
Clearbit

Migrate from the Clearbit Company API

This guide maps Clearbit's Company API (GET https://company.clearbit.com/v2/companies/find) to Tomba's GET /v1/companies/find, which returns a Clearbit-style company object. Clearbit behavior checked on 2026-09-29 against the last public Clearbit API reference (September 2024).

Before you begin

  • Get your API key (ta_…) and secret (ts_…); see Authentication.
  • Check what a lookup costs in Credit costs and your plan's throttling in Limits by plan.
  • Read Migrate from Clearbit for the changes shared by every Clearbit endpoint.

Endpoint mapping

ClearbitTomba
GET https://company.clearbit.com/v2/companies/find?domain=GET https://api.tomba.io/v1/companies/find?domain=
GET https://company-stream.clearbit.com/v1/companies/domain/{domain}GET https://api.tomba.io/v1/companies/find?domain={domain}
POST https://company.clearbit.com/v2/companies/flag?domain=POST /v1/flag with flag_type organization

Authentication changes

Clearbit takes the key as the basic auth username or as a bearer token. Tomba needs two headers, X-Tomba-Key and X-Tomba-Secret:

TerminalCode
# Clearbit curl "https://company.clearbit.com/v2/companies/find?domain=stripe.com" \ -u "$CLEARBIT_API_KEY:" # Tomba curl "https://api.tomba.io/v1/companies/find?domain=stripe.com" \ -H "X-Tomba-Key: $TOMBA_API_KEY" \ -H "X-Tomba-Secret: $TOMBA_SECRET_KEY"

Tomba API keys expire; plan their rotation with Key expiry.

Parameter mapping

ClearbitTombaNotes
domaindomainRequired.
webhook_url, webhook_idNo equivalent/v1/companies/find doesn't send callbacks.
company_name, linkedin, twitter, facebookNo equivalentTomba looks up by domain only.
API-Version headerNo equivalent

Response field mapping

Tomba returns the company in data and the domain you looked up in meta.domain. Every field in Clearbit's reference is listed below; "Always null" means Tomba returns the key but never fills it. Field definitions are in Enrichment.

ClearbitTombaNotes
idNo equivalent
name, domain, description, tags, indexedAtSame paths in data
legalNamedata.legalNameThe same value as name.
domainAliasesdata.domainAliasesAlways null.
site.phoneNumbers, site.emailAddressesSame pathssite.emailAddresses lists up to six generic addresses Tomba found for the domain, such as info@.
category.sector, industryGroup, industry, subIndustrySame pathsAlways null. GET /v1/domain-search returns the industry in data.organization.industries.
category.gicsCodeNo equivalent
category.sicCode, sic4Codes, naicsCode, naics6Codes, naics6Codes2022Same paths
foundedYeardata.foundedYearA string, such as "2010", instead of an integer.
locationdata.locationThe two-letter country code, not the full address.
timeZone, utcOffsetSame pathsAlways null.
geo.streetAddress, city, postalCode, state, country, countryCodeSame paths
geo.streetNumber, geo.streetNameSame pathsBoth hold the full street address, the same value as geo.streetAddress.
geo.stateCodedata.geo.stateCodeHolds the same value as geo.state.
geo.subPremise, lat, lngSame pathsAlways null.
logodata.logoAlways null. Use https://logo.tomba.io/{domain}; see Logo API.
facebook.handle, twitter.handleSame paths
facebook.likesdata.facebook.likesAlways null.
linkedin.handledata.linkedin.handleWithout Clearbit's company/ prefix.
twitter.id, bio, followers, following, location, site, avatarSame pathsAlways null.
crunchbase.handleNo equivalent
emailProviderdata.emailProviderThe name of the domain's mail provider, such as Google, instead of a boolean.
typedata.typeTomba's company types differ from Clearbit's; see Company attributes.
ticker, identifiers.usEINSame pathsAlways null.
phoneNo equivalentUse data.site.phoneNumbers.
metrics.employeesRangedata.metrics.employeesA range string, such as 1001-5000. Tomba's ranges differ from Clearbit's.
metrics.employeesNo equivalentTomba's metrics.employees holds a range, not a count.
metrics.annualRevenue, metrics.estimatedAnnualRevenueSame pathsBoth hold the same string.
metrics.trafficRankdata.metrics.trafficRankA numeric rank as a string, instead of Clearbit's very_high to very_low values.
metrics.alexaUsRank, alexaGlobalRank, marketCap, raised, fiscalYearEndSame pathsAlways null.
tech, techCategoriesSame pathsTechnology and category names.
parent.domain, ultimateParent.domainSame pathsAlways null.

Tomba also returns data.whois, with the domain's registrar_name, created_date, and referral_url.

Error mapping

ClearbitTombaWhat to do
202 lookup queuedNot returnedRemove the retry-on-202 logic.
404 company not found200 with an errors object: type not_found, code 404Check the body for errors, not only the status.
422 invalid domain422 params_invalid for a malformed domain. A disposable or webmail domain returns 200 with an errors object: type params_invalid, code 422.Send the company's own domain.
401 invalid API key400 authentication_failed (missing or malformed), 400 api_key_expired, 401 authentication_failed (wrong key or secret)Check both headers; rotate an expired key.
402 over quota402 quota_exceededWait for your usage window to renew or add credits.
429 rate limit429 rate_limitRetry after the Retry-After delay; see Handle 429 responses.
50X500 api_errorRetry with backoff.

Error responses don't consume credits. Every type is listed in Errors.

Bulk and async jobs

Tomba answers every company lookup synchronously and sends no callback for it, so remove 202 retries and webhook handlers. To enrich a list of domains, run a bulk job of type company with a newline-separated list:

TerminalCode
curl -X POST "https://api.tomba.io/v1/bulk/company" \ -H "X-Tomba-Key: $TOMBA_API_KEY" \ -H "X-Tomba-Secret: $TOMBA_SECRET_KEY" \ -H "Content-Type: application/json" \ -d '{"name": "Target accounts", "list": "stripe.com\nshopify.com"}'

Launch the job, poll its progress, and download the results as CSV, as shown in Lifecycle. The CSV doesn't follow Clearbit's JSON shape. A job is charged when you first download its results; see Billing.

Code example

This function replaces a Company API lookup. It returns the Clearbit-style company object, or null when Tomba has no record, and fills logo with Tomba's logo URL. It needs Node.js 18 or later.

Code
const TOMBA_HEADERS = { "X-Tomba-Key": process.env.TOMBA_API_KEY, "X-Tomba-Secret": process.env.TOMBA_SECRET_KEY, }; async function findCompany(domain) { const url = new URL("https://api.tomba.io/v1/companies/find"); url.searchParams.set("domain", domain); const res = await fetch(url, { headers: TOMBA_HEADERS }); const body = await res.json(); if (body.errors) { // Unknown, disposable, and webmail domains come back as HTTP 200 with an errors object. if (res.ok) return null; throw new Error( `${res.status} ${body.errors.type}: ${body.errors.message}`, ); } const company = body.data; company.logo = `https://logo.tomba.io/${company.domain}`; return company; } const company = await findCompany("stripe.com"); console.log(company?.name, company?.metrics.employees, company?.logo);

Cutover checklist

  1. Store the Tomba key and secret as TOMBA_API_KEY and TOMBA_SECRET_KEY, and send them as X-Tomba-Key and X-Tomba-Secret instead of basic auth or a bearer token.
  2. Call https://api.tomba.io/v1/companies/find and read the company from data.
  3. Treat a 200 response with an errors object as not found, and remove 202 retries and webhook handling.
  4. Update code that depends on fields Tomba formats differently (foundedYear, location, emailProvider, type, metrics, linkedin.handle) or leaves null, and build logo URLs on logo.tomba.io.
  5. Handle 402, and retry 429 after Retry-After.
  6. Look up the same sample of domains with both services and compare the fields you use before you switch production traffic.
Last modified on September 30, 2026
OverviewPerson API
On this page
  • Before you begin
  • Endpoint mapping
  • Authentication changes
  • Parameter mapping
  • Response field mapping
  • Error mapping
  • Bulk and async jobs
  • Code example
  • Cutover checklist
Javascript