Clearbit
Migrate from Clearbit
Tomba's Person, Company, and Combined endpoints return Clearbit-style objects, so most migrations change the host, the authentication, and how you read the response envelope. Clearbit's API reference is no longer public; Clearbit behavior on these pages was checked on 2026-09-29 against its last public version (September 2024).
Endpoint mapping
| Clearbit | Tomba | Guide or notes |
|---|---|---|
GET https://person.clearbit.com/v2/people/find | GET https://api.tomba.io/v1/people/find | Person API |
GET https://company.clearbit.com/v2/companies/find | GET https://api.tomba.io/v1/companies/find | Company API |
GET https://person.clearbit.com/v2/combined/find | GET https://api.tomba.io/v1/combined/find | Combined API |
Streaming hosts person-stream.clearbit.com and company-stream.clearbit.com | The same Tomba endpoints | Every Tomba response is final. |
GET https://logo.clearbit.com/{domain} | https://logo.tomba.io/{domain} | No authentication. See Logo API. Clearbit's Logo API was shut down in December 2025 (HubSpot announcement). |
GET https://autocomplete.clearbit.com/v1/companies/suggest | GET /v1/domain-suggestions | Needs your key and secret, so call it from your server, not from a browser. |
GET https://company.clearbit.com/v1/domains/find (Name to Domain) | GET /v1/domain-suggestions | Returns a list of matches with name, domain, and email_count. |
POST https://person.clearbit.com/v1/people/{id}/flag, POST https://company.clearbit.com/v2/companies/flag | POST /v1/flag | Set flag_type to email or organization. |
GET https://discovery.clearbit.com/v1/companies/search | POST /v1/reveal/search | Uses Tomba's own filters. |
GET https://prospector.clearbit.com/v2/people/search | GET /v1/domain-search | Returns people and their addresses for one domain. |
Reveal (reveal.clearbit.com, IP address to company) | No equivalent | Tomba's /v1/reveal/search searches companies by filters; it doesn't resolve IP addresses. |
Risk (risk.clearbit.com) | No equivalent |
What changes for every endpoint
| Area | Clearbit | Tomba |
|---|---|---|
| Authentication | HTTP basic auth with the key as the username, or Authorization: Bearer | X-Tomba-Key and X-Tomba-Secret headers. See Authentication. |
| Response envelope | The object at the top level | The object in data, and the input in meta (meta.email or meta.domain) |
| Not found | 404 | 200 with an errors object: type not_found, code 404 |
| Disposable or webmail input | — | 200 with an errors object: type params_invalid, code 422 |
| Queued lookups | An empty 202: retry later or wait for the webhook | Never returned. Each request waits for its result; set your client timeout to at least 180 seconds. |
| Webhooks | webhook_url or an account-wide webhook, with a signed {id, type, status, body} payload | webhook_url on the Person and Combined endpoints only. Tomba still returns the result, and posts an unsigned copy of the response body. See Per-request callbacks. |
| Error body | {"error": {"type", "message"}} | {"errors": {"type", "message", "code"}}. See Errors. |
| Unfilled fields | null when unknown | Several Clearbit fields are always null. Each guide lists them. |
| Versioning | API-Version header | The /v1 path; there's no version header. |
| Billing | — | See Credit costs. Repeating a lookup within your usage window is free; see Duplicate requests. |
Last modified on