Domain Search
Domain Search Search emails are based on the website You give one domain name and it returns all the email addresses found on the internet.
query Parameters
domainstring · requiredDomain name from which you want to find the email addresses. For example,
stripe.comcompanystring · minLength: 3 · maxLength: 75 · requiredThe company name from which you want to find the email addresses. For example, "stripe". Note that providing the domain name gives better results as it removes the conversion from the company name. If you send a request with both the domain and the company name, the domain name will be used. The company name doesn't need to be in lowercase.
pageinteger · int32Specifies the number of email addresses to skip. The default is 1.
Default: 1limitstring · enumSpecifies the max number of email addresses to return.
Enum values:102050Default: 10countrystringtwo-letter country code of the country from which you want to find the email addresses. For example, "US"
departmentstring · enumGet only email addresses for people working in the selected department(s).
Enum values:engineeringsalesfinancehritmarketingoperationsmanagement
Headers
X-Tomba-Keystring · requiredTomba API Key X-Tomba-Key header. Format:
YOUR_API_KEYX-Tomba-Secretstring · requiredTomba API Secret X-Tomba-Secret header. Format:
YOUR_API_SECRET
Responses
Email addresses found successfully
organizationobjectemailsobject[]
Email Finder
Email Finder generates or retrieves the most likely email address from a domain name, a first name and a last name.
query Parameters
domainstring · requiredDomain name from which you want to find the email addresses. For example,
stripe.comcompanystring · minLength: 3 · maxLength: 75 · requiredThe company name from which you want to find the email addresses. For example, "stripe". Note that providing the domain name gives better results as it removes the conversion from the company name. If you send a request with both the domain and the company name, the domain name will be used. The company name doesn't need to be in lowercase.
first_namestring · requiredThe person's first name. It doesn't need to be in lowercase.
last_namestring · requiredThe person's last name. It doesn't need to be in lowercase.
Headers
X-Tomba-Keystring · requiredTomba API Key X-Tomba-Key header. Format:
YOUR_API_KEYX-Tomba-Secretstring · requiredTomba API Secret X-Tomba-Secret header. Format:
YOUR_API_SECRET
Responses
Email address found successfully
emailstringfirst_namestringlast_namestringfull_namestringcountrystring · nullablepositionstring · nullabletwitterstring · nullablelinkedinstring · nullablephone_numberstring · nullableaccept_allbooleanwebsite_urlstringcompanystringscoreinteger · int32verificationobjectsourcesobject[]
Email Count
Domain name from which you want to find the email addresses.
query Parameters
domainstring · requiredThe domain name from which you want to find the email addresses. For example,
stripe.com
Headers
X-Tomba-Keystring · requiredTomba API Key X-Tomba-Key header. Format:
YOUR_API_KEYX-Tomba-Secretstring · requiredTomba API Secret X-Tomba-Secret header. Format:
YOUR_API_SECRET
Responses
Email count retrieved successfully
dataobject
Email Format
This endpoint allows you to retrieve the email format patterns used by a specific domain.
query Parameters
domainstring · requiredThe domain name from which you want to find the email addresses. For example,
stripe.com
Headers
X-Tomba-Keystring · requiredTomba API Key X-Tomba-Key header. Format:
YOUR_API_KEYX-Tomba-Secretstring · requiredTomba API Secret X-Tomba-Secret header. Format:
YOUR_API_SECRET
Responses
Email format retrieved successfully
dataobject[]
Location
Employees location based on the domain name.
query Parameters
domainstring · requiredThe domain name from which you want to find the location. For example,
stripe.com
Headers
X-Tomba-Keystring · requiredTomba API Key X-Tomba-Key header. Format:
YOUR_API_KEYX-Tomba-Secretstring · requiredTomba API Secret X-Tomba-Secret header. Format:
YOUR_API_SECRET
Responses
Location data retrieved successfully
dataobject[]
Author Finder
Author Finder This API endpoint generates or retrieves the most likely email address from a blog post url.
query Parameters
urlstring · requiredThe URL of the article. For example, "https://clearbit.com/blog/company-name-to-domain-api".
Headers
X-Tomba-Keystring · requiredTomba API Key X-Tomba-Key header. Format:
YOUR_API_KEYX-Tomba-Secretstring · requiredTomba API Secret X-Tomba-Secret header. Format:
YOUR_API_SECRET
Responses
Author email found successfully
emailstringfirst_namestringlast_namestringfull_namestringcountrystring · nullablepositionstring · nullabletwitterstring · nullablelinkedinstring · nullablephone_numberstring · nullableaccept_allbooleanwebsite_urlstringcompanystringscoreinteger · int32verificationobjectsourcesobject[]
Linkedin Finder
Linkedin Finder This API endpoint generates or retrieves the most likely email address from a Linkedin URL.
query Parameters
urlstring · requiredThe URL of the Linkedin. For example,
https://www.linkedin.com/in/alex-maccaw-ab592978.
Headers
X-Tomba-Keystring · requiredTomba API Key X-Tomba-Key header. Format:
YOUR_API_KEYX-Tomba-Secretstring · requiredTomba API Secret X-Tomba-Secret header. Format:
YOUR_API_SECRET
Responses
Email address from LinkedIn found successfully
emailstringfirst_namestringlast_namestringfull_namestringcountrystring · nullablepositionstring · nullabletwitterstring · nullablelinkedinstring · nullablephone_numberstring · nullableaccept_allbooleanwebsite_urlstringcompanystringscoreinteger · int32verificationobjectsourcesobject[]
Email Enrichment
Email Enrichment enrichment lets you look up person and company data based on an email, For example, you could retrieve a person’s name, location and social handles from an email
query Parameters
emailstring · requiredThe email address to find data.
Headers
X-Tomba-Keystring · requiredTomba API Key X-Tomba-Key header. Format:
YOUR_API_KEYX-Tomba-Secretstring · requiredTomba API Secret X-Tomba-Secret header. Format:
YOUR_API_SECRET
Responses
Email enrichment data retrieved successfully
emailstringfirst_namestringlast_namestringfull_namestringcountrystring · nullablepositionstring · nullabletwitterstring · nullablelinkedinstring · nullablephone_numberstring · nullableaccept_allbooleanwebsite_urlstringcompanystringscoreinteger · int32verificationobjectsourcesobject[]