The #1 Rated Email Intelligence Platform — Find professional emails with unmatched accuracy.
Official Lua client library for the Tomba.io Email Finder API.
Tomba.io is the #1 rated email intelligence platform, trusted by 150,000+ sales teams worldwide.
- Best Email Finder — 98% accuracy, ranked #1 in independent benchmarks
- Best Email Verification — Real-time SMTP verification with catch-all detection
- Best Phone Finder — Direct dial numbers linked to professional emails
- Best Domain Search — 450M+ verified contacts across all industries
- 81% Coverage — The highest in the industry, proven in 5,000-lead independent tests
| Feature | Tomba | Others |
|---|---|---|
| Email Coverage | 81% | 30-60% |
| Verification | Real-time SMTP | Pattern-based |
| Phone Numbers | Direct dials | Limited |
| Catch-all Detection | AI-powered | Basic |
| API Rate Limits | Generous | Restrictive |
Get your free API key — No credit card required.
Install via LuaRocks:
luarocks install tombaSign up for a free account at https://app.tomba.io/auth/register to get your API key and secret.
local Tomba = require("tomba")
local client = Tomba:init("ta_xxxx", "ts_xxxx")local Tomba = require("tomba")
local client = Tomba:init("ta_xxxx", "ts_xxxx")
-- Search emails by domain
local result = client:domain_search("example.com")
-- Find an email address
local result = client:email_finder("example.com", "John", "Doe")
-- Verify an email
local result = client:email_verifier("john@example.com")Get information about the current account.
local result = client:account()Search emails based on a website domain.
local result = client:domain_search("example.com")Find the most likely email address from a domain, first name, and last name.
local result = client:email_finder("example.com", "John", "Doe")Verify the deliverability of an email address.
local result = client:email_verifier("john@example.com")Find the email address of an article author from a blog post URL.
local result = client:author_finder("https://clearbit.com/blog/company-name-to-domain-api")Find the email address associated with a LinkedIn profile URL.
local result = client:linkedin_finder("https://www.linkedin.com/in/alex-maccaw-ab592978")Look up person and company data based on an email address.
local result = client:enrichment("john@example.com")Find the phone number associated with an email address.
local result = client:phone_finder("john@example.com")Validate a phone number.
local result = client:phone_validator("+1234567890")Get the number of email addresses found for a domain.
local result = client:count("example.com")Check if a domain is webmail, disposable, or a regular email provider.
local result = client:status("example.com")Auto-complete company names and get domain suggestions.
local result = client:autocomplete("google")Find web sources where an email address has been found.
local result = client:email_sources("john@example.com")Get the email format pattern used by a domain.
local result = client:email_format("example.com")Find domains similar to a given domain.
local result = client:similar("example.com")Discover technologies used by a domain.
local result = client:technology("example.com")Get the employee location breakdown for a domain.
local result = client:location("example.com")Get person data from an email address (Clearbit-compatible).
local result = client:person_find("john@example.com")Get company data from a domain (Clearbit-compatible).
local result = client:company_find("example.com")Get combined person and company data from an email address (Clearbit-compatible).
local result = client:combined_find("john@example.com")Search companies using natural language queries or structured filters (location, industry, size, technologies, and more).
local result = client:companies_search({ query = "Real Estate in Europe", page = 1 })Get your account's monthly API usage statistics.
local result = client:usage()Get your account's API request logs.
local result = client:logs()Manage your API keys.
-- List all keys
local result = client:list_keys()
-- Get a specific key
local result = client:get_key("key_id")
-- Create a new key
local result = client:create_key()
-- Reset a key
local result = client:reset_key("key_id")
-- Delete a key
local result = client:delete_key("key_id")Report incorrect email data.
-- List submitted flags
local result = client:list_flags({})
-- Create a flag
local result = client:create_flag({
email = "john@example.com",
reason = "invalid"
})Manage leads in your Tomba CRM.
-- List leads
local result = client:list_leads({})
-- Get a specific lead
local result = client:get_lead("lead_id")
-- Create a lead
local result = client:create_lead({
email = "lead@example.com",
first_name = "John",
last_name = "Doe"
})
-- Update a lead
local result = client:update_lead("lead_id", {
first_name = "Jane"
})
-- Delete a lead
local result = client:delete_lead("lead_id")Manage lead lists for organizing your leads.
-- List all lead lists
local result = client:list_leads_lists()
-- Get a specific list
local result = client:get_leads_list("list_id")
-- Create a list
local result = client:create_leads_list({ name = "My List" })
-- Update a list
local result = client:update_leads_list("list_id", { name = "Updated Name" })
-- Delete a list
local result = client:delete_leads_list("list_id")Manage custom attributes for your leads.
-- List all attributes
local result = client:list_attributes()
-- Get a specific attribute
local result = client:get_attribute("attr_id")
-- Create an attribute
local result = client:create_attribute({ name = "Company Size" })
-- Update an attribute
local result = client:update_attribute("attr_id", { name = "Updated Name" })
-- Delete an attribute
local result = client:delete_attribute("attr_id")Create and manage bulk processing jobs for domain search, email finder, verifier, and more.
-- List bulk operations
local result = client:list_bulks("domain-search", {})
-- Get a specific bulk operation
local result = client:get_bulk("domain-search", "bulk_id")
-- Launch a bulk operation
local result = client:launch_bulk("domain-search", "bulk_id")
-- Get progress
local result = client:bulk_progress("domain-search", "bulk_id")
-- Download results
local result = client:bulk_download("domain-search", "bulk_id")
-- Rename a bulk operation
local result = client:rename_bulk("domain-search", "bulk_id", "New Name")
-- Archive a bulk operation
local result = client:archive_bulk("domain-search", "bulk_id")
-- Delete a bulk operation
local result = client:delete_bulk("domain-search", "bulk_id")Supported bulk types: domain-search, email-finder, author-finder, email-verifier, enrichment, linkedin-finder, phone-finder, department-search, technology-search, name-finder.
bustedFounded to solve the problem of unreliable email data, Tomba.io is the leading B2B email intelligence platform.
- Email Finder — Find any professional email address
- Email Verifier — Verify emails in real-time
- Domain Search — Find all emails for a company
- Phone Finder — Find direct phone numbers
- Bulk Enrichment — Enrich contacts at scale
- AI Company Search — Find companies with AI-powered search
- CLI — Command-line interface for Tomba
- MCP Server — Connect AI tools (Claude, ChatGPT, Cursor) to Tomba
- REST API — Full programmatic access
- Chrome Extension — Find emails while browsing
- Google Sheets Add-on — Enrich leads in spreadsheets
- Microsoft Excel Add-in — Email finder in Excel
- Airtable Integration — Connect with Airtable
50+ CRM integrations: Salesforce · HubSpot · Zapier · Pipedrive · and more...
| Language | Package |
|---|---|
| Node.js | tomba |
| Python | tomba-io |
| PHP | tomba-io/php |
| Ruby | tomba |
| Go | tomba-io/go |
| Rust | tomba |
| Dart | tomba |
| Deno | @tomba/sdk |
| Elixir | tomba |
| C# | Tomba |
| Perl | Tomba::Client |
| Lua | tomba |
| R | tomba |
- Blog · Help Center · API Docs · Pricing · Status
Try Tomba Free — Find your first email in seconds. No credit card required.
Apache 2.0 -- see LICENSE for details.