# [<img src="https://app.tomba.io/logo.svg" alt="Tomba" width="25"/>](https://tomba.io/) Tomba Email Finder Python Client Library
This is the official Python client library for the [Tomba.io](https://tomba.io) Email Finder API,
allowing you to:
- [Domain Search](https://tomba.io/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](https://tomba.io/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](https://tomba.io/author-finder) (Instantly discover the email addresses of article authors.)
- [Enrichment](https://tomba.io/author-finder) (The Enrichment lets you find the current job title, company, location and social profiles of the person behind the email.)
- [Linkedin Finder](https://tomba.io/author-finder) (The Linkedin lets you find the current job title, company, location and social profiles of the person behind the linkedin URL.)
- [Email Verifier](https://tomba.io/email-verifier) (checks the deliverability of a given email address, verifies if it has been found in our database, and returns their sources.)
- [Email Sources](https://developer.tomba.io/#email-sources) (Find email address source somewhere on the web .)
- [Company Domain autocomplete](https://developer.tomba.io/#autocomplete) (Company Autocomplete is an API that lets you auto-complete company names and retrieve logo and domain information.)
# Getting Started
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](https://app.tomba.io/auth/register)
The free plan is limited to 25 search request and 50 verification a month, To enable all the data fields and additional request volumes see [https://tomba.io/pricing](https://tomba.io/pricing).
## Installation
To install via [PyPI](https://pypi.org/project/tomba-io/):
```bash
pip install tomba-io
```
## Usage
### Domain Search
get email addresses found on the internet.
```py
from tomba.client import Client
from tomba.services.domain import Domain
client = Client()
(client
.set_key('ta_xxxx') # Your Key
.set_secret('') # Your Secret
)
domain = Domain(client)
result = domain.domain_search('stripe.com')
```
#### Domain Search Response
```json
{
"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 }
}
```
### Email Finder
Find the verified email address of any professional.
```py
from tomba.client import Client
from tomba.services.finder import Finder
client = Client()
(client
.set_key('ta_xxxx') # Your Key
.set_secret('') # Your Secret
)
finder = Finder(client)
result = finder.email_finder('tomba.io', 'Mohamed', 'Ben rebia')
```
#### Email Finder Response
```json
{
"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
},
...
...
...
]
}
}
```
### Email Verifier
Verify the validity of any professional email address with the most complete email checker.
```py
from tomba.client import Client
from tomba.services.verifier import Verifier
client = Client()
(client
.set_key('ta_xxxx') # Your Key
.set_secret('') # Your Secret
)
verifier = Verifier(client)
result = verifier.email_verifier('b.mohamed@tomba.io')
```
#### Email Verifier Response
```json
{
"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
},
...
...
...
]
}
}
```
## Examples
Sample codes under [**examples/**](/examples/) folder.
## Documentation
See the [official documentation](https://developer.tomba.io/#introduction).
### Other Libraries
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://developer.tomba.io/#introduction-libraries](https://developer.tomba.io/#introduction-libraries)
### About Tomba
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.
[](https://tomba.io/)
## Contribution
1. Fork it (<https://github.com/tomba-io/python/fork>)
2. Create your feature branch (`git checkout -b my-new-feature`)
3. Commit your changes (`git commit -am 'Add some feature'`)
4. Push to the branch (`git push origin my-new-feature`)
5. Create a new Pull Request
## License
Please see the [Apache 2.0 license](http://www.apache.org/licenses/LICENSE-2.0.html) file for more information.
Raw data
{
"_id": null,
"home_page": "https://tomba.io",
"name": "tomba-io",
"maintainer": "Mohamed Ben rebia",
"docs_url": null,
"requires_python": "",
"maintainer_email": "b.mohamed@tomba.io",
"keywords": "email,Email Finder,Email Verifier,B2B,Email marketing",
"author": "Tomba technology web service LLC",
"author_email": "info@tomba.io",
"download_url": "https://files.pythonhosted.org/packages/9e/4d/ed2c4db64503e09b100dc375f7f2747e4bb8ddacf2d94d704ca3b479f40d/tomba-io-1.0.3.tar.gz",
"platform": "any",
"description": "# [<img src=\"https://app.tomba.io/logo.svg\" alt=\"Tomba\" width=\"25\"/>](https://tomba.io/) Tomba Email Finder Python Client Library\n\nThis is the official Python client library for the [Tomba.io](https://tomba.io) Email Finder API,\nallowing you to:\n\n- [Domain Search](https://tomba.io/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.)\n- [Email Finder](https://tomba.io/email-finder) (This API endpoint generates or retrieves the most likely email address from a domain name, a first name and a last name..)\n- [Author Finder](https://tomba.io/author-finder) (Instantly discover the email addresses of article authors.)\n- [Enrichment](https://tomba.io/author-finder) (The Enrichment lets you find the current job title, company, location and social profiles of the person behind the email.)\n- [Linkedin Finder](https://tomba.io/author-finder) (The Linkedin lets you find the current job title, company, location and social profiles of the person behind the linkedin URL.)\n- [Email Verifier](https://tomba.io/email-verifier) (checks the deliverability of a given email address, verifies if it has been found in our database, and returns their sources.)\n- [Email Sources](https://developer.tomba.io/#email-sources) (Find email address source somewhere on the web .)\n- [Company Domain autocomplete](https://developer.tomba.io/#autocomplete) (Company Autocomplete is an API that lets you auto-complete company names and retrieve logo and domain information.)\n\n# Getting Started\n\nYou'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](https://app.tomba.io/auth/register)\n\nThe free plan is limited to 25 search request and 50 verification a month, To enable all the data fields and additional request volumes see [https://tomba.io/pricing](https://tomba.io/pricing).\n\n## Installation\n\nTo install via [PyPI](https://pypi.org/project/tomba-io/):\n\n```bash\npip install tomba-io\n```\n\n## Usage\n\n### Domain Search\n\nget email addresses found on the internet.\n\n```py\nfrom tomba.client import Client\nfrom tomba.services.domain import Domain\n\nclient = Client()\n\n(client\n .set_key('ta_xxxx') # Your Key\n .set_secret('') # Your Secret\n)\n\ndomain = Domain(client)\n\nresult = domain.domain_search('stripe.com')\n```\n\n#### Domain Search Response\n\n```json\n{\n \"data\": {\n \"organization\": {\n \"location\": {\n \"country\": \"US\",\n \"city\": \"San Francisco\",\n \"state\": \"California\",\n \"street_address\": \"-122.41\"\n },\n \"social_links\": {\n \"twitter_url\": \"https://twitter.com/stripe\",\n \"facebook_url\": \"https://www.facebook.com/StripeHQ\",\n \"linkedin_url\": \"https://www.linkedin.com/company/2135371\"\n },\n \"disposable\": false,\n \"webmail\": false,\n \"website_url\": \"stripe.com\",\n \"phone_number\": \"\",\n \"industries\": \"internet\",\n \"postal_code\": \"94107\",\n \"employee_count\": 976,\n \"founded\": \"2010\",\n \"company_size\": \"1001-5000\",\n \"last_updated\": \"2023-03-28T16:21:55+01:00\",\n \"revenue\": \"150000\",\n \"accept_all\": true,\n \"description\": \"Stripe is a financial infrastructure platform for businesses. Millions of companies\u2014from the world\u2019s largest enterprises to the most ambitious startups\u2014use 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.\",\n \"pattern\": \"{first}\",\n \"domain_score\": 30,\n \"organization\": \"stripe\",\n \"whois\": {\n \"registrar_name\": \"SafeNames Ltd.\",\n \"created_date\": \"1995-09-12 00:00:00\",\n \"referral_url\": \"https://www.safenames.net/\"\n }\n },\n \"emails\": [\n {\n \"email\": \"**@stripe.com\",\n \"first_name\": \"**\",\n \"last_name\": \"**\",\n \"full_name\": \"** **\",\n \"gender\": \"female\",\n \"phone_number\": null,\n \"type\": \"personal\",\n \"country\": \"US\",\n \"position\": \"Financial Crimes Analyst\",\n \"department\": \"finance\",\n \"seniority\": \"senior\",\n \"twitter\": null,\n \"linkedin\": \"https://www.linkedin.com/in/**\",\n \"accept_all\": true,\n \"pattern\": \"{first}\",\n \"score\": 90,\n \"verification\": { \"date\": null, \"status\": null },\n \"last_updated\": \"2023-02-21T14:18:24+01:00\",\n \"sources\": [\n {\n \"uri\": \"https://stripe.com/docs/cli\",\n \"website_url\": \"stripe.com\",\n \"extracted_on\": \"2022-03-08T01:23:16+01:00\",\n \"last_seen_on\": \"2022-08-04T09:42:10+01:00\",\n \"still_on_page\": true\n }\n ]\n },\n ...\n ...\n ...\n ...\n ]\n },\n \"meta\": { \"total\": 2031, \"pageSize\": 10, \"current\": 0, \"total_pages\": 204 }\n}\n```\n\n### Email Finder\n\nFind the verified email address of any professional.\n\n```py\nfrom tomba.client import Client\nfrom tomba.services.finder import Finder\n\nclient = Client()\n\n(client\n .set_key('ta_xxxx') # Your Key\n .set_secret('') # Your Secret\n)\n\nfinder = Finder(client)\n\nresult = finder.email_finder('tomba.io', 'Mohamed', 'Ben rebia')\n```\n\n#### Email Finder Response\n\n```json\n{\n \"data\": {\n \"email\": \"b.mohamed@tomba.io\",\n \"first_name\": \"Mohamed\",\n \"last_name\": \"Ben rebia\",\n \"full_name\": \"Mohamed Ben rebia\",\n \"gender\": \"male\",\n \"country\": null,\n \"position\": \"CEO\",\n \"twitter\": null,\n \"linkedin\": \"https://www.linkedin.com/in/mohamed-ben-rebia\",\n \"phone_number\": null,\n \"accept_all\": null,\n \"website_url\": \"tomba.io\",\n \"company\": \"Tomba technology web service LLC \",\n \"score\": 99,\n \"verification\": { \"date\": \"2022-05-25\", \"status\": \"valid\" },\n \"sources\": [\n {\n \"uri\": \"https://github.com/tomba-io/generic-emails/blob/084fc1a63d3cdaf9a34f255bedc2baea49a8e8b9/src/lib/validation/hash.ts\",\n \"website_url\": \"github.com\",\n \"extracted_on\": \"2021-02-08T20:09:54+01:00\",\n \"last_seen_on\": \"2021-02-08T22:43:40+01:00\",\n \"still_on_page\": true\n },\n ...\n ...\n ...\n ]\n }\n}\n```\n\n### Email Verifier\n\nVerify the validity of any professional email address with the most complete email checker.\n\n```py\nfrom tomba.client import Client\nfrom tomba.services.verifier import Verifier\n\nclient = Client()\n\n(client\n .set_key('ta_xxxx') # Your Key\n .set_secret('') # Your Secret\n)\n\nverifier = Verifier(client)\n\nresult = verifier.email_verifier('b.mohamed@tomba.io')\n\n```\n\n#### Email Verifier Response\n\n```json\n{\n \"data\": {\n \"email\": {\n \"mx_records\": true,\n \"smtp_server\": true,\n \"smtp_check\": true,\n \"accept_all\": false,\n \"block\": false,\n \"email\": \"b.mohamed@tomba.io\",\n \"gibberish\": false,\n \"disposable\": false,\n \"webmail\": false,\n \"regex\": true,\n \"whois\": {\n \"registrar_name\": \"NameCheap, Inc.\",\n \"created_date\": \"2020-07-07 20:54:07\",\n \"referral_url\": \"https://www.namecheap.com/\"\n },\n \"status\": \"valid\",\n \"result\": \"deliverable\",\n \"score\": 100\n },\n \"sources\": [\n {\n \"uri\": \"https://github.com/tomba-io/generic-emails/blob/084fc1a63d3cdaf9a34f255bedc2baea49a8e8b9/src/lib/validation/hash.ts\",\n \"website_url\": \"github.com\",\n \"extracted_on\": \"2021-02-08T20:09:54+01:00\",\n \"last_seen_on\": \"2021-02-08T22:43:40+01:00\",\n \"still_on_page\": true\n },\n ...\n ...\n ...\n ]\n }\n}\n```\n\n## Examples\n\nSample codes under [**examples/**](/examples/) folder.\n\n## Documentation\n\nSee the [official documentation](https://developer.tomba.io/#introduction).\n\n### Other Libraries\n\nThere 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.\n\n[https://developer.tomba.io/#introduction-libraries](https://developer.tomba.io/#introduction-libraries)\n\n### About Tomba\n\nFounded 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.\n\n[](https://tomba.io/)\n\n## Contribution\n\n1. Fork it (<https://github.com/tomba-io/python/fork>)\n2. Create your feature branch (`git checkout -b my-new-feature`)\n3. Commit your changes (`git commit -am 'Add some feature'`)\n4. Push to the branch (`git push origin my-new-feature`)\n5. Create a new Pull Request\n\n## License\n\nPlease see the [Apache 2.0 license](http://www.apache.org/licenses/LICENSE-2.0.html) file for more information.\n\n\n",
"bugtrack_url": null,
"license": "Apache-2.0",
"summary": "Tomba.io is an Email Finder for B2B sales and email marketing",
"version": "1.0.3",
"split_keywords": [
"email",
"email finder",
"email verifier",
"b2b",
"email marketing"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "466865f6dea6a79e68b25c1a95307d70caad31d313e8748b5b6e1fad611ae1d3",
"md5": "21c27a8ec86492cf891e2776ca97cad2",
"sha256": "d0355ade7be4d229e65d268a7b389744b95588e4a8377b20ae503bd4c10ce960"
},
"downloads": -1,
"filename": "tomba_io-1.0.3-py2.py3-none-any.whl",
"has_sig": false,
"md5_digest": "21c27a8ec86492cf891e2776ca97cad2",
"packagetype": "bdist_wheel",
"python_version": "py2.py3",
"requires_python": null,
"size": 16850,
"upload_time": "2023-04-03T22:29:23",
"upload_time_iso_8601": "2023-04-03T22:29:23.716198Z",
"url": "https://files.pythonhosted.org/packages/46/68/65f6dea6a79e68b25c1a95307d70caad31d313e8748b5b6e1fad611ae1d3/tomba_io-1.0.3-py2.py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "9e4ded2c4db64503e09b100dc375f7f2747e4bb8ddacf2d94d704ca3b479f40d",
"md5": "49f9035a3542be31089561e2e4320990",
"sha256": "77114c8640d692850c6f69133a2a3eed5c3bd4d5787b7d966973ae1cf24eeabf"
},
"downloads": -1,
"filename": "tomba-io-1.0.3.tar.gz",
"has_sig": false,
"md5_digest": "49f9035a3542be31089561e2e4320990",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 14940,
"upload_time": "2023-04-03T22:29:26",
"upload_time_iso_8601": "2023-04-03T22:29:26.247011Z",
"url": "https://files.pythonhosted.org/packages/9e/4d/ed2c4db64503e09b100dc375f7f2747e4bb8ddacf2d94d704ca3b479f40d/tomba-io-1.0.3.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-04-03 22:29:26",
"github": false,
"gitlab": false,
"bitbucket": false,
"lcname": "tomba-io"
}
JSON