Copy page

Language Libraries

Python Client Library

Installation

Code
pip install tomba-io

Usage

Code
from tomba.client import Client
from tomba.services.domain import Domain
from tomba.services.finder import Finder
from tomba.services.verifier import Verifier

client = Client()
client.set_key('ta_xxxx').set_secret('ts_xxxx')

Domain Search

Get email addresses found on the internet.

Code
domain = Domain(client)
result = domain.domain_search('stripe.com')
print(result)

Email Finder

Find the verified email address of any professional.

Code
finder = Finder(client)
result = finder.email_finder('stripe.com', 'John', 'Doe')
print(result)

Email Verifier

Verify the validity of any professional email address.

Code
verifier = Verifier(client)
result = verifier.email_verifier('m@wordpress.org')
print(result)

Examples

Account

Code
from tomba.services.account import Account

account = Account(client)
result = account.get_account()
print(result)

Email Count

Code
from tomba.services.count import Count

count = Count(client)
result = count.email_count('tomba.io')
print(result)

Email Sources

Code
from tomba.services.sources import Sources

sources = Sources(client)
result = sources.email_sources('b.mohamed@tomba.io')
print(result)

Email Format

Code
from tomba.services.format import Format

format = Format(client)
result = format.email_format('stripe.com')
print(result)

Domain Status

Code
from tomba.services.status import Status

status = Status(client)
result = status.domain_status('gmail.com')
print(result)

Autocomplete

Code
from tomba.services.status import Status

status = Status(client)
result = status.auto_complete('google')
print(result)

Similar Domains

Code
from tomba.services.similar import Similar

similar = Similar(client)
result = similar.websites('stripe.com')
print(result)

Technology

Code
from tomba.services.technology import Technology

technology = Technology(client)
result = technology.list('stripe.com')
print(result)

Location

Code
from tomba.services.location import Location

location = Location(client)
result = location.get_location('stripe.com')
print(result)

Author Finder

Code
from tomba.services.finder import Finder

finder = Finder(client)
result = finder.author_finder('https://clearbit.com/blog/company-name-to-domain-api')
print(result)

LinkedIn Finder

Code
from tomba.services.finder import Finder

finder = Finder(client)
result = finder.linkedin_finder('https://www.linkedin.com/in/alex-maccaw-ab592978')
print(result)

Email Enrichment

Code
from tomba.services.finder import Finder

finder = Finder(client)
result = finder.enrichment('b.mohamed@tomba.io')
print(result)

Phone Finder

Code
from tomba.services.phone import Phone

phone = Phone(client)
result = phone.finder(email='john.doe@stripe.com')
print(result)

Phone Validator

Code
from tomba.services.phone import Phone

phone = Phone(client)
result = phone.validator('+14158586273')
print(result)

Enrichment

Person

Code
from tomba.services.enrichment import Enrichment

enrichment = Enrichment(client)
result = enrichment.person('john.doe@stripe.com')
print(result)

Company

Code
from tomba.services.enrichment import Enrichment

enrichment = Enrichment(client)
result = enrichment.company('stripe.com')
print(result)

Combined

Code
from tomba.services.enrichment import Enrichment

enrichment = Enrichment(client)
result = enrichment.combined('john.doe@stripe.com')
print(result)

Companies Search (Reveal)

Code
from tomba.services.reveal import Reveal

reveal = Reveal(client)
result = reveal.search_companies(query='stripe')
print(result)

Flag

List Flags

Code
from tomba.services.flag import Flag

flag = Flag(client)
result = flag.list_flags()
print(result)

Create Flag

Code
from tomba.services.flag import Flag

flag = Flag(client)
result = flag.create_flag('invalid@example.com', 'hard_bounce')
print(result)

Keys Management

Code
from tomba.services.keys import Keys

keys = Keys(client)

# List all keys
result = keys.get_keys()
print(result)

# Create a new key
result = keys.create_key()
print(result)

# Reset a key
result = keys.reset_key('key_id')
print(result)

# Delete a key
result = keys.delete_key('key_id')
print(result)

Leads Management

Code
from tomba.services.leads import Leads

leads = Leads(client)

# List leads
result = leads.list_leads()
print(result)

# Create a lead
result = leads.create_lead(email='john@stripe.com', list_id=1)
print(result)

# Update a lead
result = leads.update_lead('lead_id', first_name='John')
print(result)

# Delete a lead
result = leads.delete_lead('lead_id')
print(result)

Lead Lists Management

Code
from tomba.services.leads_lists import LeadsLists

leads_lists = LeadsLists(client)

# List all lead lists
result = leads_lists.get_lists()
print(result)

# Create a lead list
result = leads_lists.create_list(name='My List')
print(result)

# Update a lead list
result = leads_lists.update_list_id('list_id', name='Updated List')
print(result)

# Delete a lead list
result = leads_lists.delete_list_id('list_id')
print(result)

Lead Attributes Management

Code
from tomba.services.leads_attributes import LeadsAttributes

leads_attributes = LeadsAttributes(client)

# List all attributes
result = leads_attributes.get_lead_attributes()
print(result)

# Create an attribute
result = leads_attributes.create_lead_attribute(name='Company Size', type='string')
print(result)

# Update an attribute
result = leads_attributes.update_lead_attribute('attr_id', name='Company Size Updated')
print(result)

# Delete an attribute
result = leads_attributes.delete_lead_attribute('attr_id')
print(result)

Activity Logs

Code
from tomba.services.logs import Logs

logs = Logs(client)
result = logs.get_logs()
print(result)

Usage Statistics

Code
from tomba.services.usage import Usage

usage = Usage(client)
result = usage.get_usage()
print(result)