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
Email verifiers
Email finders
    OverviewHunterSnov.ioProspeoFindymailApollo.ioVoila NorbertSkrapp
Phone finders
Email finders

Migrate from Snov.io

This guide maps the Snov.io API (the v2 email finder, domain search, email verifier, LinkedIn profile, and company domain methods, and the v1 email count, profile, and balance methods) to Tomba. Snov.io API behavior checked on 2026-09-29 against the Snov.io API reference.

Before you begin

  • Get your API key (ta_…) and secret (ts_…); see Authentication.
  • Check what each endpoint costs in Credit costs and your plan's throttling in Limits by plan.
  • Snov.io's v2 methods are asynchronous: you start a task, then fetch its result with the task_hash. Tomba returns the result in the response, so each start and result pair becomes one request. Set your HTTP client timeout to at least 180 seconds.

Endpoint mapping

Replace the host api.snov.io with api.tomba.io.

Snov.ioTombaNotes
POST /v1/oauth/access_tokenNo equivalentSend the key and secret on every request.
POST /v2/emails-by-domain-by-name/start, GET /v2/emails-by-domain-by-name/resultGET /v1/email-finderOne person per request.
POST /v2/domain-search/start, GET /v2/domain-search/result/{task_hash}GET /v1/domain-searchCompany details are in data.organization.
POST /v2/domain-search/prospects/start and .../prospects/search-emails/start/{prospect_hash}, with their resultsGET /v1/domain-searchReturns people and their addresses in one response.
POST /v2/domain-search/domain-emails/start, with its resultGET /v1/domain-search
POST /v2/domain-search/generic-contacts/start, with its resultGET /v1/domain-search with type=generic
POST /v2/email-verification/start, GET /v2/email-verification/resultGET /v1/email-verifierOne address per request.
POST /v2/li-profiles-by-urls/start, with its resultGET /v1/linkedinOne profile per request. Returns the person's email address with their name and position.
POST /v2/company-domain-by-name/start, with its resultGET /v1/domain-suggestionsOne name per request.
POST /v1/get-domain-emails-countGET /v1/email-count
POST /v1/get-profile-by-emailGET /v1/enrich
GET /v1/get-balanceGET /v1/meSee Check usage.

Authentication changes

Snov.io exchanges a client ID and secret for an access token that lasts one hour, then sends it as a bearer token. Tomba has no token exchange: send the key and secret as X-Tomba-Key and X-Tomba-Secret on every request.

TerminalCode
# Snov.io: get an access token curl -X POST "https://api.snov.io/v1/oauth/access_token" \ -d "grant_type=client_credentials" \ -d "client_id=$SNOV_CLIENT_ID" \ -d "client_secret=$SNOV_CLIENT_SECRET" # Tomba: send the key and secret with the request curl "https://api.tomba.io/v1/email-finder?domain=stripe.com&first_name=Jane&last_name=Doe" \ -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

Snov.io method and fieldTomba parameterNotes
Email finder rows[].first_name, rows[].last_namefirst_name, last_nameSend one person per request, or use a bulk finder job for lists.
Email finder rows[].domaindomainTomba also accepts a company name as company.
Domain search domaindomain
Prospects positions[]No equivalentdepartment filters by department from a fixed list; see the API reference.
Prospects pagepage
Email verifier emails[]emailSend one address per request, or use a bulk verifier job for lists.
LinkedIn profiles urls[]url
Company domain names[]query
Email count domaindomain
Profile by email emailemail
webhook_urlwebhook_urlTomba still returns the result in the response, and also posts it to your URL when the result qualifies. See Per-request callbacks.
task_hashNo equivalent

Response field mapping

Tomba wraps every result in data.

Snov.ioTombaNotes
Result status (completed, in_progress)No equivalentEvery Tomba response is final.
Finder data[].peopledata.full_name
Finder data[].result[].emaildata.emailnull when no address is found.
Finder and verifier smtp_statusFinder data.verification.status; verifier data.email.statusSee Status mapping.
Verifier is_valid_formatdata.email.regexA malformed address fails with 422 params_invalid.
Verifier is_disposable, is_webmail, is_gibberishdata.email.disposable, .webmail, .gibberishThe email finder rejects disposable and webmail domains with 400 unknown_record.
unknown_status_reasonNo equivalentA catch-all domain gives the status accept_all.
Domain search company_name, website, city, founded, industry, sizedata.organization.organization, .website_url, .location.city, .founded, .industries, .company_size
Domain search hq_phoneNo equivalentGET /v1/companies/find returns data.site.phoneNumbers.
Domain search emails_count, generic_contacts_countdata.total, data.generic_emails from GET /v1/email-count
Prospects first_name, last_name, positiondata.emails[].first_name, .last_name, .position
Prospects source_pagedata.emails[].sources[].uri
Domain emails data[].emaildata.emails[].emailEach address comes with verification.status.
LinkedIn profiles name, first_name, last_name, countrydata.full_name, .first_name, .last_name, .countrydata.country is a two-letter country code.
LinkedIn profiles positions[]data.position, data.companyThe current position only.
LinkedIn profiles industry, location, skillsNo equivalent
Email count resultdata.total
Profile by email name, firstName, lastName, countrydata.full_name, .first_name, .last_name, .country
Profile by email currentJobs[]data.position, data.company, data.website_url
Profile by email previousJobs[], logo, locality, lastUpdateDateNo equivalent
Balance data.balanceGET /v1/meSee Check usage.

Status mapping

Snov.io smtp_statusTomba statusTomba result (verifier)
validvaliddeliverable
not_validinvalidundeliverable
unknown, with unknown_status_reason catchallaccept_allrisky
unknown, other reasonsunknownrisky
Reported with is_disposable: truedisposableEmpty string

The email finder uses the same status values in data.verification.status, which is null when the address hasn't been verified. Compare status case-insensitively. Each value is defined in Status values.

Error mapping

Snov.io reports a lack of credits in the result's status field. Tomba returns an HTTP error status with an errors object:

Snov.ioTombaWhat to do
Result status not_enough_credits402 quota_exceededWait for your usage window to renew or add credits.
Expired access tokenNo equivalentTomba has no access tokens. A key past its expiry date returns 400 api_key_expired; rotate it.

Also handle Tomba's 400 and 401 authentication_failed for missing or wrong credentials, 422 params_invalid for bad parameters, 429 rate_limit when you exceed your plan's rate limits (see Handle 429 responses), and 451 claimed_email when the owner of an address asked Tomba to stop processing it. Error responses don't consume credits; every type is listed in Errors.

Bulk and async jobs

Replace each Snov.io start and result pair with a single Tomba request, and remove the code that stores task_hash values and polls for results. For lists, run a Tomba bulk job instead of sending batches of 10:

Snov.io methodTomba bulk type
Email finder rowsfinder: a CSV file with name and domain columns. See Email finder.
Email verifier emails[]verifier: a JSON list or a CSV file. See Email verifier.
Domain search over many domainssearch: a JSON list of domains. See Domain search.
LinkedIn profile URLslinkedin: a JSON list of profile URLs. See LinkedIn finder.

Each job is created, launched, polled, and downloaded as CSV; see Lifecycle. To be notified when a job ends, set webhook_url; see Bulk job events. A job is charged when you first download its results; see Billing.

Code example

This function replaces the emails-by-domain-by-name start and result calls. It returns the same shape as Snov.io's result data array. 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, }; // rows: [{ first_name, last_name, domain }], as sent to Snov.io. async function emailsByDomainByName(rows) { const data = []; for (const { first_name, last_name, domain } of rows) { const url = new URL("https://api.tomba.io/v1/email-finder"); url.search = new URLSearchParams({ first_name, last_name, domain, }).toString(); const res = await fetch(url, { headers: TOMBA_HEADERS }); const body = await res.json(); if (body.errors) { throw new Error( `${res.status} ${body.errors.type}: ${body.errors.message}`, ); } const found = body.data; const status = found.verification?.status?.toLowerCase(); data.push({ people: `${first_name} ${last_name}`, result: found.email ? [ { email: found.email, smtp_status: status === "valid" ? "valid" : "unknown", }, ] : [], }); } return data; } const data = await emailsByDomainByName([ { first_name: "Jane", last_name: "Doe", domain: "stripe.com" }, { first_name: "John", last_name: "Smith", domain: "shopify.com" }, ]); console.log(JSON.stringify(data, null, 2));

Cutover checklist

  1. Store the Tomba key and secret as TOMBA_API_KEY and TOMBA_SECRET_KEY, send them as X-Tomba-Key and X-Tomba-Secret, and remove the access token exchange and refresh.
  2. Replace each start and result pair with one GET request, and delete task_hash storage and polling.
  3. Send one person, address, profile, or name per request, and move large lists to bulk jobs.
  4. Translate smtp_status and unknown_status_reason with the status mapping, comparing status case-insensitively.
  5. Handle 402 where you handled not_enough_credits, retry 429 after Retry-After, and drop addresses that return 451.
  6. Run the same sample of people and addresses through both services and compare the results before you switch production traffic.
Last modified on September 30, 2026
HunterProspeo
On this page
  • Before you begin
  • Endpoint mapping
  • Authentication changes
  • Parameter mapping
  • Response field mapping
  • Status mapping
  • Error mapping
  • Bulk and async jobs
  • Code example
  • Cutover checklist
Javascript