This is the official Go client library for the Tomba.io Email Finder API, allowing you to:
- 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.)
- Email Finder (This API endpoint generates or retrieves the most likely email address from a domain name, a first name and a last name..)
- Author Finder (Instantly discover the email addresses of article authors.)
- Enrichment (The Enrichment lets you find the current job title, company, location and social profiles of the person behind the email.)
- Linkedin Finder (The Linkedin lets you find the current job title, company, location and social profiles of the person behind the linkedin URL.)
- Email Verifier (checks the deliverability of a given email address, verifies if it has been found in our database, and returns their sources.)
- Search Companies (Search for companies using natural language queries or structured filters.)
- Collect publicly available emails online (Html, execute JavaScript,files,).
- No duplicate email No duplicate domain .
- No webmail like Gmail,Outlook and the others.
- We detect 15 type of hashes and remove them.
- No disposable and temporary email address.
You'll need an Tomba API access token, which you can get by signing up for a free account at https://app.tomba.io/auth/register
The free plan is limited to 50 search request and 50 verification a month, To enable all the data fields and additional request volumes see https://tomba.io/pricing.
go get github.com/tomba-io/go/tombaget email addresses found on the internet.
package main
import (
"fmt"
"github.com/tomba-io/go/tomba"
)
func main() {
client := tomba.New("ta_xxxxx", "ts_xxxxx")
result, err := client.DomainSearch(tomba.Params{
"domain": "tomba.io",
})
if err == nil {
fmt.Println(result)
}
}result, err := client.DomainSearch(tomba.Params{
"domain": "stripe.com", // Domain name or company name
"country": "US", // Filter by country
"limit": 50, // Number of results per page (max 100)
"page": 1, // Page number for pagination
"department": "engineering", // Filter by department
})Available department values: executive, it, finance, management, communication, marketing, sales, legal, hr, support, engineering
{
"data": {
"organization": {
"location": {
"country": "US",
"city": "San Francisco",
"state": "California",
"street_address": "-122.41"
},
"social_links": {
"twitter_url": "https://twitter.com/stripe",
"facebook_url": "https://www.facebook.com/StripeHQ",
"linkedin_url": "https://www.linkedin.com/company/2135371"
},
"disposable": false,
"webmail": false,
"website_url": "stripe.com",
"phone_number": "",
"industries": "internet",
"postal_code": "94107",
"employee_count": 976,
"founded": "2010",
"company_size": "1001-5000",
"last_updated": "2023-03-28T16:21:55+01:00",
"revenue": "150000",
"accept_all": true,
"description": "Stripe is a financial infrastructure platform for businesses. Millions of companies—from the world’s largest enterprises to the most ambitious startups—use Stripe to accept payments, grow their revenue, and accelerate new business opportunities. Headquartered in San Francisco and Dublin, the company aims to increase the GDP of the internet.",
"pattern": "{first}",
"domain_score": 30,
"organization": "stripe",
"whois": {
"registrar_name": "SafeNames Ltd.",
"created_date": "1995-09-12 00:00:00",
"referral_url": "https://www.safenames.net/"
}
},
"emails": [
{
"email": "**@stripe.com",
"first_name": "**",
"last_name": "**",
"full_name": "** **",
"gender": "female",
"phone_number": null,
"type": "personal",
"country": "US",
"position": "Financial Crimes Analyst",
"department": "finance",
"seniority": "senior",
"twitter": null,
"linkedin": "https://www.linkedin.com/in/**",
"accept_all": true,
"pattern": "{first}",
"score": 90,
"verification": { "date": null, "status": null },
"last_updated": "2023-02-21T14:18:24+01:00",
"sources": [
{
"uri": "https://stripe.com/docs/cli",
"website_url": "stripe.com",
"extracted_on": "2022-03-08T01:23:16+01:00",
"last_seen_on": "2022-08-04T09:42:10+01:00",
"still_on_page": true
}
]
},
...
...
...
...
]
},
"meta": { "total": 2031, "pageSize": 10, "current": 0, "total_pages": 204 }
}Find the verified email address of any professional.
package main
import (
"fmt"
"github.com/tomba-io/go/tomba"
)
func main() {
client := tomba.New("ta_xxxxx", "ts_xxxxx")
result, err := client.EmailFinder(tomba.Params{"domain": "asana.com", "full_name": "moskoz dustin"})
if err == nil {
fmt.Println(result)
}
}Using first_name + last_name:
result, err := client.EmailFinder(tomba.Params{
"domain": "stripe.com",
"first_name": "Patrick",
"last_name": "Collison",
})With enrich_mobile to get phone number:
result, err := client.EmailFinder(tomba.Params{
"domain": "tomba.io",
"full_name": "Mohamed Ben Rebia",
"enrich_mobile": true, // Set to true to get the phone number associated with the email
}){
"data": {
"email": "b.mohamed@tomba.io",
"first_name": "Mohamed",
"last_name": "Ben rebia",
"full_name": "Mohamed Ben rebia",
"gender": "male",
"country": null,
"position": "CEO",
"twitter": null,
"linkedin": "https://www.linkedin.com/in/mohamed-ben-rebia",
"phone_number": null,
"accept_all": null,
"website_url": "tomba.io",
"company": "Tomba technology web service LLC ",
"score": 99,
"verification": { "date": "2022-05-25", "status": "valid" },
"sources": [
{
"uri": "https://github.com/tomba-io/generic-emails/blob/084fc1a63d3cdaf9a34f255bedc2baea49a8e8b9/src/lib/validation/hash.ts",
"website_url": "github.com",
"extracted_on": "2021-02-08T20:09:54+01:00",
"last_seen_on": "2021-02-08T22:43:40+01:00",
"still_on_page": true
},
...
...
...
]
}
}Verify the validity of any professional email address with the most complete email checker.
package main
import (
"fmt"
"github.com/tomba-io/go/tomba"
)
func main() {
client := tomba.New("ta_xxxxx", "ts_xxxxx")
result, err := client.EmailVerifier(tomba.Params{
"email": "b.mohamed@tomba.io",
})
if err == nil {
fmt.Println(result)
}
}result, err := client.EmailVerifier(tomba.Params{
"email": "b.mohamed@tomba.io",
"enrich_mobile": true, // Set to true to get the phone number associated with the email
}){
"data": {
"email": {
"mx_records": true,
"smtp_server": true,
"smtp_check": true,
"accept_all": false,
"block": false,
"email": "b.mohamed@tomba.io",
"gibberish": false,
"disposable": false,
"webmail": false,
"regex": true,
"whois": {
"registrar_name": "NameCheap, Inc.",
"created_date": "2020-07-07 20:54:07",
"referral_url": "https://www.namecheap.com/"
},
"status": "valid",
"result": "deliverable",
"score": 100
},
"sources": [
{
"uri": "https://github.com/tomba-io/generic-emails/blob/084fc1a63d3cdaf9a34f255bedc2baea49a8e8b9/src/lib/validation/hash.ts",
"website_url": "github.com",
"extracted_on": "2021-02-08T20:09:54+01:00",
"last_seen_on": "2021-02-08T22:43:40+01:00",
"still_on_page": true
},
...
...
...
]
}
}Search for companies using natural language queries or structured filters.
package main
import (
"fmt"
"github.com/tomba-io/go/tomba"
"github.com/tomba-io/go/tomba/models"
)
func main() {
client := tomba.New("ta_xxxxx", "ts_xxxxx")
// Natural language query
result, err := client.SearchCompanies(&models.RevealSearchRequest{
Query: "Real Estate in France",
})
if err == nil {
fmt.Println(result)
}
}result, err := client.SearchCompanies(&models.RevealSearchRequest{
Page: 1,
Filters: &models.RevealSearchFilters{
Company: &models.RevealCompanyFilters{
LocationCountry: &models.RevealCircularFilter{
Include: []string{"US", "UK"},
},
Industry: &models.RevealCircularFilter{
Include: []string{"Technology"},
},
Size: &models.RevealCircularFilter{
Include: []string{"101-500", "501-1000"},
},
},
},
})Available filter options: LocationCountry, LocationCity, LocationState, Industry, Size, Type, Keywords, Founded, Technologies, Similar, Revenue, SIC, NAICS
{
"success": true,
"data": {
"companies": [
{
"name": "Example Company",
"description": "A technology company",
"country": "US",
"state": "California",
"city": "San Francisco",
"industry": "Technology",
"company_size": "101-500",
"type": "Private",
"founded": "2015",
"website_url": "https://example.com",
"total_emails": 150,
"linkedin_url": "https://www.linkedin.com/company/example"
}
],
"total": 1000,
"page": 1,
"limit": 10,
"pages": 100
}
}Sample codes under examples/ folder.
See the official documentation.
There are official Tomba Email Finder client libraries available for many languages including PHP, Python, Go, Java, Ruby, and many popular frameworks such as Django, Rails and Laravel. There are also many third party libraries and integrations available for our API.
https://docs.tomba.io/libraries
Founded in 2021, Tomba prides itself on being the most reliable, accurate, and in-depth source of Email address data available anywhere. We process terabytes of data to produce our Email finder API, company.
- Fork it (https://github.com/tomba-io/go/fork)
- Create your feature branch (
git checkout -b my-new-feature) - Commit your changes (
git commit -am 'Add some feature') - Push to the branch (
git push origin my-new-feature) - Create a new Pull Request
Please see the Apache 2.0 license file for more information.