Copy page

Language Libraries

Ruby Client Library

Installation

Code
gem install tomba

Usage

Code
require 'tomba'

client = Tomba::Client.new
client.set_key('ta_xxxx').set_secret('ts_xxxx')

# Domain Search
domain = Tomba::Domain.new(client)
result = domain.domain_search('stripe.com')

# Email Finder
finder = Tomba::Finder.new(client)
result = finder.email_finder('stripe.com', 'John', 'Doe')

# Email Verifier
verifier = Tomba::Verifier.new(client)
result = verifier.email_verifier('john.doe@stripe.com')

Examples

Account

Code
account = Tomba::Account.new(client)
result = account.get_account

Email Count

Code
count = Tomba::Count.new(client)
result = count.email_count('stripe.com')

Email Sources

Code
sources = Tomba::Sources.new(client)
result = sources.email_sources('john.doe@stripe.com')

Email Format

Code
format = Tomba::Format.new(client)
result = format.email_format('stripe.com')

Domain Status

Code
status = Tomba::Status.new(client)
result = status.domain_status('stripe.com')

Autocomplete

Code
status = Tomba::Status.new(client)
result = status.auto_complete('stripe')

Similar Domains

Code
similar = Tomba::Similar.new(client)
result = similar.websites('stripe.com')

Technology

Code
technology = Tomba::Technology.new(client)
result = technology.list('stripe.com')

Location

Code
location = Tomba::Location.new(client)
result = location.get_location('stripe.com')

Author Finder

Code
finder = Tomba::Finder.new(client)
result = finder.author_finder('https://example.com/blog/post')

LinkedIn Finder

Code
finder = Tomba::Finder.new(client)
result = finder.linkedin_finder('https://www.linkedin.com/in/johndoe')

Email Enrichment

Code
finder = Tomba::Finder.new(client)
result = finder.email_enrichment('john.doe@stripe.com')

Phone Finder

Code
phone = Tomba::Phone.new(client)
result = phone.finder(email: 'john.doe@stripe.com')

Phone Validator

Code
phone = Tomba::Phone.new(client)
result = phone.validator('+14155552671')

Enrichment

Person

Code
enrichment = Tomba::Enrichment.new(client)
result = enrichment.person('john.doe@stripe.com')

Company

Code
enrichment = Tomba::Enrichment.new(client)
result = enrichment.company('stripe.com')

Combined

Code
enrichment = Tomba::Enrichment.new(client)
result = enrichment.combined('john.doe@stripe.com')

Companies Search (Reveal)

Code
reveal = Tomba::Reveal.new(client)
result = reveal.companies_search(query: 'Stripe')

Flag

List Flags

Code
flag = Tomba::Flag.new(client)
result = flag.list_flags

Create Flag

Code
flag = Tomba::Flag.new(client)
result = flag.create_flag(
  flag_type: 'email',
  value: 'invalid@example.com',
  reason: 'hard_bounce'
)

Keys Management

Code
keys = Tomba::Keys.new(client)

# List all keys
result = keys.get_keys

# Create a new key
result = keys.create_key

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

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

Leads Management

Code
leads = Tomba::Leads.new(client)

# List leads
result = leads.list_leads

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

# Update a lead
result = leads.update_lead('lead_id', { first_name: 'John', last_name: 'Doe' })

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

Lead Lists Management

Code
leads_lists = Tomba::LeadsLists.new(client)

# List all lead lists
result = leads_lists.get_lists

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

# Update a list
result = leads_lists.update_list('list_id', { name: 'Updated List' })

# Delete a list
result = leads_lists.delete_list('list_id')

Lead Attributes Management

Code
leads_attributes = Tomba::LeadsAttributes.new(client)

# List attributes
result = leads_attributes.get_lead_attributes

# Create an attribute
result = leads_attributes.create_lead_attribute(name: 'company_size', type: 'string')

# Update an attribute
result = leads_attributes.update_lead_attribute('attr_id', { name: 'company_revenue' })

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

Activity Logs

Code
logs = Tomba::Logs.new(client)
result = logs.get_logs

Usage Statistics

Code
usage = Tomba::Usage.new(client)
result = usage.get_usage