| Released | [Tomba JS](https://www.npmjs.com/package/tomba) | NPM package |
| [Ruby](./libraries/ruby-email-finder) | 
| Released | [Tomba Ruby](https://rubygems.org/gems/tomba) | Ruby Gems |
| [R](./libraries/r-email-finder) | 
| Released | [Tomba R](https://cran.r-project.org/web/packages/tomba/index.html) | CRAN |
| [Dart](./libraries/dart-email-finder) | 
| Released | [Tomba Dart](https://pub.dev/packages/tomba) | Pub |
| [Python](./libraries/python-email-finder) | 
| Released | [Tomba Python](https://pypi.org/project/tomba-io/) | PyPi |
| [PHP](./libraries/php-email-finder) | 
| Released | [Tomba PHP](https://packagist.org/packages/tomba-io/php) | Packagist |
| [Deno](./libraries/deno-email-finder) | 
| Released | [Tomba Deno](https://deno.land/x/tombaio) | Deno Land |
| [C#](./libraries/csharp-email-finder) | 
| Released | [Tomba C#](https://www.nuget.org/packages/Tomba) | NuGet |
| [Rust](./libraries/rust-email-finder) | 
| Released | [Tomba Rust](https://crates.io/crates/tomba) | crates.io |
| [Lua](./libraries/lua-email-finder) | 
| Released | [Tomba Lua](https://luarocks.org/modules/benemohamed/tomba) | LuaRocks |
| [Elixir](./libraries/elixir-email-finder) | 
| Released | [Tomba Elixir](https://hex.pm/packages/tomba) | Hex.pm |
| [Go](./libraries/go-email-finder) | 
| Released | [Tomba Go](https://github.com/tomba-io/go) | GitHub |
| [Perl](./libraries/perl-email-finder) | 
| Released | [Tomba Perl](https://github.com/tomba-io/perl) | GitHub |
**[Let us know](mailto:info@tomba.io)** if you’ve built something you’d like added to this list!
---
## Document: Introduction to Tomba.io
Discover the power of Tomba.io for email finding, domain search, email verification, and advanced integrations.
URL: /introduction
# Introduction to Tomba.io
### Welcome to Tomba.io
Tomba.io is your ultimate solution for discovering, verifying, and managing professional email addresses. Designed for sales, marketing, and recruitment professionals, our platform empowers you with the tools to connect with your target audience efficiently.
## What Makes Tomba.io Unique?
- **[Email Finder](https://tomba.io/email-finder):** Access a comprehensive database of verified email addresses.
- **[Author Finder](https://tomba.io/author-finder):** Find article authors and their contact details quickly and accurately.
- **[Domain Search](https://tomba.io/domain-search):** Uncover key contact details associated with any business domain.
- **[LinkedIn Email Finder](https://tomba.io/linkedin-finder):** Find professional emails using just a LinkedIn profile URL.
- **[Email Verification](https://tomba.io/email-verifier):** Ensure your outreach efforts are directed toward valid, active contacts.
- **[Bulk Tasks](https://tomba.io/bulks):** Manage and execute large-scale operations effortlessly.
- **[Email & Domain Enrichment](https://tomba.io/enrichment):** Enhance your data with detailed email and domain insights.
- **[Phone Finder](https://tomba.io/phone-finder):** Find Phone Numbers from Any Contact Information
- **[Phone Validation](https://tomba.io/phone-validator):** Validate Phone Numbers & Check Carrier Information
- **[Look-Alike Features](/api/~endpoints#similar):** Discover competitor and similar websites to expand your targeting with precision.
- **[Technologies Data](/api/~endpoints#technology):** Know what technologies are used by your target websites and enhance lead qualification.
- **[Seamless Integrations](/integrations):** Extend functionality with integrations for Google Sheets, Chrome, Firefox, Edge, Opera, Excel add-ons, and more.
- **[Advanced API Integration](https://tomba.io/api):** Easily incorporate our powerful tools into your existing workflows.
Explore our features and see how Tomba.io can transform your outreach strategy and drive business growth.
---
## Document: HTTPS / SSL
Our API is available over a secure HTTPS connection for all users, including those on the free plan
URL: /https-ssl
# HTTPS / SSL
Our API is available over a secure HTTPS connection for all users, including those on the free plan. Simply prefix your request URLs with `https://` to ensure your calls are secure.
---
## Document: Creating a Free Account
Learn how to quickly create your free Tomba.io account using Google, LinkedIn, GitHub, or email.
URL: /free-account
# Creating a Free Account
Getting started with Tomba.io is simple and flexible. Whether you prefer using your existing Google account, LinkedIn profile, GitHub account, or simply registering with your email, our streamlined process has you covered.
👉 **[Click here to get started](https://app.tomba.io/auth/signin)**
## Sign Up Options
### 1. Google Login
- Click the **"Sign Up with Google"** button.
- You will be redirected to Google for authentication.
- Once authenticated, you'll be automatically redirected back to Tomba.io with your account set up.
### 2. LinkedIn Login
- Choose the **"Sign Up with LinkedIn"** option.
- Authenticate using your LinkedIn credentials.
- After a successful login, your Tomba.io account will be created using your LinkedIn information.
### 3. GitHub Login
- Select the **"Sign Up with GitHub"** option.
- You’ll be redirected to GitHub for secure authentication.
- After confirming access, your account on Tomba.io will be instantly created.
### 4. Email Registration
- Select the **"Sign Up with Email"** option.
- Enter your details: name, email, and password.
- Verify your email address by clicking the confirmation link sent to your inbox.
Start building smarter outreach workflows in minutes with Tomba.io 🚀
---
## Document: Key Features and Endpoints
Explore the comprehensive list of API endpoints available on Tomba.io along with detailed descriptions and key features for each.
URL: /features
# Key Features and Endpoints
Tomba.io provides a robust and extensive set of API endpoints designed to power your email discovery, enrichment, and lead generation workflows. Below is a complete overview of the main API features available, each with a short description, core capabilities, and relevant links to explore more.
---
## [Account Information](https://app.tomba.io/settings/)
**Description:** Retrieve detailed information about your Tomba.io account, including subscription, settings, and usage.
**Features:**
- Access profile and billing data.
- Monitor plan quotas and consumption.
- Customize preferences and security settings.
---
## [Domain Search](https://tomba.io/domain-search)
**Description:** Search for professional email addresses and company data using a domain name.
**Features:**
- Retrieve verified email lists per domain.
- Filter by department or seniority.
- Access domain metadata and company info.
---
## [Email Finder](https://tomba.io/email-finder)
**Description:** Find a specific email address by entering a name and domain.
**Features:**
- Search by full name and domain.
- Get confidence score and status.
- Great for outbound prospecting.
---
## [Email Enrichment](https://tomba.io/enrichment)
**Description:** Enrich email data with social, company, and location details.
**Features:**
- Augment leads with verified metadata.
- Identify job roles, social handles, and company info.
- Improve targeting and segmentation.
---
## [Author Finder](https://tomba.io/author-finder)
**Description:** Find emails of blog authors and contributors on websites.
**Features:**
- Discover authors of online content.
- Useful for PR and media outreach.
- Filter by source or publication type.
---
## [LinkedIn Finder](https://tomba.io/linkedin-finder)
**Description:** Use a LinkedIn profile URL to discover the associated professional email.
**Features:**
- Extract verified emails directly from LinkedIn URLs.
- Fast and accurate with a high match rate.
- Ideal for recruiters and B2B sales teams.
---
## [Email Verifier](https://tomba.io/email-verifier)
**Description:** Validate any email address for deliverability.
**Features:**
- Check SMTP and MX records.
- Return real-time status.
- Reduce bounce rates and spam flags.
---
## [Email Sources](https://tomba.io/email-finder#sources)
**Description:** View the original URLs where Tomba found the email.
**Features:**
- Ensure traceability and authenticity.
- Display source page, date, and context.
- Useful for compliance and transparency.
---
## [Phone Finder](https://tomba.io/phone-finder)
**Description:** Discover phone numbers linked to domains or emails.
**Features:**
- Get company and contact-level numbers.
- Validate phone numbers for accuracy.
- Complement email-based outreach.
---
## [Usage Stats](https://app.tomba.io/usage)
**Description:** Track your API consumption and usage limits.
**Features:**
- Visualize API call history.
- Optimize usage with quota analysis.
- Real-time updates.
---
## [Leads](https://app.tomba.io/leads)
**Description:** Fetch leads based on company, industry, or location filters.
**Features:**
- Search leads using smart filters.
- Export lead data to your CRM.
- Segment by industry, size, role, etc.
---
## [Lead Lists](https://app.tomba.io/leads/lists)
**Description:** Create and manage groups of leads for campaign targeting.
**Features:**
- Organize leads by project or region.
- Share lists across your team.
- Import/export CSVs in bulk.
---
## Lead Attributes
**Description:** Access enriched metadata for a specific lead.
**Features:**
- Get role, company, social profiles, etc.
- Enhance targeting and personalization.
- Improve scoring models.
---
## [Account Logs](https://app.tomba.io/usage/requests)
**Description:** View activity logs for API events and account changes.
**Features:**
- Review login, API, and team events.
- Ensure team and system accountability.
- Audit changes and permissions.
---
## [API Keys](https://app.tomba.io/api)
**Description:** Manage your API access credentials securely.
**Features:**
- Generate new keys or revoke old ones.
- Rotate secrets securely.
- Maintain seamless integration.
---
## [Email Count](https://tomba.io/domain-search)
**Description:** Quickly get the total number of emails found on a domain.
**Features:**
- Check email availability at scale.
- Preview lead potential before diving in.
- Use in dashboards or decision logic.
---
## [Technology Detection](/api/~endpoints#technology)
**Description:** Detect what technologies (e.g. CMS, analytics) a site is using.
**Features:**
- Know what tools your leads are using.
- Great for MarTech and SaaS targeting.
- Identify platform opportunities.
---
## [Similar Websites](/api/~endpoints#similar)
**Description:** Discover competitors or look-alike domains.
**Features:**
- Get sites similar to a given domain.
- Useful for expanding prospect lists.
- Unlock market clusters easily.
---
Each of these endpoints is documented with request parameters, examples, and responses in our [API Reference Documentation](https://docs.tomba.io/api). Start exploring the full power of the Tomba.io API today 🚀
---
## Document: Frequently Asked Questions
Common questions and answers about Tomba.io email intelligence platform, API usage, billing, and integrations
URL: /faqs
# Frequently Asked Questions
# Frequently Asked Questions
Find answers to the most common questions about Tomba.io's email intelligence platform.
## General Platform Questions
### What is Tomba.io?
Tomba.io is a comprehensive email intelligence platform that helps businesses find, verify, and enrich professional email addresses. Our platform provides:
- **Email Discovery**: Find email addresses using names and company domains
- **Email Verification**: Validate email deliverability and existence
- **Data Enrichment**: Enhance contacts with additional professional information
- **Bulk Operations**: Process large datasets efficiently
- **Real-time APIs**: Fast, reliable REST endpoints for integration
### How accurate is Tomba.io's data?
Our platform maintains high accuracy through:
- **Multi-source verification**: We cross-reference data from multiple sources
- **Regular updates**: Our database is refreshed monthly with new data
- **Confidence scoring**: Each result includes a confidence score (0-100)
- **Real-time verification**: Email addresses are checked for deliverability
- **Quality metrics**: We track and report accuracy statistics
Typical accuracy rates:
- Email Finder: 85-95% accuracy for valid professional emails
- Email Verification: 99%+ accuracy for deliverability status
- Company Data: 90%+ accuracy for business information
### What data sources does Tomba.io use?
We aggregate data from various legitimate sources:
- **Public web data**: Company websites, directories, and public profiles
- **Social media**: Professional networks like LinkedIn (within ToS)
- **Business databases**: Publicly available business registrations
- **User contributions**: Verified data from our community
- **Partner networks**: Data from trusted business intelligence partners
All data collection follows GDPR, CCPA, and other privacy regulations.
### Is Tomba.io GDPR compliant?
Yes, Tomba.io is fully GDPR compliant. We:
- **Process data lawfully**: Based on legitimate business interests
- **Respect user rights**: Support access, correction, and deletion requests
- **Implement data protection**: Use encryption and secure storage
- **Honor opt-outs**: Maintain suppression lists for opted-out individuals
- **Provide transparency**: Clear privacy policies and data usage information
Users can request data removal at any time through our support channels.
## API and Technical Questions
### How do I get started with the Tomba.io API?
Getting started is simple:
1. **Sign up**: Create a free account at [app.tomba.io](https://app.tomba.io)
2. **Get credentials**: Copy your API key and secret from the dashboard
3. **Choose integration**: Use our REST API, MCP servers, or platform integrations
4. **Make test calls**: Start with our email finder or verifier endpoints
5. **Scale up**: Upgrade your plan as your usage grows
See our [Getting Started Guide](./introduction) for detailed instructions.
### What are the API rate limits?
Rate limits vary by subscription plan:
| Plan | Hourly Limit | Monthly Quota |
| -------------- | --------------- | ---------------- |
| **Free** | 25 requests | 25 requests |
| **Startup** | 1,000 requests | 5,000 requests |
| **Growth** | 10,000 requests | 100,000 requests |
| **Enterprise** | Custom | Custom |
Rate limits reset hourly. When limits are exceeded, the API returns HTTP 429 status.
### How do I handle rate limiting?
Best practices for rate limiting:
```python
import time
from requests.exceptions import RequestException
def api_call_with_retry(endpoint, params, max_retries=3):
for attempt in range(max_retries):
try:
response = requests.get(endpoint, params=params)
if response.status_code == 429:
# Rate limited - wait and retry
wait_time = 2 ** attempt # Exponential backoff
time.sleep(wait_time)
continue
return response.json()
except RequestException as e:
if attempt == max_retries - 1:
raise e
time.sleep(1)
```
Additional strategies:
- **Batch requests**: Use bulk endpoints when available
- **Cache results**: Avoid duplicate API calls
- **Monitor usage**: Track consumption in your dashboard
- **Upgrade plan**: Increase limits as needed
### What authentication methods are supported?
Tomba.io supports several authentication methods:
**API Key Authentication (Primary)**
```http
GET /v1/email-finder?first_name=John&last_name=Smith&domain=example.com
X-Tomba-Key: your-api-key
X-Tomba-Secret: your-secret-key
```
**Bearer Token (Legacy)**
```http
Authorization: Bearer your-api-key
```
**MCP Authentication**
Handled automatically by MCP clients using configured credentials.
### How do I integrate with my CRM?
Popular CRM integrations:
**Salesforce**
- Use our REST API with Apex HTTP callouts
- Implement bulk operations for list enrichment
- Set up real-time verification workflows
**HubSpot**
- Use workflows with custom code actions
- Integrate with HubSpot's Operations Hub
- Automate contact enrichment on form submissions
**Pipedrive**
- Use webhooks to trigger enrichment
- Implement custom activities for verification
- Bulk process existing contact databases
**Custom Integration**
Most CRMs support REST API connections. Use our OpenAPI specification for easy integration.
## MCP and AI Integration Questions
### What is Model Context Protocol (MCP)?
Model Context Protocol (MCP) is an open standard for connecting AI models to external tools and data sources. It provides:
- **Secure communication**: Encrypted connections between AI and APIs
- **Structured tool access**: Predefined functions with clear parameters
- **Context management**: Maintain conversation state across interactions
- **Error handling**: Robust error recovery and retry logic
MCP makes it easy to give AI models access to Tomba.io's email intelligence tools.
### Which AI models and editors support MCP?
**Supported Editors:**
- VS Code (with GitHub Copilot and extensions)
- Cursor AI Editor
- Claude Desktop Application
- Zed Editor with AI assistance
- Windsurf IDE
- Various MCP-compatible clients
**AI Models:**
- Claude (Anthropic)
- GPT-4 (OpenAI)
- GitHub Copilot
- Gemini (Google)
- Grok (xAI)
- Custom models via MCP clients
### How do I set up Tomba.io with VS Code and GitHub Copilot?
1. **Install MCP Extension**
- Open VS Code Extensions panel
- Search for "Model Context Protocol"
- Install the official MCP extension
2. **Configure Tomba.io MCP Server**
```json
{
"mcpServers": {
"tomba": {
"command": "tomba-mcp-server",
"args": [],
"env": {
"TOMBA_API_KEY": "your-api-key",
"TOMBA_SECRET": "your-secret"
}
}
}
}
```
3. **Test Integration**
- Ask Copilot: "Find the email address for John Smith at example.com"
- Verify the MCP tools are available and working
See our [VS Code Setup Guide](./llm/editor/vscode) for detailed instructions.
### What's the difference between local and remote MCP servers?
**Local MCP Server**
- Runs on your machine
- Full control over authentication and data
- Better for enterprise and privacy-focused deployments
- Requires local installation and setup
**Remote MCP Server**
- Hosted in the cloud (e.g., Apify platform)
- Simplified setup and maintenance
- Better for rapid prototyping and development
- Managed infrastructure and updates
**Apify MCP Server**
- Hosted by Apify platform
- No local installation required
- Easy VS Code integration
- Includes additional Clearbit data sources
Choose based on your security requirements and technical preferences.
## Billing and Account Questions
### How does Tomba.io pricing work?
Tomba.io uses a credit-based system:
**Credit Consumption:**
- Email Finder: 1 credit per search
- Email Verifier: 1 credit per verification
- Domain Search: 1 credit per email found
- Email Enrichment: 1 credit per enrichment
- Bulk Operations: Credits consumed per processed item
**Plans:**
- **Free**: 25 credits/month
- **Startup**: 5,000 credits/month ($49/month)
- **Growth**: 100,000 credits/month ($199/month)
- **Enterprise**: Custom pricing and limits
Unused credits roll over to the next month (up to plan limits).
### Can I get a refund?
Yes, we offer refunds under certain conditions:
- **14-day money-back guarantee** for new paid subscriptions
- **Partial refunds** for unused credits (case-by-case basis)
- **Service issues**: Full refund if service is unavailable
- **Billing errors**: Immediate correction and refund
Contact our support team at [help.tomba.io](https://help.tomba.io) for refund requests.
### How do I upgrade or downgrade my plan?
You can change plans anytime:
1. **Log in** to your [dashboard](https://app.tomba.io)
2. **Go to Billing** section
3. **Select new plan** that fits your needs
4. **Confirm change** - effective immediately
**Upgrading**: Immediate access to higher limits
**Downgrading**: Takes effect at next billing cycle, credits may be adjusted
### Do you offer enterprise pricing?
Yes, we provide custom enterprise solutions:
**Enterprise Features:**
- Custom credit limits and rate limits
- Dedicated support and success manager
- On-premise deployment options
- Custom SLA agreements
- Volume discounts for high usage
- White-label API options
Contact our sales team for enterprise pricing and features.
## Data Quality and Sources
### How often is the data updated?
Our data refresh schedule:
- **Email verification**: Real-time for each request
- **Company database**: Monthly comprehensive updates
- **Person profiles**: Bi-weekly updates for active profiles
- **Technology data**: Quarterly technology stack analysis
- **Domain information**: Weekly domain registration updates
Major updates are announced in our [changelog](./data/introduction).
### What happens if an email address is invalid?
When verification fails:
- **Clear status**: Result shows "invalid", "unknown", or specific reason
- **Detailed feedback**: Explanation of why verification failed
- **Confidence scoring**: Lower scores for uncertain results
- **Alternative suggestions**: When available, we suggest corrections
- **No charge policy**: Invalid results may not consume credits
Common invalid reasons:
- Mailbox doesn't exist
- Domain doesn't accept email
- Syntax errors in address
- Temporary server issues
### How do you ensure data quality?
Our quality assurance process:
1. **Multi-source verification**: Cross-reference multiple data sources
2. **Real-time validation**: Verify emails at point of delivery
3. **Community feedback**: Users can report incorrect data
4. **Machine learning**: AI models detect and filter low-quality data
5. **Regular audits**: Manual review of high-volume data sources
6. **Confidence scoring**: Transparent quality metrics for each result
### Can I report incorrect data?
Yes, we encourage data quality feedback:
- **Report button**: Available in dashboard results
- **API feedback**: Use our data correction endpoints
- **Support tickets**: Email specific corrections to support
- **Bulk corrections**: Contact us for large-scale data issues
Verified corrections improve our database for all users.
## Integration and Development
### Do you have SDKs or libraries?
Yes, we provide official libraries for popular languages:
- **JavaScript/Node.js**: `npm install @tomba-io/javascript`
- **Python**: `pip install tomba-io`
- **PHP**: `composer require tomba-io/tomba-io`
- **Ruby**: `gem install tomba-io`
- **Go**: `go get github.com/tomba-io/go`
- **C#/.NET**: Available via NuGet
- **Java**: Maven and Gradle support
- **Rust**: `cargo add tomba-io`
See our [Libraries](./libraries) section for complete documentation.
### Can I use Tomba.io in spreadsheets?
Yes, we support several spreadsheet integrations:
**Google Sheets**
- [Google Sheets Add-on](https://workspace.google.com/marketplace/app/tomba_email_extractor_email_finder_plus/915979967841)
- Custom functions for email finding and verification
- Bulk processing capabilities
**Microsoft Excel**
- [Excel Add-in](https://appsource.microsoft.com/en-us/product/office/WA200003632)
- Office 365 and desktop Excel support
- Real-time data refresh
**Airtable**
- Custom API integrations
- Automation and webhook support
### How do I handle errors in my integration?
Robust error handling practices:
```python
import requests
from requests.exceptions import RequestException
def handle_tomba_api_call(endpoint, params):
try:
response = requests.get(endpoint, params=params, timeout=30)
# Check HTTP status
if response.status_code == 200:
return response.json()
elif response.status_code == 429:
# Rate limited
raise RateLimitError("API rate limit exceeded")
elif response.status_code == 401:
# Authentication error
raise AuthError("Invalid API credentials")
elif response.status_code >= 500:
# Server error
raise ServerError("Tomba.io server error")
else:
# Other client errors
raise APIError(f"API error: {response.status_code}")
except requests.exceptions.Timeout:
raise TimeoutError("API request timed out")
except requests.exceptions.ConnectionError:
raise ConnectionError("Unable to connect to Tomba.io")
except RequestException as e:
raise APIError(f"Request failed: {str(e)}")
```
**Error Types:**
- `400`: Bad request - check parameters
- `401`: Authentication failed - verify credentials
- `403`: Forbidden - insufficient permissions
- `404`: Not found - endpoint doesn't exist
- `429`: Rate limited - implement backoff
- `500+`: Server errors - retry with exponential backoff
### What webhook events are available?
Tomba.io supports webhooks for:
- **Bulk operation completion**: When large jobs finish processing
- **Data updates**: When contact information changes
- **Account events**: Billing, usage, and plan changes
- **Verification results**: Real-time email verification updates
- **Error notifications**: Failed API calls and service issues
Configure webhooks in your dashboard under Settings → Webhooks.
## Privacy and Compliance
### How do you handle personal data?
We follow strict data protection principles:
**Data Minimization**
- Only collect necessary business contact information
- No personal consumer data or private information
- Focus on professional, publicly available information
**Lawful Processing**
- Legitimate business interest basis for B2B data
- Consent where required by applicable laws
- Clear opt-out mechanisms for all contacts
**Security Measures**
- End-to-end encryption for all data transmission
- Secure data centers with SOC 2 compliance
- Regular security audits and penetration testing
- Access controls and audit logging
### Can people opt-out of your database?
Yes, we provide multiple opt-out options:
**Individual Opt-out**
- Email us at privacy@tomba.io with removal requests
- Use our online opt-out form
- Automatic processing within 48 hours
**Company-wide Opt-out**
- Domain-level removal for entire organizations
- Bulk opt-out for employee lists
- Permanent suppression list maintenance
**API Integration**
- Check opt-out status via API before outreach
- Respect suppression lists in your applications
- Real-time opt-out verification
### Do you sell personal data?
No, Tomba.io does not sell personal data. We:
- **Provide access**: Through our API and platform tools
- **Maintain ownership**: All data remains in our control
- **Respect privacy**: Honor opt-outs and deletion requests
- **Follow regulations**: Comply with GDPR, CCPA, and other laws
- **Transparent usage**: Clear terms of service and privacy policy
Our business model is subscription-based access to our email intelligence platform.
## Support and Resources
### How can I get help?
Multiple support channels available:
**Documentation**
- [Complete docs](https://docs.tomba.io): Comprehensive guides and references
- [API reference](https://docs.tomba.io/api): Detailed endpoint documentation
- [Code examples](https://github.com/tomba-io): Sample implementations
**Support Portal**
- [Help center](https://help.tomba.io): Knowledge base and FAQs
- **Ticket system**: Direct support for technical issues
- **Live chat**: Real-time assistance during business hours
**Community**
- **GitHub**: Report issues and request features
- **Discord**: Community chat and discussions
- **Blog**: Updates, tutorials, and best practices
**Status and Monitoring**
- [Status page](https://status.tomba.io): Real-time service status
- **Email alerts**: Notifications for service issues
- **API monitoring**: Track performance and uptime
### What's your SLA for API uptime?
**Service Level Commitments:**
- **Uptime**: 99.9% availability (< 8.8 hours downtime/year)
- **Response time**: < 500ms average API response time
- **Support response**: < 24 hours for technical issues
- **Enterprise SLA**: Custom agreements for enterprise customers
**Monitoring and Transparency:**
- Real-time status page with historical data
- Automated alerts for service degradation
- Monthly uptime reports
- Post-mortem analysis for major incidents
### Do you provide onboarding and training?
Yes, we offer comprehensive onboarding:
**Free Resources**
- **Getting started guide**: Step-by-step setup instructions
- **Video tutorials**: Screen recordings for common tasks
- **Code examples**: Ready-to-use implementations
- **Webinars**: Regular training sessions and Q&A
**Paid Support** (Enterprise plans)
- **Dedicated onboarding**: Personal setup assistance
- **Custom training**: Tailored to your use case
- **Implementation guidance**: Best practices for your integration
- **Ongoing support**: Regular check-ins and optimization
### How do I stay updated on new features?
Stay informed about Tomba.io updates:
- **Changelog**: [Monthly updates](./data/introduction) with new features
- **Blog**: In-depth articles about new capabilities
- **Email newsletter**: Monthly platform updates
- **API versioning**: Backward-compatible updates with migration guides
- **GitHub releases**: Technical updates and SDK changes
**Beta Program**
- Early access to new features
- Feedback opportunities for product development
- Direct communication with product team
This FAQ covers the most common questions about Tomba.io. If you can't find the answer you're looking for, please contact our support team or check our comprehensive documentation.
---
## Document: Error Handling
Whenever an API call is not successful, we will return the following response codes:
URL: /error-handling
# Error Handling
Whenever an API call is not successful, we will return the following response codes:
- `401` Invalid API key
- `429` : Rate limit exceeded
- `400` : Other error
- `404` : Invalid request
```json
{
"errors": {
"type": "unknown_route",
"message": "Invalid request, please make sure you follow the documentation for proper syntax",
"code": 404
}
}
```
## Error Codes
Tomba API uses the following error codes:
| Error Code | Meaning |
| ---------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 400 | Bad Request – Your request is invalid. |
| 401 | Unauthorized – Your API key is wrong. |
| 402 | The Email Verification failed due to an unexpected response from the remote SMTP server. This failure is outside our control; we advise you to retry later. |
| 403 | Forbidden – The resource requested is hidden for administrators only. |
| 404 | Not Found – The specified resource could not be found. |
| 405 | Method Not Allowed – You tried to access a resource with an invalid method. |
| 406 | Not Acceptable – You requested a format that isn’t JSON. |
| 410 | Gone – The resource requested has been removed from our servers. |
| 418 | I’m a teapot. |
| 429 | Too Many Requests – You're requesting too many resources! Slow down! |
| 500 | Internal Server Error – We encountered a problem with our server. Try again later. |
| 503 | Service Unavailable – We’re temporarily offline for maintenance. Please try again later. |
---
## Document: 98% Delivery Guarantee - Email Verifier
Tomba.io guarantees 98% deliverability for emails verified through our Email Verifier service, ensuring maximum accuracy and reliability.
URL: /email-verifier-delivery-guarantee
# 98% Delivery Guarantee - Email Verifier
Tomba.io provides an industry-leading **98% Delivery Guarantee** for our Email Verifier service. When you verify email addresses through our advanced verification system, we guarantee that 98% of emails marked as "deliverable" will successfully reach their intended recipients.
---
## What Our 98% Delivery Guarantee Covers
### Scope of Guarantee
Our 98% delivery guarantee applies to emails verified through:
- **[Email Verifier API](https://tomba.io/email-verifier)**: Real-time email verification service
- **[Bulk Email Verification](https://tomba.io/bulks/email-verifier)**: Large-scale email list cleaning
- **Integrated Verification**: Verification through our other services (Email Finder, Domain Search)
- **Chrome Extension**: Email verification through our browser extension
### Verification Results Covered
The guarantee applies to emails with verification results of:
- **`deliverable`**: Email exists and can receive messages
- **`valid`**: Email passes all verification checks
- **`verified`**: Email confirmed through multiple validation methods
---
## Advanced Verification Technology
### Multi-Layer Verification Process
#### 1. **Syntax and Format Validation**
- RFC 5322 compliance checking
- Local and domain part validation
- International domain support
- Special character handling
#### 2. **Domain Verification**
- DNS MX record validation
- Domain existence confirmation
- Mail server availability checking
- Domain reputation analysis
#### 3. **SMTP Verification**
- Real-time SMTP handshake simulation
- Mailbox existence confirmation
- Catch-all detection
- Greylisting identification
#### 4. **Advanced Behavioral Analysis**
- Email pattern recognition
- Historical delivery data analysis
- Spam trap detection
- Disposable email identification
### Real-Time Processing
- **Instant Results**: Verification completed in under 2 seconds
- **Live SMTP Testing**: Real-time connection to mail servers
- **Dynamic Updates**: Results updated based on current server status
- **Global Network**: Verification from multiple geographic locations
---
## Verification Results and Confidence Levels
### Primary Results
#### Deliverable (98% Guarantee Applies)
- **Score Range**: 85-100
- **Meaning**: Email exists and can receive messages
- **Guarantee**: 98% delivery success rate
- **Recommendation**: Safe to send
#### Undeliverable
- **Score Range**: 0-25
- **Meaning**: Email doesn't exist or will bounce
- **Action**: Remove from lists immediately
- **Accuracy**: 99.9% bounce prediction
#### Risky
- **Score Range**: 26-84
- **Meaning**: Email exists but may have delivery issues
- **Recommendation**: Proceed with caution
- **Common Issues**: Catch-all, role-based, or filtered emails
#### Unknown
- **Score Range**: Variable
- **Meaning**: Cannot determine deliverability
- **Causes**: Server timeouts, greylisting, or restrictions
- **Action**: Manual review recommended
### Enhanced Result Details
#### Detailed Attributes
- **Gibberish Detection**: Identifies nonsensical email addresses
- **Disposable Email Detection**: Flags temporary email services
- **Role-Based Detection**: Identifies generic addresses (info@, admin@)
- **Webmail Detection**: Distinguishes personal vs. business emails
#### Risk Indicators
- **Spam Trap Risk**: Probability of being a spam trap
- **Catch-All Status**: Whether domain accepts all emails
- **Mailbox Full**: Detection of full mailboxes
- **Accept-All**: Domains that appear to accept everything
---
## Guarantee Terms and Conditions
### Eligibility Requirements
#### Qualifying Verification
- Emails verified through official Tomba.io services
- Results marked as "deliverable" with scores 85+
- Verification completed within the last 30 days
- Proper sending practices followed
#### Sending Requirements
- Use authenticated sending domains (SPF, DKIM, DMARC)
- Maintain good sender reputation
- Follow email marketing best practices
- Comply with anti-spam regulations
### Measurement Standards
#### Success Criteria
- **Primary Metric**: Email successfully delivered to inbox
- **SMTP Success**: 250 OK response from receiving server
- **No Hard Bounces**: No permanent delivery failures
- **Inbox Placement**: Message reaches primary inbox folder
#### Exclusions from Guarantee
- **Soft Bounces**: Temporary delivery issues (full mailbox, server down)
- **Content Filtering**: Emails blocked due to content or sender reputation
- **Recipient Filtering**: User-defined rules or personal blocking
- **Rate Limiting**: ISP throttling or temporary restrictions
---
## Quality Assurance Measures
### Continuous Monitoring
#### Real-Time Quality Checks
- Live SMTP server monitoring
- Continuous accuracy validation
- Performance metric tracking
- False positive detection
#### Historical Analysis
- Delivery outcome tracking
- Accuracy improvement algorithms
- Pattern recognition updates
- Machine learning optimization
### Global Infrastructure
#### Distributed Verification Network
- Multiple verification points worldwide
- Redundant SMTP testing
- Load balancing and failover
- Regional optimization
#### Server Partnerships
- Direct relationships with major ISPs
- Trusted sender status
- Whitelist maintenance
- Delivery feedback loops
---
## Claim Process for Guarantee
### Claim Eligibility
#### When to Submit a Claim
- Delivery rate below 98% for verified emails
- Systematic hard bounces on "deliverable" emails
- Consistent verification inaccuracies
- Pattern of false positives
#### Required Metrics
- Minimum of 100 verified emails for statistical significance
- Verification must be completed within 30 days
- Proper sending authentication required
- Detailed delivery logs necessary
### Documentation Requirements
#### Verification Records
- Complete list of verified emails with scores
- Tomba.io verification timestamps and results
- Original verification confidence scores
- Batch processing records if applicable
#### Delivery Evidence
- SMTP delivery logs and bounce messages
- Email service provider delivery reports
- Bounce categorization (hard vs. soft)
- Timeline of sending attempts
#### Technical Information
- Sending domain authentication records
- Sender reputation scores
- Email content and headers (if relevant)
- ISP feedback and block notifications
### Claim Resolution Process
#### Step 1: Initial Review (1-2 Business Days)
- Verification of claim eligibility
- Documentation completeness check
- Preliminary analysis of delivery patterns
- Assignment to specialist team
#### Step 2: Technical Analysis (3-5 Business Days)
- Detailed review of verification accuracy
- SMTP log analysis
- Cross-reference with our quality metrics
- Investigation of delivery failures
#### Step 3: Resolution (2-3 Business Days)
- Determination of guarantee applicability
- Calculation of service credits or remedies
- Implementation of account improvements
- Communication of results and next steps
---
## Remedies and Compensation
### Service Credit Structure
#### Credit Calculation
- **Standard Rate**: 2x credits for each failed verification
- **Premium Accounts**: 3x credits plus additional services
- **Enterprise Clients**: Custom compensation packages
- **Bulk Users**: Volume-based credit adjustments
#### Credit Application
- Automatic application to account balance
- Can be used for any Tomba.io services
- No expiration date on guarantee credits
- Transferable between team members
### Enhanced Services
#### Priority Re-verification
- Free re-verification of problematic emails
- Enhanced verification algorithms applied
- Priority processing queue access
- Dedicated account specialist support
#### Account Optimization
- Personal consultation with verification experts
- Custom verification rule development
- Integration optimization assistance
- Advanced feature access
---
## Optimization Best Practices
### Pre-Verification Preparation
#### Email List Hygiene
- Remove obvious invalid formats
- Clean duplicates and variations
- Segment by source and age
- Prioritize high-value contacts
#### Batch Processing
- Optimal batch sizes (500-1000 emails)
- Appropriate timing intervals
- Monitor processing status
- Handle API rate limits properly
### Post-Verification Actions
#### Result Segmentation
- **High Confidence (95-100)**: Priority sending
- **Good Confidence (85-94)**: Standard campaigns
- **Lower Confidence (Below 85)**: Additional verification or exclusion
- **Special Cases**: Manual review for important contacts
#### List Maintenance
- Regular re-verification (quarterly recommended)
- Monitor bounce rates continuously
- Update verification status based on delivery outcomes
- Maintain suppression lists for hard bounces
---
## Advanced Features for Higher Accuracy
### Enhanced Verification Options
#### Deep SMTP Analysis
- Multi-step SMTP conversation simulation
- Advanced server response interpretation
- Custom timeout configurations
- Retry logic optimization
#### AI-Powered Predictions
- Machine learning delivery predictions
- Historical pattern analysis
- Behavioral modeling
- Risk assessment algorithms
### Integration Capabilities
#### Real-Time API
- Instant verification results
- Bulk processing endpoints
- Custom field mapping
#### Third-Party Integrations
- CRM system connections
- Email marketing platform sync
- Data enrichment workflows
- Automated list cleaning
---
## Monitoring and Analytics
### Performance Dashboard
Access comprehensive analytics through your Tomba.io dashboard:
- **Verification Accuracy Tracking**: Real-time accuracy metrics
- **Delivery Rate Monitoring**: Track guarantee compliance
- **Historical Performance**: Long-term accuracy trends
- **Comparative Analysis**: Benchmark against industry standards
### Automated Alerts
- **Accuracy Threshold Alerts**: Notifications when accuracy drops
- **Volume Processing Updates**: Status of large batch verifications
- **System Status Notifications**: Service availability updates
- **Guarantee Performance Reports**: Monthly guarantee compliance summaries
---
## Support and Contact Information
### Guarantee Support Team
Specialized support for delivery guarantee issues:
- **Email**: [info@tomba.io](mailto:info@tomba.io)
- **Priority Support**: Available for guarantee-related issues
- **Technical Consultation**: Expert advice on verification optimization
- **Account Management**: Dedicated support for enterprise clients
### Response Time Commitments
- **Guarantee Claims**: Response within 24 hours
- **Technical Issues**: Response within 4 hours
- **General Inquiries**: Response within 2 hours during business hours
- **Emergency Support**: Available 24/7 for critical issues
---
## Frequently Asked Questions
### Q: How does the 98% guarantee compare to the 95% Email Finder guarantee?
A: The Email Verifier has a higher guarantee (98%) because it performs additional real-time validation checks on existing emails, while Email Finder discovers new emails which inherently carry slightly more uncertainty.
### Q: What's the minimum number of verifications needed to claim the guarantee?
A: We require a minimum of 100 verified emails marked as "deliverable" to ensure statistical significance for guarantee claims.
### Q: How often should I re-verify email addresses?
A: We recommend re-verification every 3-6 months for active lists, or immediately before important campaigns, to maintain the highest accuracy.
### Q: Do verification results expire?
A: Verification results remain valid for 30 days under our guarantee. After that, email deliverability may change due to factors outside our control.
### Q: Can I get a refund instead of service credits?
A: Our standard remedy is service credits, but enterprise clients may have different arrangements based on their service agreements.
---
Our 98% Delivery Guarantee for Email Verifier represents the highest standard in email verification accuracy, backed by advanced technology and our commitment to your success.
---
## Document: 95% Delivery Guarantee - Email Finder
Tomba.io guarantees 95% deliverability for emails found through our Email Finder service, backed by advanced verification and quality assurance.
URL: /email-finder-delivery-guarantee
# 95% Delivery Guarantee - Email Finder
Tomba.io stands behind the quality of our Email Finder service with a **95% Delivery Guarantee**. When you use our Email Finder to discover professional email addresses, we guarantee that 95% of the emails will be deliverable and reach their intended recipients.
---
## What Our 95% Delivery Guarantee Covers
### Scope of Guarantee
Our 95% delivery guarantee applies to emails discovered through:
- **[Email Finder API](https://tomba.io/email-finder)**: Direct email discovery using name and domain
- **[Domain Search](https://tomba.io/domain-search)**: Company-wide email discovery
- **[Author Finder](https://tomba.io/author-finder)**: Content author email discovery
- **[LinkedIn Finder](https://tomba.io/linkedin-finder)**: Professional email discovery from LinkedIn profiles
### Quality Metrics
- **Deliverability Rate**: 95% of discovered emails will be deliverable
- **Validity Verification**: All emails pass basic format and domain validation
- **Active Mailbox**: Emails reach active, monitored mailboxes
- **Real-time Status**: Up-to-date deliverability information
---
## How We Achieve 95% Deliverability
### Advanced Discovery Methods
#### 1. **Multi-Source Verification**
- Cross-reference emails from multiple public sources
- Validate against company websites and directories
- Verify through social media profiles and professional networks
- Confirm with business registration data
#### 2. **Pattern Recognition**
- Analyze company email patterns and formats
- Use machine learning to predict valid email structures
- Apply domain-specific formatting rules
- Validate against known corporate email schemes
#### 3. **Real-time Validation**
- SMTP server verification for each discovered email
- MX record validation for domain authenticity
- Mailbox existence confirmation
- Bounce prediction algorithms
### Quality Assurance Process
#### Pre-Discovery Filtering
- Domain reputation analysis
- Company legitimacy verification
- Public data source validation
- Pattern reliability assessment
#### Post-Discovery Verification
- Comprehensive deliverability testing
- Format validation and standardization
- Duplicate detection and removal
- Confidence score calculation
---
## Confidence Scoring System
Every email discovered through our Email Finder includes a confidence score that indicates delivery probability:
### Score Ranges
- **90-100**: Very High - Guaranteed deliverable
- **80-89**: High - Highly likely to deliver
- **70-79**: Good - Good delivery probability
- **60-69**: Medium - Moderate confidence
- **Below 60**: Lower confidence (not covered by guarantee)
### Factors Affecting Scores
- **Source Quality**: Reliability of the discovery source
- **Verification Results**: SMTP and MX validation outcomes
- **Pattern Matching**: Accuracy of email format prediction
- **Historical Data**: Past performance of similar emails
---
## Guarantee Terms and Conditions
### Eligibility Requirements
#### Qualifying Usage
- Emails discovered through official Tomba.io APIs or tools
- Confidence scores of 60 or higher
- Used within 30 days of discovery
- Proper email authentication and sending practices
#### Proper Implementation
- Follow email marketing best practices
- Use appropriate email authentication (SPF, DKIM, DMARC)
- Maintain good sender reputation
- Comply with anti-spam regulations
### Measurement Criteria
#### Delivery Success Metrics
- Email reaches recipient's mailbox (not spam folder)
- No hard bounces or permanent delivery failures
- Successful SMTP transaction completion
- Recipient server accepts the message
#### Exclusions
- Soft bounces due to temporary issues
- Spam folder placement (if email is delivered)
- Recipient-side filtering or blocking
- ISP throttling or rate limiting
---
## Claim Process
### When to File a Claim
Submit a delivery guarantee claim if:
- Your delivery rate falls below 95% for qualifying emails
- You experience consistent hard bounces
- Email addresses are consistently invalid
- Systematic delivery failures occur
### Required Documentation
- **Email List**: Complete list of discovered emails
- **Delivery Reports**: Detailed bounce and delivery logs
- **Confidence Scores**: Tomba.io provided confidence ratings
- **Timeline**: Dates of discovery and sending attempts
- **Technical Details**: SMTP logs and error messages
### Claim Submission Process
#### Step 1: Gather Evidence
- Export your email discovery history from Tomba.io
- Compile delivery reports from your email service provider
- Document specific bounces and delivery failures
- Calculate your actual delivery rate
#### Step 2: Submit Claim
- Contact our support team at [info@tomba.io](mailto:info@tomba.io)
- Provide all required documentation
- Include your account details and usage period
- Specify the delivery rate discrepancy
#### Step 3: Review Process
- Our team reviews your claim within 5 business days
- We verify the discovery methods and confidence scores
- Technical analysis of delivery failures
- Assessment of compliance with guarantee terms
---
## Remedies and Compensation
### Available Remedies
#### Service Credits
- Additional API credits equal to failed email discoveries
- Bonus credits for future email discovery services
- Extended service periods to compensate for poor performance
- Priority support for account optimization
#### Re-Discovery Services
- Free re-discovery of failed email addresses
- Enhanced verification for problematic domains
- Alternative email discovery methods
- Updated contact information research
#### Account Optimization
- Personal consultation on delivery best practices
- Email authentication setup assistance
- Sender reputation improvement guidance
- Custom integration support
### Credit Calculation
Service credits are calculated based on:
- Number of failed email discoveries
- Percentage below the 95% guarantee threshold
- Account tier and subscription level
- Historical account performance
---
## Best Practices for Maximum Deliverability
### Email Discovery Optimization
#### Target Quality Sources
- Focus on high-confidence score emails (80+)
- Prioritize recently updated contact information
- Use multiple discovery methods for verification
- Cross-reference with existing contact databases
#### Timing Considerations
- Use discovered emails promptly (within 30 days)
- Verify emails before large campaigns
- Monitor delivery rates continuously
- Update contact lists regularly
### Sending Best Practices
#### Technical Setup
- Implement proper SPF, DKIM, and DMARC records
- Use dedicated IP addresses for high-volume sending
- Maintain consistent sending patterns
- Monitor sender reputation scores
#### Content and Compliance
- Follow CAN-SPAM and GDPR requirements
- Provide clear unsubscribe mechanisms
- Personalize messages appropriately
- Avoid spam trigger words and phrases
---
## Monitoring and Reporting
### Delivery Analytics
We provide comprehensive analytics to help you track and optimize delivery performance:
- **Real-time Delivery Rates**: Monitor your current delivery performance
- **Confidence Score Trends**: Track the quality of discovered emails over time
- **Bounce Analysis**: Detailed breakdown of delivery failures
- **Historical Performance**: Long-term delivery rate trends
### Performance Alerts
- Automated notifications when delivery rates drop below thresholds
- Early warning system for potential delivery issues
- Recommendations for improvement actions
- Proactive support team outreach
---
## Technical Support
### Guarantee Support Team
Our specialized guarantee support team provides:
- **Technical Consultation**: Expert advice on delivery optimization
- **Integration Support**: Help with API implementation and best practices
- **Performance Analysis**: Detailed review of your delivery metrics
- **Custom Solutions**: Tailored approaches for specific use cases
### Contact Information
- **Guarantee Claims**: [info@tomba.io](mailto:info@tomba.io)
- **Technical Support**: [support@tomba.io](mailto:support@tomba.io)
---
## Frequently Asked Questions
### Q: What happens if my delivery rate is exactly 95%?
A: You meet our guarantee threshold and no remedial action is required. Our guarantee covers delivery rates of 95% or higher.
### Q: Do temporary bounces count against the guarantee?
A: No, only permanent hard bounces count against the delivery guarantee. Temporary issues like full mailboxes or server downtime are excluded.
### Q: How quickly must I use discovered emails to maintain guarantee coverage?
A: Emails must be used within 30 days of discovery to remain covered by our delivery guarantee.
### Q: Can I transfer guarantee coverage between different email campaigns?
A: Yes, the guarantee applies to the emails themselves, not specific campaigns, as long as they meet our usage requirements.
---
This 95% Delivery Guarantee reflects our confidence in the Email Finder service and our commitment to providing you with the highest quality professional email addresses available.
---
## Document: Data
Learn how Tomba.io gathers and processes high-quality business data from the public web and delivers verified results at scale.
URL: /data
# Data
When you use Tomba.io, you're tapping into one of the most advanced and comprehensive datasets on the public web. We analyze and process **over 2 billion pages monthly** to index fresh, relevant business data with **zero reliance on third-party data providers**.
You can explore how our robot works [here](https://tomba.io/robot).
---
## How We Find Email Addresses
We use a combination of powerful **web crawlers** and **smart algorithms** to build the most accurate B2B email database.
### 1. **Collecting Publicly Available Emails**
Our crawlers scan:
- Blog posts
- Company websites
- PDFs, XLS files
- Forums and comment sections
These emails are **publicly accessible**, and we store only what’s relevant and verified.
### 2. **Guessing Emails with Algorithms**
We use pattern recognition like:
- `firstname.lastname@domain.com`
- `f.lastname@domain.com`
We iterate intelligently based on company email formats. If the guessed email is likely valid, we return it with a **confidence score (0–100)**.
---
## Crawlers – Our Backbone
Tomba’s crawlers don’t just find emails. They perform dozens of specialized tasks to enrich and verify every record:
### 🔧 Jobs Performed by Our Crawlers
- DNS, WHOIS, and SMTP resolution
- Detect gender from names
- Real-time data enrichment
- Identify and update personal vs. generic emails
- Discover and store email patterns for each domain
- Extract website descriptions and social media links
- Detect and store geolocation (country, city, ZIP, state)
- Validate and delete invalid records
- Add phone numbers and tech stack data
We crawl and process over **2 billion URLs each month**, constantly refining our database to maintain accuracy and freshness.
> 🧼 **Data Cleanliness:** We only store about **6%** of crawled emails and strictly avoid personal emails (like Gmail, Yahoo, Outlook).
---
## What We Don’t Store
At Tomba.io, data quality and privacy are our priorities:
- ❌ **No duplicate records**
- ❌ **No personal webmail addresses**
- ❌ **No fake or low-confidence emails**
---
## Data at Scale
Tomba.io is home to the **largest professional email database**:
| Metric | Value |
| ---------------------- | ------------ |
| B2B Emails | 450+ million |
| Unique Company Domains | 70+ million |
| URLs Crawled Monthly | 2+ billion |
All data is unified under a **global standardized schema** ready to use and integrate.
---
## Types of Data We Provide
Tomba.io provides much more than emails. Here are the categories of data we crawl, enrich, and deliver:
- **[Website Data](/attributes/company):** Metadata, descriptions, contact details, social links, and company details.
- **[LinkedIn Data](https://tomba.io/linkedin-finder):** Find emails via LinkedIn URLs with precision.
- **[Technologies Used](/api/~endpoints#technology):** Identify what tools and platforms the domain is built on.
- **[Similar Websites](/api/~endpoints#similar):** Get competitor and look-alike sites to target similar businesses.
---
By combining web-scale crawling, real-time enrichment, and intelligent filtering, **Tomba.io delivers the cleanest and most powerful B2B data in the market** helping you connect with your ideal prospects at scale. 🚀
---
## Document: Dashboard Overview
Explore the comprehensive features of the Tomba.io Dashboard for efficient account management and task monitoring.
URL: /dashboard
# Dashboard Overview
The Tomba.io Dashboard is your centralized command center, offering a complete view of your account activities, usage statistics, and essential tools for managing your email discovery and outreach efforts.
## Key Features
### Usage & Activity Monitoring
- **[API Call Monitoring](https://app.tomba.io/usage):** Keep track of your API calls in real time, view your remaining quota, and analyze historical usage.
- **Task History & Activity Log:** Monitor the progress of your bulk tasks and review past operations to optimize future strategies.
- **Notifications & Alerts:** Receive real-time alerts on task completions, quota updates, and critical system notifications.
### Navigation & Tools
- **Quick Access Menu:** Effortlessly navigate between essential features such as [Email Finder](https://app.tomba.io), [Domain Search](https://tomba.io/domain-search), [Enrichment](https://tomba.io/enrichment), and Phone Discovery & Validation.
- **Custom Reports:** Generate and export detailed reports to analyze your performance metrics and campaign success.
### Integrations & Add-Ons
- **Seamless Integrations:** Connect with your favorite tools including Google Sheets, Excel add-ons, and browser extensions (Chrome, Firefox, Edge, Opera) to enhance your workflow.
- **Enrichment Tools:** Utilize advanced email and domain enrichment features to gain deeper insights and improve data quality.
### Account Management
- **[Profile Settings](https://app.tomba.io/settings/):** Update your personal information, manage security settings, and customize your dashboard preferences.
- **[Subscription & Upgrade Options](https://app.tomba.io/settings/subscription):** View your current plan details and easily upgrade to access higher limits and additional features.
- **[Connected Apps](https://app.tomba.io/integrations):** Manage third-party integrations and connected platforms.
### Bulk Task Management
- **Efficient Bulk Operations:** Initiate and manage large-scale tasks with ease, from email validation to data enrichment, ensuring you save time and resources.
- **Task Scheduling:** Plan and schedule tasks to run automatically, allowing you to focus on strategic activities.
## Getting Started with Your Dashboard
1. **[Log In](https://app.tomba.io/auth/signin):** Use your preferred authentication method (Google, LinkedIn, GitHub, or Email) to access your account.
2. **Explore:** Familiarize yourself with the layout and available tools by navigating through the quick access menu.
3. **Monitor & Manage:** Use the dashboard’s monitoring tools to keep an eye on your [API usage](https://app.tomba.io/usage), task progress, and account notifications.
4. **Integrate:** Connect external tools and add-ons through the [Connected Apps](https://app.tomba.io/integrations) section to streamline your workflow.
---
### Developer Access
Want to automate or integrate? Head to the **[API Console](https://app.tomba.io/api)** to generate your keys and start building with Tomba.io today.
The Tomba.io Dashboard is designed to empower you with a clear, concise, and effective overview of your operations. Dive in and explore the features that will help you maximize productivity and drive better outcomes.
---
## Document: API Key and Authentication
Understand how to securely authenticate and manage requests using your Tomba.io API credentials.
URL: /authentication
# API Key and Authentication
To access the Tomba.io API, you must authenticate every request using a unique **API key** and **secret**. These credentials are required for all endpoints and ensure that your usage is tracked correctly.
> **Important:** Your API key and secret identify your account keep them safe. Do not share them publicly or embed them in frontend code.
You can generate, regenerate, or revoke your API keys at any time from your [API Keys 🔑 ](https://app.tomba.io/api).
## Required Authentication Headers
Include the following headers in every request:
| Field | Header Name | Location |
| ------- | ---------------- | -------- |
| API Key | `X-Tomba-Key` | `header` |
| Secret | `X-Tomba-Secret` | `header` |
Example usage in `curl`:
```bash
curl -X GET "https://api.tomba.io/v1/domain-search?domain=example.com" \
-H "X-Tomba-Key: your_api_key" \
-H "X-Tomba-Secret: your_secret_key"
```
---
## Document: Anti-Spam Policy
Tomba.io's comprehensive anti-spam policy ensuring responsible email usage and compliance with email marketing regulations.
URL: /anti-spam-policy
# Anti-Spam Policy
At Tomba.io, we are committed to maintaining the highest standards of email integrity and combating spam. Our anti-spam policy ensures that all users utilize our services responsibly and in compliance with applicable laws and regulations.
---
## Our Commitment to Anti-Spam
We take a zero-tolerance approach to spam and have implemented comprehensive measures to ensure our platform is used only for legitimate business purposes.
### Key Principles
- **No Spam Generation**: Our services are designed to help find and verify legitimate business emails, not to facilitate spam
- **Compliance First**: We adhere to all major anti-spam regulations including CAN-SPAM, GDPR, and CASL
- **Quality Over Quantity**: We prioritize email quality and deliverability over volume
---
## Prohibited Uses
Users are strictly prohibited from using Tomba.io services for:
### Spam Activities
- Sending unsolicited bulk emails or mass marketing campaigns
- Creating email lists for spam purposes
- Harvesting emails for unauthorized marketing
- Cold outreach without proper opt-in mechanisms
### Malicious Activities
- Phishing attempts or fraudulent communications
- Distributing malware or harmful content
- Identity theft or impersonation
- Any illegal or unethical email practices
### Violations of Third-Party Rights
- Scraping emails from protected sources
- Violating website terms of service
- Infringing on privacy rights
- Unauthorized data collection
---
## Compliance Requirements
### For Email Marketing
If you plan to use discovered emails for marketing purposes, you must:
1. **Obtain Proper Consent**: Ensure you have legitimate interest or explicit consent
2. **Provide Clear Opt-Out**: Include unsubscribe mechanisms in all emails
3. **Honor Opt-Out Requests**: Process unsubscribe requests promptly
4. **Include Identification**: Clearly identify yourself and your organization
5. **Follow Local Laws**: Comply with applicable regulations in your jurisdiction
### For Cold Outreach
When using our services for business development:
1. **Legitimate Business Purpose**: Ensure your outreach serves a genuine business purpose
2. **Personalized Communication**: Avoid generic, mass-produced messages
3. **Respect Boundaries**: Honor requests to stop communication
4. **Professional Standards**: Maintain high standards of professionalism
---
## Technical Safeguards
### Built-in Protection
- **Rate Limiting**: Prevents bulk scraping and automated abuse
- **Quality Filters**: Our algorithms filter out low-quality and suspicious emails
- **Source Verification**: We verify the legitimacy of email sources
- **Pattern Recognition**: Advanced detection of spam-like usage patterns
### Monitoring Systems
- **Usage Analytics**: Continuous monitoring of user behavior patterns
- **Abuse Detection**: Automated systems to identify potential misuse
- **Manual Reviews**: Human oversight for suspicious activities
- **Compliance Audits**: Regular reviews of user practices
---
## User Responsibilities
### Before Using Our Services
- Review and understand our Terms of Service
- Ensure compliance with applicable laws in your jurisdiction
- Implement proper consent mechanisms for your use case
- Establish clear data protection policies
### During Usage
- Use emails only for their intended legitimate purposes
- Maintain accurate records of consent and opt-outs
- Monitor your email delivery rates and reputation
- Report any suspicious or problematic contacts
### Data Protection
- Implement appropriate security measures for stored emails
- Limit access to email data on a need-to-know basis
- Regularly audit and clean your email lists
- Respect data retention limits and deletion requests
---
## Enforcement Actions
Violation of this anti-spam policy may result in:
### Immediate Actions
- Temporary suspension of account access
- Rate limiting or API throttling
- Mandatory compliance review
- Required training or certification
### Severe Violations
- Permanent account termination
- Legal action if warranted
- Reporting to relevant authorities
- Cooperation with law enforcement
---
## Reporting Spam or Abuse
We encourage users to report suspected spam or policy violations:
### How to Report
- **Email**: Send details to [abuse@tomba.io](mailto:abuse@tomba.io)
- **Support Portal**: Submit a ticket through our help center
- **Emergency**: For urgent matters, contact our security team
### Information to Include
- Account details of the suspected violator
- Evidence of policy violation
- Impact on your organization or users
- Any relevant documentation
---
## Best Practices for Legitimate Use
### Email Discovery
- Use our services to find publicly available business contacts
- Verify the relevance of contacts to your business needs
- Cross-reference with existing CRM data to avoid duplicates
- Focus on quality over quantity in your contact lists
### Email Verification
- Verify emails before adding them to your campaigns
- Use our verification scores to prioritize high-quality contacts
- Regularly clean and update your email lists
- Monitor bounce rates and engagement metrics
### Outreach Strategy
- Develop personalized, value-driven messaging
- Implement proper email authentication (SPF, DKIM, DMARC)
- Monitor your sender reputation
- Maintain consistent, professional communication
---
## Legal Compliance
### Applicable Regulations
We help you comply with major anti-spam laws including:
- **CAN-SPAM Act** (United States)
- **GDPR** (European Union)
- **CASL** (Canada)
- **SPAM Act** (Australia)
- **DPA** (United Kingdom)
### Regional Considerations
- Different jurisdictions have varying requirements
- Consent mechanisms may differ by region
- Opt-out procedures must comply with local laws
- Data retention policies vary by location
---
## Updates to This Policy
This anti-spam policy may be updated periodically to reflect:
- Changes in applicable laws and regulations
- Evolution of spam and abuse tactics
- Improvements to our technical safeguards
- User feedback and industry best practices
Users will be notified of significant policy changes through their registered email address and our platform notifications.
---
## Contact Information
For questions about this anti-spam policy or to report violations:
- **Email**: [support@tomba.io](mailto:support@tomba.io)
- **Support**: [https://help.tomba.io](https://help.tomba.io)
By using Tomba.io services, you agree to comply with this anti-spam policy and help us maintain a responsible, spam-free environment for all users.
---
## Document: Rust Client Library
This is the official Rust client library for the [Tomba.io](https://tomba.io) Email Finder API
URL: /libraries/rust-email-finder
# Rust Client Library
## Installation
Add this to your package's `Cargo.toml` file:
```toml
[dependencies]
tomba = "0.1"
```
## Usage
### Domain Search
get email addresses found on the internet.
```rust
use tomba::{Tomba, TombaConfig};
let config = TombaConfig {
key: "ta_xxxx".to_string(),
secret: "ts_xxxx".to_string(),
};
let mut tomba = Tomba::init(config).expect("should construct");
let res = tomba.domain_search("tomba.io".to_string()).expect("should do domain_search ");
println!("website country {:?}", res.data.organization.location.country);
```
### Email Finder
Find the verified email address of any professional.
```rust
use tomba::{Tomba, TombaConfig};
let config = TombaConfig {
key: "ta_xxxx".to_string(),
secret: "ts_xxxx".to_string(),
};
let mut tomba = Tomba::init(config).expect("should construct");
let res = tomba.email_finder("zapier.com".to_string(), "F_NAME".to_string(), "L_NAME".to_string()).expect("should do email finder");
println!("Email Finder email {}", res.data.email)
```
### Email Verifier
Verify the validity of any professional email address with the most complete email checker.
```rust
use tomba::{Tomba, TombaConfig};
let config = TombaConfig {
key: "ta_xxxx".to_string(),
secret: "ts_xxxx".to_string(),
};
let mut tomba = Tomba::init(config).expect("should construct");
let res = tomba.email_verifier("m@wordpress.org".to_string()).expect("should do verify");
println!("Email status {}", res.data.email.status)
```
---
## Document: Ruby Client Library
This is the official Ruby client library for the [Tomba.io](https://tomba.io) Email Finder API
URL: /libraries/ruby-email-finder
# Ruby Client Library
## Installation
To install via [Gem](https://rubygems.org/gems/tomba):
```bash
gem install tomba --save
```
## Usage
### Domain Search
get email addresses found on the internet.
```ruby
require 'tomba'
client = Tomba::Client.new()
client
.set_key('ta_xxxx') # Your Key
.set_secret('ts_xxxx') # Your Secret
;
domain = Tomba::Domain.new(client);
response = domain.domain_search(domain: 'stripe.com');
puts response
```
### Email Finder
Find the verified email address of any professional.
```ruby
require 'tomba'
client = Tomba::Client.new()
client
.set_key('ta_xxxx') # Your Key
.set_secret('ts_xxxx') # Your Secret
;
finder = Tomba::Finder.new(client);
response = finder.email_finder(domain: 'stripe.com', first_name: 'fname', last_name: 'lname');
puts response
```
### Email Verifier
Verify the validity of any professional email address with the most complete email checker.
```ruby
require 'tomba'
client = Tomba::Client.new()
client
.set_key('ta_xxxx') # Your Key
.set_secret('ts_xxxx') # Your Secret
;
verifier = Tomba::Verifier.new(client);
response = verifier.email_verifier(email: 'm@wordpress.org');
puts response
```
## Examples
### Get Account Information
```ruby
require 'tomba'
client = Tomba::Client.new()
client
.set_key('ta_xxxx') # Your Key
.set_secret('ts_xxxx') # Your Secret
;
account = Tomba::Account.new(client);
response = account.get_account();
puts response
```
### Email Count
```ruby
require 'tomba'
client = Tomba::Client.new()
client
.set_key('ta_xxxx') # Your Key
.set_secret('ts_xxxx') # Your Secret
;
count = Tomba::Count.new(client);
response = count.email_count(domain: 'tomba.io');
puts response
```
### Finder Services
#### Author Finder
```ruby
require 'tomba'
client = Tomba::Client.new()
client
.set_key('ta_xxxx') # Your Key
.set_secret('ts_xxxx') # Your Secret
;
finder = Tomba::Finder.new(client);
response = finder.author_finder(url: 'https://clearbit.com/blog/company-name-to-domain-api');
puts response
```
#### LinkedIn Finder
```ruby
require 'tomba'
client = Tomba::Client.new()
client
.set_key('ta_xxxx') # Your Key
.set_secret('ts_xxxx') # Your Secret
;
finder = Tomba::Finder.new(client);
response = finder.linkedin_finder(url: 'https://www.linkedin.com/in/alex-maccaw-ab592978');
puts response
```
#### Phone Finder
```ruby
require 'tomba'
client = Tomba::Client.new()
client
.set_key('ta_xxxx') # Your Key
.set_secret('ts_xxxx') # Your Secret
;
finder = Tomba::Finder.new(client);
response = finder.phone_finder(email: '******@zapier.com');
puts response
```
### API Key Management
#### Create API Key
```ruby
require 'tomba'
client = Tomba::Client.new()
client
.set_key('ta_xxxx') # Your Key
.set_secret('ts_xxxx') # Your Secret
;
keys = Tomba::Keys.new(client);
response = keys.create_key();
puts response
```
#### Delete API Key
```ruby
require 'tomba'
client = Tomba::Client.new()
client
.set_key('ta_xxxx') # Your Key
.set_secret('ts_xxxx') # Your Secret
;
keys = Tomba::Keys.new(client);
response = keys.delete_key(id: '');
puts response
```
#### Get All API Keys
```ruby
require 'tomba'
client = Tomba::Client.new()
client
.set_key('ta_xxxx') # Your Key
.set_secret('ts_xxxx') # Your Secret
;
keys = Tomba::Keys.new(client);
response = keys.get_keys();
puts response
```
#### Reset API Key
```ruby
require 'tomba'
client = Tomba::Client.new()
client
.set_key('ta_xxxx') # Your Key
.set_secret('ts_xxxx') # Your Secret
;
keys = Tomba::Keys.new(client);
response = keys.reset_key(id: '');
puts response
```
### Lead Attributes Management
#### Create Lead Attribute
```ruby
require 'tomba'
client = Tomba::Client.new()
client
.set_key('ta_xxxx') # Your Key
.set_secret('ts_xxxx') # Your Secret
;
leads_attributes = Tomba::LeadsAttributes.new(client);
response = leads_attributes.create_lead_attribute();
puts response
```
#### Delete Lead Attribute
```ruby
require 'tomba'
client = Tomba::Client.new()
client
.set_key('ta_xxxx') # Your Key
.set_secret('ts_xxxx') # Your Secret
;
leads_attributes = Tomba::LeadsAttributes.new(client);
response = leads_attributes.delete_lead_attribute(id: '[Lead_Attributes_ID]');
puts response
```
#### Get Lead Attributes
```ruby
require 'tomba'
client = Tomba::Client.new()
client
.set_key('ta_xxxx') # Your Key
.set_secret('ts_xxxx') # Your Secret
;
leads_attributes = Tomba::LeadsAttributes.new(client);
response = leads_attributes.get_lead_attributes();
puts response
```
#### Update Lead Attribute
```ruby
require 'tomba'
client = Tomba::Client.new()
client
.set_key('ta_xxxx') # Your Key
.set_secret('ts_xxxx') # Your Secret
;
leads_attributes = Tomba::LeadsAttributes.new(client);
response = leads_attributes.update_lead_attribute(id: '[Lead_Attributes_ID]');
puts response
```
### Lead Lists Management
#### Create Lead List
```ruby
require 'tomba'
client = Tomba::Client.new()
client
.set_key('ta_xxxx') # Your Key
.set_secret('ts_xxxx') # Your Secret
;
leads_lists = Tomba::LeadsLists.new(client);
response = leads_lists.create_list();
puts response
```
#### Delete Lead List
```ruby
require 'tomba'
client = Tomba::Client.new()
client
.set_key('ta_xxxx') # Your Key
.set_secret('ts_xxxx') # Your Secret
;
leads_lists = Tomba::LeadsLists.new(client);
response = leads_lists.delete_list_id(id: '[LIST_ID]');
puts response
```
#### Get All Lead Lists
```ruby
require 'tomba'
client = Tomba::Client.new()
client
.set_key('ta_xxxx') # Your Key
.set_secret('ts_xxxx') # Your Secret
;
leads_lists = Tomba::LeadsLists.new(client);
response = leads_lists.get_lists();
puts response
```
#### Update Lead List
```ruby
require 'tomba'
client = Tomba::Client.new()
client
.set_key('ta_xxxx') # Your Key
.set_secret('ts_xxxx') # Your Secret
;
leads_lists = Tomba::LeadsLists.new(client);
response = leads_lists.update_list_id(id: '[List_ID]');
puts response
```
### Activity Logs
```ruby
require 'tomba'
client = Tomba::Client.new()
client
.set_key('ta_xxxx') # Your Key
.set_secret('ts_xxxx') # Your Secret
;
logs = Tomba::Logs.new(client);
response = logs.get_logs();
puts response
```
### Email Sources
```ruby
require 'tomba'
client = Tomba::Client.new()
client
.set_key('ta_xxxx') # Your Key
.set_secret('ts_xxxx') # Your Secret
;
sources = Tomba::Sources.new(client);
response = sources.email_sources(email: 'b.mohamed@tomba.io');
puts response
```
### Domain and Company Status
#### Auto Complete
```ruby
require 'tomba'
client = Tomba::Client.new()
client
.set_key('ta_xxxx') # Your Key
.set_secret('ts_xxxx') # Your Secret
;
status = Tomba::Status.new(client);
response = status.auto_complete(query: 'google');
puts response
```
#### Domain Status
```ruby
require 'tomba'
client = Tomba::Client.new()
client
.set_key('ta_xxxx') # Your Key
.set_secret('ts_xxxx') # Your Secret
;
status = Tomba::Status.new(client);
response = status.domain_status(domain: 'gmail.com');
puts response
```
### Usage Statistics
```ruby
require 'tomba'
client = Tomba::Client.new()
client
.set_key('ta_xxxx') # Your Key
.set_secret('ts_xxxx') # Your Secret
;
usage = Tomba::Usage.new(client);
response = usage.get_usage();
puts response
```
For more sample codes, check the [**examples/**](https://github.com/tomba-io/ruby/tree/master/examples) folder.
---
## Document: R Client Library
This is the official R client library for the [Tomba.io](https://tomba.io) Email Finder API
URL: /libraries/r-email-finder
# R Client Library
## Installation
To install
```bash
install.packages("tomba")
```
or via devtools [devtools](https://devtools.r-lib.org/):
```bash
devtools::install_github("tomba-io/r")
```
## Usage
### Domain Search
get email addresses found on the internet.
```r
client <- Tomba(key="ta_xxxx",secret="ts_xxxx")
data <- domain_search(client, domain="tomba.io")
```
### Email Finder
Find the verified email address of any professional.
```r
client <- Tomba(key="ta_xxxx",secret="ts_xxxx")
data <- email_finder(client, domain="tomba.io",fname="FNAME",lname="LNAME")
```
### Email Verifier
Verify the validity of any professional email address with the most complete email checker.
```r
client <- Tomba(key="ta_xxxx",secret="ts_xxxx")
data <- email_verifier(client, email="m@wordpress.org")
```
## Examples
### Get Account Information
```r
client <- Tomba(key="ta_xxxx",secret="ts_xxxx")
data <- account(client)
data
```
### Email Count
```r
client <- Tomba(key="ta_xxxx",secret="ts_xxxx")
data <- count(client, domain="tomba.io")
data
```
### Finder Services
#### Author Finder
```r
client <- Tomba(key="ta_xxxx",secret="ts_xxxx")
result <- author_finder(client,url="https://clearbit.com/blog/company-name-to-domain-api")
```
#### LinkedIn Finder
```r
client <- Tomba(key="ta_xxxx",secret="ts_xxxx")
result <- linkedin_finder(client,url="https://www.linkedin.com/in/alex-maccaw-ab592978")
```
#### Phone Finder
```r
client <- Tomba(key="ta_xxxx",secret="ts_xxxx")
result <- phone_finder(client,email="******@zapier.com")
```
### Email Sources
```r
client <- Tomba(key="ta_xxxx",secret="ts_xxxx")
data <- email_sources(client, email="b.mohamed@tomba.io")
data
```
### Domain and Company Status
#### Domain Status
```r
client <- Tomba(key="ta_xxxx",secret="ts_xxxx")
data <- status(client, domain="gmail.com")
data
```
### Activity Logs
```r
client <- Tomba(key="ta_xxxx",secret="ts_xxxx")
data <- logs(client)
data
```
### Usage Statistics
```r
client <- Tomba(key="ta_xxxx",secret="ts_xxxx")
data <- usage(client)
data
```
For more sample codes, check the [**examples/**](https://github.com/tomba-io/r/tree/master/examples) folder.
---
## Document: Python Client Library
This is the official Python client library for the [Tomba.io](https://tomba.io) Email Finder API
URL: /libraries/python-email-finder
# Python Client Library
## 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')
```
### 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('wordpress.org', 'Matt', 'Mullenweg')
```
### 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('m@wordpress.org')
```
## Examples
### Get Account Information
```py
from tomba.client import Client
from tomba.services.account import Account
client = Client()
(client
.set_key('ta_xxxx') # Your Key
.set_secret('') # Your Secret
)
account = Account(client)
result = account.get_account()
```
### Email Count
```py
from tomba.client import Client
from tomba.services.count import Count
client = Client()
(client
.set_key('ta_xxxx') # Your Key
.set_secret('') # Your Secret
)
count = Count(client)
result = count.email_count('tomba.io')
```
### Enrichment Services
#### Combined Enrichment
```py
from tomba.client import Client
from tomba.services.enrichment import Enrichment
client = Client()
(client
.set_key('ta_xxxx') # Your Key
.set_secret('') # Your Secret
)
enrichment = Enrichment(client)
result = enrichment.combined('******@zapier.com')
```
#### Company Enrichment
```py
from tomba.client import Client
from tomba.services.enrichment import Enrichment
client = Client()
(client
.set_key('ta_xxxx') # Your Key
.set_secret('') # Your Secret
)
enrichment = Enrichment(client)
result = enrichment.company('zapier.com')
```
#### Person Enrichment
```py
from tomba.client import Client
from tomba.services.enrichment import Enrichment
client = Client()
(client
.set_key('ta_xxxx') # Your Key
.set_secret('') # Your Secret
)
enrichment = Enrichment(client)
result = enrichment.person('john.doe@zapier.com')
```
### Finder Services
#### Author Finder
```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.author_finder('https://clearbit.com/blog/company-name-to-domain-api')
```
#### Email Enrichment
```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.enrichment('b.mohamed@tomba.io')
```
#### LinkedIn Finder
```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.linkedin_finder('https://www.linkedin.com/in/alex-maccaw-ab592978')
```
### API Key Management
#### Create API Key
```py
from tomba.client import Client
from tomba.services.keys import Keys
client = Client()
(client
.set_key('ta_xxxx') # Your Key
.set_secret('') # Your Secret
)
keys = Keys(client)
result = keys.create_key()
```
#### Delete API Key
```py
from tomba.client import Client
from tomba.services.keys import Keys
client = Client()
(client
.set_key('ta_xxxx') # Your Key
.set_secret('') # Your Secret
)
keys = Keys(client)
result = keys.delete_key('')
```
#### Get All API Keys
```py
from tomba.client import Client
from tomba.services.keys import Keys
client = Client()
(client
.set_key('ta_xxxx') # Your Key
.set_secret('') # Your Secret
)
keys = Keys(client)
result = keys.get_keys()
```
#### Reset API Key
```py
from tomba.client import Client
from tomba.services.keys import Keys
client = Client()
(client
.set_key('ta_xxxx') # Your Key
.set_secret('') # Your Secret
)
keys = Keys(client)
result = keys.reset_key('')
```
### Lead Attributes Management
#### Create Lead Attribute
```py
from tomba.client import Client
from tomba.services.leads_attributes import LeadsAttributes
client = Client()
(client
.set_key('ta_xxxx') # Your Key
.set_secret('') # Your Secret
)
leads_attributes = LeadsAttributes(client)
result = leads_attributes.create_lead_attribute()
```
#### Delete Lead Attribute
```py
from tomba.client import Client
from tomba.services.leads_attributes import LeadsAttributes
client = Client()
(client
.set_key('ta_xxxx') # Your Key
.set_secret('') # Your Secret
)
leads_attributes = LeadsAttributes(client)
result = leads_attributes.delete_lead_attribute('[Lead_Attributes_ID]')
```
#### Get Lead Attributes
```py
from tomba.client import Client
from tomba.services.leads_attributes import LeadsAttributes
client = Client()
(client
.set_key('ta_xxxx') # Your Key
.set_secret('') # Your Secret
)
leads_attributes = LeadsAttributes(client)
result = leads_attributes.get_lead_attributes()
```
#### Update Lead Attribute
```py
from tomba.client import Client
from tomba.services.leads_attributes import LeadsAttributes
client = Client()
(client
.set_key('ta_xxxx') # Your Key
.set_secret('') # Your Secret
)
leads_attributes = LeadsAttributes(client)
result = leads_attributes.update_lead_attribute('[Lead_Attributes_ID]')
```
### Lead Lists Management
#### Create Lead List
```py
from tomba.client import Client
from tomba.services.leads_lists import LeadsLists
client = Client()
(client
.set_key('ta_xxxx') # Your Key
.set_secret('') # Your Secret
)
leads_lists = LeadsLists(client)
result = leads_lists.create_list()
```
#### Delete Lead List
```py
from tomba.client import Client
from tomba.services.leads_lists import LeadsLists
client = Client()
(client
.set_key('ta_xxxx') # Your Key
.set_secret('') # Your Secret
)
leads_lists = LeadsLists(client)
result = leads_lists.delete_list_id('[LIST_ID]')
```
#### Get All Lead Lists
```py
from tomba.client import Client
from tomba.services.leads_lists import LeadsLists
client = Client()
(client
.set_key('ta_xxxx') # Your Key
.set_secret('') # Your Secret
)
leads_lists = LeadsLists(client)
result = leads_lists.get_lists()
```
#### Update Lead List
```py
from tomba.client import Client
from tomba.services.leads_lists import LeadsLists
client = Client()
(client
.set_key('ta_xxxx') # Your Key
.set_secret('') # Your Secret
)
leads_lists = LeadsLists(client)
result = leads_lists.update_list_id('[List_ID]')
```
### Activity Logs
```py
from tomba.client import Client
from tomba.services.logs import Logs
client = Client()
(client
.set_key('ta_xxxx') # Your Key
.set_secret('') # Your Secret
)
logs = Logs(client)
result = logs.get_logs()
```
### Phone Services
#### Phone Finder
```py
from tomba.client import Client
from tomba.services.phone import Phone
client = Client()
(client
.set_key('ta_xxxx') # Your Key
.set_secret('') # Your Secret
)
phone = Phone(client)
result = phone.finder('******@zapier.com')
```
#### Phone Validator
```py
from tomba.client import Client
from tomba.services.phone import Phone
client = Client()
(client
.set_key('ta_xxxx') # Your Key
.set_secret('') # Your Secret
)
phone = Phone(client)
result = phone.validator('+14158586273')
```
### Similar Websites
```py
from tomba.client import Client
from tomba.services.similar import Similar
client = Client()
(client
.set_key('ta_xxxx') # Your Key
.set_secret('') # Your Secret
)
similar = Similar(client)
result = similar.websites('zapier.com')
```
### Email Sources
```py
from tomba.client import Client
from tomba.services.sources import Sources
client = Client()
(client
.set_key('ta_xxxx') # Your Key
.set_secret('') # Your Secret
)
sources = Sources(client)
result = sources.email_sources('b.mohamed@tomba.io')
```
### Domain and Company Status
#### Auto Complete
```py
from tomba.client import Client
from tomba.services.status import Status
client = Client()
(client
.set_key('ta_xxxx') # Your Key
.set_secret('') # Your Secret
)
status = Status(client)
result = status.auto_complete('google')
```
#### Domain Status
```py
from tomba.client import Client
from tomba.services.status import Status
client = Client()
(client
.set_key('ta_xxxx') # Your Key
.set_secret('') # Your Secret
)
status = Status(client)
result = status.domain_status('gmail.com')
```
### Technology Detection
```py
from tomba.client import Client
from tomba.services.technology import Technology
client = Client()
(client
.set_key('ta_xxxx') # Your Key
.set_secret('') # Your Secret
)
technology = Technology(client)
result = technology.list('zapier.com')
```
### Usage Statistics
```py
from tomba.client import Client
from tomba.services.usage import Usage
client = Client()
(client
.set_key('ta_xxxx') # Your Key
.set_secret('') # Your Secret
)
usage = Usage(client)
result = usage.get_usage()
```
For more sample codes, check the [**examples/**](https://github.com/tomba-io/python/tree/master/examples) folder.
---
## Document: PHP Client Library
This is the official PHP client library for the [Tomba.io](https://tomba.io) Email Finder API
URL: /libraries/php-email-finder
# PHP Client Library
## Installation
To install via [Composer](http://getcomposer.org/):
```bash
composer require tomba-io/php
```
## Usage
### Domain Search
get email addresses found on the internet.
```php
setKey('ta_xxxx') // Your API Key
->setSecret('ts_xxxx') // Your Secret
;
$domain = new Domain($client);
$result = $domain->domainSearch('stripe.com');
```
### Email Finder
Find the verified email address of any professional.
```php
setKey('ta_xxxx') // Your API Key
->setSecret('ts_xxxx') // Your Secret
;
$finder = new Finder($client);
$result = $finder->emailFinder('stripe.com', 'fname', 'lname');.
```
### Email Verifier
Verify the validity of any professional email address with the most complete email checker.
```php
setKey('ta_xxxx') // Your API Key
->setSecret('ts_xxxx') // Your Secret
;
$verifier = new Verifier($client);
$result = $verifier->emailVerifier('m@wordpress.org');
```
## Examples
### Get Account Information
```php
setKey('ta_xxxx') // Your API Key
->setSecret('ts_xxxx') // Your Secret
;
$account = new Account($client);
$result = $account->getAccount();
```
### Email Count
```php
setKey('ta_xxxx') // Your API Key
->setSecret('ts_xxxx') // Your Secret
;
$count = new Count($client);
$result = $count->emailCount('tomba.io');
```
### Finder Services
#### Author Finder
This API endpoint generates or retrieves the most likely email address from a blog post url.
```php
setKey('ta_xxxx') // Your API Key
->setSecret('ts_xxxx') // Your Secret
;
$finder = new Finder($client);
$result = $finder->authorFinder('https://clearbit.com/blog/company-name-to-domain-api');
```
#### LinkedIn Finder
This API endpoint generates or retrieves the most likely email address from a Linkedin URL.
```php
setKey('ta_xxxx') // Your API Key
->setSecret('ts_xxxx') // Your Secret
;
$finder = new Finder($client);
$result = $finder->linkedinFinder('https://www.linkedin.com/in/alex-maccaw-ab592978');
```
#### Phone Finder
Search phone are based on the email You give one email and it returns phone data.
```php
setKey('ta_xxxx') // Your API Key
->setSecret('ts_xxxx') // Your Secret
;
$finder = new Finder($client);
$result = $finder->phoneFinder('******@zapier.com');
```
### API Key Management
#### Create API Key
```php
setKey('ta_xxxx') // Your API Key
->setSecret('ts_xxxx') // Your Secret
;
$keys = new Keys($client);
$result = $keys->createKey();
```
#### Delete API Key
```php
setKey('ta_xxxx') // Your API Key
->setSecret('ts_xxxx') // Your Secret
;
$keys = new Keys($client);
$result = $keys->deleteKey('');
```
#### Get All API Keys
```php
setKey('ta_xxxx') // Your API Key
->setSecret('ts_xxxx') // Your Secret
;
$keys = new Keys($client);
$result = $keys->getKeys();
```
#### Reset API Key
```php
setKey('ta_xxxx') // Your API Key
->setSecret('ts_xxxx') // Your Secret
;
$keys = new Keys($client);
$result = $keys->resetKey('');
```
### Lead Attributes Management
#### Create Lead Attribute
```php
setKey('ta_xxxx') // Your API Key
->setSecret('ts_xxxx') // Your Secret
;
$leadsAttributes = new LeadsAttributes($client);
$result = $leadsAttributes->createLeadAttribute();
```
#### Delete Lead Attribute
```php
setKey('ta_xxxx') // Your API Key
->setSecret('ts_xxxx') // Your Secret
;
$leadsAttributes = new LeadsAttributes($client);
$result = $leadsAttributes->deleteLeadAttribute('[Lead_Attributes_ID]');
```
#### Get Lead Attributes
```php
setKey('ta_xxxx') // Your API Key
->setSecret('ts_xxxx') // Your Secret
;
$leadsAttributes = new LeadsAttributes($client);
$result = $leadsAttributes->getLeadAttributes();
```
#### Update Lead Attribute
```php
setKey('ta_xxxx') // Your API Key
->setSecret('ts_xxxx') // Your Secret
;
$leadsAttributes = new LeadsAttributes($client);
$result = $leadsAttributes->updateLeadAttribute('[Lead_Attributes_ID]');
```
### Lead Lists Management
#### Create Lead List
```php
setKey('ta_xxxx') // Your API Key
->setSecret('ts_xxxx') // Your Secret
;
$leadsLists = new LeadsLists($client);
$result = $leadsLists->createList();
```
#### Delete Lead List
```php
setKey('ta_xxxx') // Your API Key
->setSecret('ts_xxxx') // Your Secret
;
$leadsLists = new LeadsLists($client);
$result = $leadsLists->deleteListId('[LIST_ID]');
```
#### Get All Lead Lists
```php
setKey('ta_xxxx') // Your API Key
->setSecret('ts_xxxx') // Your Secret
;
$leadsLists = new LeadsLists($client);
$result = $leadsLists->getLists();
```
#### Update Lead List
```php
setKey('ta_xxxx') // Your API Key
->setSecret('ts_xxxx') // Your Secret
;
$leadsLists = new LeadsLists($client);
$result = $leadsLists->updateListId('[List_ID]');
```
### Activity Logs
```php
setKey('ta_xxxx') // Your API Key
->setSecret('ts_xxxx') // Your Secret
;
$logs = new Logs($client);
$result = $logs->getLogs();
```
### Email Sources
```php
setKey('ta_xxxx') // Your API Key
->setSecret('ts_xxxx') // Your Secret
;
$sources = new Sources($client);
$result = $sources->emailSources('b.mohamed@tomba.io');
```
### Domain and Company Status
#### Auto Complete
```php
setKey('ta_xxxx') // Your API Key
->setSecret('ts_xxxx') // Your Secret
;
$status = new Status($client);
$result = $status->autoComplete('google');
```
#### Domain Status
```php
setKey('ta_xxxx') // Your API Key
->setSecret('ts_xxxx') // Your Secret
;
$status = new Status($client);
$result = $status->domainStatus('gmail.com');
```
### Usage Statistics
```php
setKey('ta_xxxx') // Your API Key
->setSecret('ts_xxxx') // Your Secret
;
$usage = new Usage($client);
$result = $usage->getUsage();
```
For more sample codes, check the [**examples/**](https://github.com/tomba-io/php/tree/master/examples) folder.
---
## Document: Perl Client Library
This is the official Perl client library for the [Tomba.io](https://tomba.io) Email Finder API
URL: /libraries/perl-email-finder
# Perl Client Library
## Installation
install from source (not necessary for use in your application), download the source and run the following commands:
```shell
perl Makefile.PL
make
make test
make install
```
## Usage
### Domain Search
get email addresses found on the internet.
```perl
use Tomba::Finder;
$tomba = Tomba::Finder->new("ta_xxxxx", "ts_xxxxx");
$result = $tomba->DomainSearch('wordpress.org')
print $result;
```
### Email Finder
Find the verified email address of any professional.
```perl
use Tomba::Finder;
$tomba = Tomba::Finder->new("ta_xxxxx", "ts_xxxxx");
$result = $tomba->emailFinder('stripe.com', 'fname', 'lname')
print $result;
```
### Email Verifier
Verify the validity of any professional email address with the most complete email checker.
```perl
use Tomba::Finder;
$tomba = Tomba::Finder->new("ta_xxxxx", "ts_xxxxx");
$result = $tomba->EmailVerifier('m@wordpress.org')
print $result;
```
## Examples
### Get Account Information
```perl
use Tomba::Finder;
$tomba = Tomba::Finder->new("ta_xxxxx", "ts_xxxxx");
$result = $tomba->Account();
print $result;
```
### Email Count
```perl
use Tomba::Finder;
$tomba = Tomba::Finder->new("ta_xxxxx", "ts_xxxxx");
$result = $tomba->Count('tomba.io');
print $result;
```
### Finder Services
#### Author Finder
```perl
use Tomba::Finder;
$tomba = Tomba::Finder->new("ta_xxxxx", "ts_xxxxx");
$result = $tomba->AuthorFinder('https://clearbit.com/blog/company-name-to-domain-api');
print $result;
```
#### LinkedIn Finder
```perl
use Tomba::Finder;
$tomba = Tomba::Finder->new("ta_xxxxx", "ts_xxxxx");
$result = $tomba->LinkedinFinder('https://www.linkedin.com/in/alex-maccaw-ab592978');
print $result;
```
### Email Enrichment
```perl
use Tomba::Finder;
$tomba = Tomba::Finder->new("ta_xxxxx", "ts_xxxxx");
$result = $tomba->Enrichment('b.mohamed@tomba.io');
print $result;
```
### Email Sources
```perl
use Tomba::Finder;
$tomba = Tomba::Finder->new("ta_xxxxx", "ts_xxxxx");
$result = $tomba->EmailSources('b.mohamed@tomba.io');
print $result;
```
### Domain and Company Status
#### Auto Complete
```perl
use Tomba::Finder;
$tomba = Tomba::Finder->new("ta_xxxxx", "ts_xxxxx");
$result = $tomba->Autocomplete('google');
print $result;
```
#### Domain Status
```perl
use Tomba::Finder;
$tomba = Tomba::Finder->new("ta_xxxxx", "ts_xxxxx");
$result = $tomba->Status('gmail.com');
print $result;
```
### Activity Logs
```perl
use Tomba::Finder;
$tomba = Tomba::Finder->new("ta_xxxxx", "ts_xxxxx");
$result = $tomba->Logs();
print $result;
```
### Usage Statistics
```perl
use Tomba::Finder;
$tomba = Tomba::Finder->new("ta_xxxxx", "ts_xxxxx");
$result = $tomba->Usage();
print $result;
```
For more sample codes, check the [**examples/**](https://github.com/tomba-io/perl/tree/master/examples) folder.
---
## Document: Node Client Library
This is the official Node client library for the [Tomba.io](https://tomba.io) Email Finder API
URL: /libraries/node-email-finder
# Node Client Library
## Installation
To install via [NPM](https://www.npmjs.com/package/tomba):
```bash
npm install tomba --save
```
To install via [YARN](https://yarnpkg.com/package/tomba):
```bash
yarn add tomba
```
## Usage
### Domain Search
get email addresses found on the internet.
```js
import { TombaClient, Domain } from "tomba";
// Init Tomba
const client = new TombaClient();
const domain = new Domain(client);
client
.setKey("ta_xxxx") // Your Key
.setSecret("ts_xxxx"); // Your Secret
const result = domain.domainSearch("stripe.com");
result
.then((response) => {
console.log(response);
})
.catch((err) => {
console.log(err);
});
```
### Email Finder
Find the verified email address of any professional.
```js
import { TombaClient, Finder } from "tomba";
// Init Tomba
const client = new TombaClient();
const finder = new Finder(client);
client
.setKey("ta_xxxx") // Your Key
.setSecret("ts_xxxx"); // Your Secret
const result = finder.emailFinder("stripe.com", "fname", "lname");
result
.then((response) => {
console.log(response);
})
.catch((err) => {
console.log(err);
});
```
### Email Verifier
Verify the validity of any professional email address with the most complete email checker.
```js
import { TombaClient, Verifier } from "tomba";
// Init Tomba
const client = new TombaClient();
const verifier = new Verifier(client);
client
.setKey("ta_xxxx") // Your Key
.setSecret("ts_xxxx"); // Your Secret
const result = verifier.emailVerifier("m@wordpress.org");
result
.then((response) => {
console.log(response);
})
.catch((err) => {
console.log(err);
});
```
## Examples
### Get Account Information
```js
import { TombaClient, Account } from "tomba";
// Init Tomba
const client = new TombaClient();
const account = new Account(client);
client
.setKey("ta_xxxx") // Your Key
.setSecret("ts_xxxx"); // Your Secret
const result = account.getAccount();
result
.then((response) => {
console.log(response);
})
.catch((err) => {
console.log(err);
});
```
### Email Count
```js
import { TombaClient, Count } from "tomba";
// Init Tomba
const client = new TombaClient();
const count = new Count(client);
client
.setKey("ta_xxxx") // Your Key
.setSecret("ts_xxxx"); // Your Secret
const result = count.emailCount("tomba.io");
result
.then((response) => {
console.log(response);
})
.catch((err) => {
console.log(err);
});
```
### Finder Services
#### Author Finder
```js
import { TombaClient, Finder } from "tomba";
// Init Tomba
const client = new TombaClient();
const finder = new Finder(client);
client
.setKey("ta_xxxx") // Your Key
.setSecret("ts_xxxx"); // Your Secret
const result = finder.authorFinder("www.shopify.com/blog/self-publish-a-book");
result
.then((response) => {
console.log(response);
})
.catch((err) => {
console.log(err);
});
```
#### Email Enrichment
```js
import { TombaClient, Finder } from "tomba";
// Init Tomba
const client = new TombaClient();
const finder = new Finder(client);
client
.setKey("ta_xxxx") // Your Key
.setSecret("ts_xxxx"); // Your Secret
const result = finder.emailEnrichment("dayna.winter@shopify.com");
result
.then((response) => {
console.log(response);
})
.catch((err) => {
console.log(err);
});
```
#### LinkedIn Finder
```js
import { TombaClient, Finder } from "tomba";
// Init Tomba
const client = new TombaClient();
const finder = new Finder(client);
client
.setKey("ta_xxxx") // Your Key
.setSecret("ts_xxxx"); // Your Secret
const result = finder.linkedinFinder("https://www.linkedin.com/in/mattm");
result
.then((response) => {
console.log(response);
})
.catch((err) => {
console.log(err);
});
```
### API Key Management
#### Create API Key
```js
import { TombaClient, Keys } from "tomba";
// Init Tomba
const client = new TombaClient();
const keys = new Keys(client);
client
.setKey("ta_xxxx") // Your Key
.setSecret("ts_xxxx"); // Your Secret
const result = keys.createKey();
result
.then((response) => {
console.log(response);
})
.catch((err) => {
console.log(err);
});
```
#### Delete API Key
```js
import { TombaClient, Keys } from "tomba";
// Init Tomba
const client = new TombaClient();
const keys = new Keys(client);
client
.setKey("ta_xxxx") // Your Key
.setSecret("ts_xxxx"); // Your Secret
const result = keys.deleteKey("");
result
.then((response) => {
console.log(response);
})
.catch((err) => {
console.log(err);
});
```
#### Get All API Keys
```js
import { TombaClient, Keys } from "tomba";
// Init Tomba
const client = new TombaClient();
const keys = new Keys(client);
client
.setKey("ta_xxxx") // Your Key
.setSecret("ts_xxxx"); // Your Secret
const result = keys.getKeys();
result
.then((response) => {
console.log(response);
})
.catch((err) => {
console.log(err);
});
```
#### Reset API Key
```js
import { TombaClient, Keys } from "tomba";
// Init Tomba
const client = new TombaClient();
const keys = new Keys(client);
client
.setKey("ta_xxxx") // Your Key
.setSecret("ts_xxxx"); // Your Secret
const result = keys.resetKey("");
result
.then((response) => {
console.log(response);
})
.catch((err) => {
console.log(err);
});
```
### Lead Attributes Management
#### Create Lead Attribute
```js
import { TombaClient, LeadsAttributes } from "tomba";
// Init Tomba
const client = new TombaClient();
const leadsAttributes = new LeadsAttributes(client);
client
.setKey("ta_xxxx") // Your Key
.setSecret("ts_xxxx"); // Your Secret
const result = leadsAttributes.createLeadAttribute();
result
.then((response) => {
console.log(response);
})
.catch((err) => {
console.log(err);
});
```
#### Delete Lead Attribute
```js
import { TombaClient, LeadsAttributes } from "tomba";
// Init Tomba
const client = new TombaClient();
const leadsAttributes = new LeadsAttributes(client);
client
.setKey("ta_xxxx") // Your Key
.setSecret("ts_xxxx"); // Your Secret
const result = leadsAttributes.deleteLeadAttribute("[Lead_Attributes_ID]");
result
.then((response) => {
console.log(response);
})
.catch((err) => {
console.log(err);
});
```
#### Get Lead Attributes
```js
import { TombaClient, LeadsAttributes } from "tomba";
// Init Tomba
const client = new TombaClient();
const leadsAttributes = new LeadsAttributes(client);
client
.setKey("ta_xxxx") // Your Key
.setSecret("ts_xxxx"); // Your Secret
const result = leadsAttributes.getLeadAttributes();
result
.then((response) => {
console.log(response);
})
.catch((err) => {
console.log(err);
});
```
#### Update Lead Attribute
```js
import { TombaClient, LeadsAttributes } from "tomba";
// Init Tomba
const client = new TombaClient();
const leadsAttributes = new LeadsAttributes(client);
client
.setKey("ta_xxxx") // Your Key
.setSecret("ts_xxxx"); // Your Secret
const result = leadsAttributes.updateLeadAttribute("[Lead_Attributes_ID]");
result
.then((response) => {
console.log(response);
})
.catch((err) => {
console.log(err);
});
```
### Lead Lists Management
#### Create Lead List
```js
import { TombaClient, LeadsLists } from "tomba";
// Init Tomba
const client = new TombaClient();
const leadsLists = new LeadsLists(client);
client
.setKey("ta_xxxx") // Your Key
.setSecret("ts_xxxx"); // Your Secret
const result = leadsLists.createList();
result
.then((response) => {
console.log(response);
})
.catch((err) => {
console.log(err);
});
```
#### Delete Lead List
```js
import { TombaClient, LeadsLists } from "tomba";
// Init Tomba
const client = new TombaClient();
const leadsLists = new LeadsLists(client);
client
.setKey("ta_xxxx") // Your Key
.setSecret("ts_xxxx"); // Your Secret
const result = leadsLists.deleteListId("[LIST_ID]");
result
.then((response) => {
console.log(response);
})
.catch((err) => {
console.log(err);
});
```
#### Get All Lead Lists
```js
import { TombaClient, LeadsLists } from "tomba";
// Init Tomba
const client = new TombaClient();
const leadsLists = new LeadsLists(client);
client
.setKey("ta_xxxx") // Your Key
.setSecret("ts_xxxx"); // Your Secret
const result = leadsLists.getLists();
result
.then((response) => {
console.log(response);
})
.catch((err) => {
console.log(err);
});
```
#### Update Lead List
```js
import { TombaClient, LeadsLists } from "tomba";
// Init Tomba
const client = new TombaClient();
const leadsLists = new LeadsLists(client);
client
.setKey("ta_xxxx") // Your Key
.setSecret("ts_xxxx"); // Your Secret
const result = leadsLists.updateListId("[List_ID]");
result
.then((response) => {
console.log(response);
})
.catch((err) => {
console.log(err);
});
```
### Activity Logs
```js
import { TombaClient, Logs } from "tomba";
// Init Tomba
const client = new TombaClient();
const logs = new Logs(client);
client
.setKey("ta_xxxx") // Your Key
.setSecret("ts_xxxx"); // Your Secret
const result = logs.getLogs();
result
.then((response) => {
console.log(response);
})
.catch((err) => {
console.log(err);
});
```
### Email Sources
```js
import { TombaClient, Sources } from "tomba";
// Init Tomba
const client = new TombaClient();
const sources = new Sources(client);
client
.setKey("ta_xxxx") // Your Key
.setSecret("ts_xxxx"); // Your Secret
const result = sources.emailSources("b.mohamed@tomba.io");
result
.then((response) => {
console.log(response);
})
.catch((err) => {
console.log(err);
});
```
### Domain and Company Status
#### Domain Status
```js
import { TombaClient, Status } from "tomba";
// Init Tomba
const client = new TombaClient();
const status = new Status(client);
client
.setKey("ta_xxxx") // Your Key
.setSecret("ts_xxxx"); // Your Secret
const result = status.domainStatus("gmail.com");
result
.then((response) => {
console.log(response);
})
.catch((err) => {
console.log(err);
});
```
### Usage Statistics
```js
import { TombaClient, Usage } from "tomba";
// Init Tomba
const client = new TombaClient();
const usage = new Usage(client);
client
.setKey("ta_xxxx") // Your Key
.setSecret("ts_xxxx"); // Your Secret
const result = usage.getUsage();
result
.then((response) => {
console.log(response);
})
.catch((err) => {
console.log(err);
});
```
For more sample codes, check the [**examples/**](https://github.com/tomba-io/node/tree/master/examples) folder.
---
## Document: Lua Client Library
This is the official Lua client library for the [Tomba.io](https://tomba.io) Email Finder API
URL: /libraries/lua-email-finder
# Lua Client Library
## Installation
install via [luarocks](https://luarocks.org/modules/benemohamed/tomba)
```bash
luarocks install tomba
```
## Usage
### Domain Search
get email addresses found on the internet.
```lua
local tomba = require('tomba')
local client = tomba:init("ta_xxxx", "ts_xxxx")
local result = client:domain_search('wordpress.org')
print(result.data)
```
### Email Finder
Find the verified email address of any professional.
```lua
local tomba = require('tomba')
local client = tomba:init("ta_xxxx", "ts_xxxx")
local result = client:email_finder('stripe.com', 'fname', 'lname')
print(result)
```
### Email Verifier
Verify the validity of any professional email address with the most complete email checker.
```lua
local tomba = require('tomba')
local client = tomba:init("ta_xxxx", "ts_xxxx")
local result = client:email_verifier('m@wordpress.org')
print(result)
```
## Examples
### Get Account Information
```lua
local tomba = require('tomba')
local client = tomba:init("ta_xxxx", "ts_xxxx")
local result = client:account()
print(result.data.email)
```
### Email Count
```lua
local tomba = require('tomba')
local client = tomba:init("ta_xxxx", "ts_xxxx")
local result = client:count('tomba.io')
print(result)
```
### Finder Services
#### Author Finder
```lua
local tomba = require('tomba')
local client = tomba:init("ta_xxxx", "ts_xxxx")
local result = client:author_finder('https://clearbit.com/blog/company-name-to-domain-api')
print(result)
```
#### LinkedIn Finder
```lua
local tomba = require('tomba')
local client = tomba:init("ta_xxxx", "ts_xxxx")
local result = client:linkedin_finder('https://www.linkedin.com/in/alex-maccaw-ab592978')
print(result)
```
### Email Enrichment
```lua
local tomba = require('tomba')
local client = tomba:init("ta_xxxx", "ts_xxxx")
local result = client:enrichment('b.mohamed@tomba.io')
print(result)
```
### Email Sources
```lua
local tomba = require('tomba')
local client = tomba:init("ta_xxxx", "ts_xxxx")
local result = client:email_sources('b.mohamed@tomba.io')
print(result)
```
### Domain and Company Status
#### Auto Complete
```lua
local tomba = require('tomba')
local client = tomba:init("ta_xxxx", "ts_xxxx")
local result = client:autocomplete('google')
print(result)
```
#### Domain Status
```lua
local tomba = require('tomba')
local client = tomba:init("ta_xxxx", "ts_xxxx")
local result = client:status('gmail.com')
print(result)
```
### Activity Logs
```lua
local tomba = require('tomba')
local client = tomba:init("ta_xxxx", "ts_xxxx")
local result = client:logs()
print(result)
```
### Usage Statistics
```lua
local tomba = require('tomba')
local client = tomba:init("ta_xxxx", "ts_xxxx")
local result = client:usage()
print(result)
```
For more sample codes, check the [**examples/**](https://github.com/tomba-io/lua/tree/master/examples) folder.
---
## Document: Go Client Library
This is the official Go client library for the [Tomba.io](https://tomba.io) Email Finder API
URL: /libraries/go-email-finder
# Go Client Library
## Installation
```bash
go get github.com/tomba-io/go/tomba
```
## Usage
### Domain Search
get email addresses found on the internet.
```go
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)
}
}
```
### Email Finder
Find the verified email address of any professional.
```go
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)
}
}
```
### Email Verifier
Verify the validity of any professional email address with the most complete email checker.
```go
package main
import (
"fmt"
"github.com/tomba-io/go/tomba"
)
func main() {
tomba := tomba.New("ta_xxxxx", "ts_xxxxx")
result, err := tomba.EmailVerifier("m@wordpress.org")
if err == nil {
fmt.Println(result)
}
}
```
## Bulk Operations Overview
The Tomba Go SDK supports 10 different types of bulk operations:
| Bulk Type | Purpose | Input Format | Max Records |
| ---------------------- | -------------------------------- | ----------------- | -------------- |
| **Author Finder** | Find authors from blog URLs | Text list or CSV | 5,000 URLs |
| **Company Enrichment** | Enrich company data from domains | Text list or CSV | 15,000 domains |
| **Domain Search** | Find emails in domains | Text list | 15,000 domains |
| **Email Enrichment** | Enrich existing email addresses | Text list or CSV | 10,000 emails |
| **Email Finder** | Find emails from names + domains | CSV file required | 10,000 records |
| **Email Verifier** | Verify email deliverability | Text list or CSV | 10,000 emails |
| **LinkedIn Finder** | Find emails from LinkedIn URLs | Text list or CSV | 10,000 URLs |
| **Phone Finder** | Find phone numbers from contacts | Text list or CSV | 2,500 contacts |
| **Phone Validator** | Validate phone numbers | Text list or CSV | 2,500 numbers |
| **Similar Domain** | Find similar companies | Text list | 500 domains |
## Common Patterns
### 1. Basic Bulk Creation Pattern
```go
// Step 1: Create bulk
params := &models.BulkCreateParams{
Name: "My Bulk Operation",
List: "domain1.com\ndomain2.com\ndomain3.com",
Sources: true,
Verify: true,
}
response, err := client.CreateBulk(models.BulkTypeSearch, params)
if err != nil {
log.Fatal(err)
}
// Step 2: Launch bulk
launchResp, err := client.LaunchBulk(models.BulkTypeSearch, *response.Data.ID)
if err != nil {
log.Fatal(err)
}
// Step 3: Monitor progress
progress, err := client.GetBulkProgress(models.BulkTypeSearch, *response.Data.ID)
if err != nil {
log.Fatal(err)
}
// Step 4: Download results
err = client.SaveBulkResults(models.BulkTypeSearch, *response.Data.ID, "./results.csv", "full")
if err != nil {
log.Fatal(err)
}
```
### 2. File Upload Pattern
```go
// For operations requiring CSV files (Email Finder, Phone Validator)
params := &models.BulkFinderCreateParams{
BulkCreateParams: models.BulkCreateParams{
Name: "Email Finding from CSV",
Delimiter: ",",
Verify: true,
},
BulkFinderParams: models.BulkFinderParams{
ColumnFirst: 1, // First name column
ColumnLast: 2, // Last name column
ColumnDomain: 3, // Domain column
Skip: true, // Skip header row
},
}
response, err := client.CreateFinderBulk(params, "./contacts.csv")
```
### 3. Advanced Search Parameters
```go
// Domain Search with advanced filtering
searchParams := &models.BulkSearchCreateParams{
BulkCreateParams: models.BulkCreateParams{
Name: "Advanced Domain Search",
List: "company1.com\ncompany2.com",
Sources: true,
Verify: true,
},
BulkSearchParams: models.BulkSearchParams{
Maximum: "50", // Max emails per domain
EmailType: models.BulkSearchParamsType{
Type: "personal",
PriorityType: "priority",
},
Department: models.BulkSearchParamsDepartment{
Name: []string{"engineering", "marketing"},
PriorityType: "only",
},
},
}
response, err := client.CreateSearchBulk(searchParams)
```
## Error Handling Best Practices
```go
func handleBulkOperation(client *tomba.Tomba) error {
params := &models.BulkCreateParams{
Name: "Test Bulk",
List: "example.com",
}
// Create with error handling
response, err := client.CreateBulk(models.BulkTypeSearch, params)
if err != nil {
return fmt.Errorf("failed to create bulk: %w", err)
}
if response.Data.ID == nil {
return fmt.Errorf("bulk creation failed: no ID returned")
}
// Launch with retry logic
bulkID := *response.Data.ID
maxRetries := 3
for i := 0; i < maxRetries; i++ {
_, err = client.LaunchBulk(models.BulkTypeSearch, bulkID)
if err == nil {
break
}
if i == maxRetries-1 {
return fmt.Errorf("failed to launch bulk after %d retries: %w", maxRetries, err)
}
time.Sleep(time.Duration(i+1) * time.Second)
}
return nil
}
```
## CSV File Format Examples
### Email Finder CSV
```csv
FirstName,LastName,Domain,Company
John,Smith,stripe.com,Stripe
Jane,Doe,shopify.com,Shopify
Bob,Johnson,zoom.us,Zoom
```
### Phone Validator CSV
```csv
PhoneNumber,Country
+1-555-123-4567,US
+44-20-7946-0958,GB
+33-1-42-86-83-26,FR
```
## Rate Limits and Best Practices
### Rate Limits
- **Email Verifier**: 50 emails per domain per 24 hours
- **API Requests**: Standard rate limiting applies
- **File Uploads**: Large files may take time to process
### Best Practices
1. **Use descriptive names** for easy bulk identification
2. **Enable verification** for higher quality results
3. **Monitor progress** regularly for large operations
4. **Handle errors gracefully** with retry logic
5. **Clean input data** before uploading
6. **Use appropriate bulk types** for your use case
7. **Archive completed bulks** to keep dashboard clean
## Complete Working Example
```go
package main
import (
"fmt"
"log"
"os"
"time"
"github.com/tomba-io/go/tomba"
"github.com/tomba-io/go/tomba/models"
)
func main() {
// Initialize client
client := tomba.NewClient(
os.Getenv("TOMBA_API_KEY"),
os.Getenv("TOMBA_API_SECRET"),
)
// Check account status
account, err := client.Account()
if err != nil {
log.Fatal("Failed to connect to Tomba:", err)
}
fmt.Printf("Connected as: %s\n", account.Data.Owner.Email)
fmt.Printf("Requests remaining: %d\n", account.Data.Requests.Available)
// Create and run a bulk operation
err = runBulkExample(client)
if err != nil {
log.Fatal("Bulk operation failed:", err)
}
}
func runBulkExample(client *tomba.Tomba) error {
// Create bulk
params := &models.BulkCreateParams{
Name: fmt.Sprintf("Example Bulk %s", time.Now().Format("2006-01-02 15:04")),
List: "stripe.com\nshopify.com\nzoom.us",
Sources: true,
Verify: true,
}
response, err := client.CreateBulk(models.BulkTypeSearch, params)
if err != nil {
return err
}
bulkID := *response.Data.ID
fmt.Printf("Created bulk with ID: %d\n", bulkID)
// Launch bulk
_, err = client.LaunchBulk(models.BulkTypeSearch, bulkID)
if err != nil {
return err
}
fmt.Println("Bulk launched successfully!")
// Monitor progress
for {
progress, err := client.GetBulkProgress(models.BulkTypeSearch, bulkID)
if err != nil {
return err
}
fmt.Printf("Progress: %d%% (%d/%d processed)\n",
progress.Progress, progress.Processed, progress.ProcessedEmail)
if progress.Progress >= 100 {
break
}
time.Sleep(5 * time.Second)
}
// Download results
err = client.SaveBulkResults(models.BulkTypeSearch, bulkID, "./bulk_results.csv", "full")
if err != nil {
return err
}
fmt.Println("Results saved to ./bulk_results.csv")
return nil
}
```
## Examples
### Get Account Information
```go
package main
import (
"fmt"
"github.com/tomba-io/go/tomba"
)
func main() {
tomba := tomba.New("ta_xxxxx", "ts_xxxxx")
result, err := tomba.Account()
if err != nil {
fmt.Println("Error : ", err)
return
}
fmt.Print(result)
}
```
### Email Count
```go
package main
import (
"fmt"
"github.com/tomba-io/go/tomba"
)
func main() {
tomba := tomba.New("ta_xxxxx", "ts_xxxxx")
result, err := tomba.Count("tomba.io")
if err != nil {
fmt.Println("Error : ", err)
return
}
fmt.Print(result)
}
```
### Finder Services
#### Author Finder
```go
package main
import (
"fmt"
"github.com/tomba-io/go/tomba"
)
func main() {
tomba := tomba.New("ta_xxxxx", "ts_xxxxx")
result, err := tomba.AuthorFinder("https://clearbit.com/blog/company-name-to-domain-api")
if err != nil {
fmt.Println("Error : ", err)
return
}
fmt.Print(result)
}
```
#### LinkedIn Finder
```go
package main
import (
"fmt"
"github.com/tomba-io/go/tomba"
)
func main() {
tomba := tomba.New("ta_xxxxx", "ts_xxxxx")
result, err := tomba.LinkedinFinder("https://www.linkedin.com/in/alex-maccaw-ab592978")
if err != nil {
fmt.Println("Error : ", err)
return
}
fmt.Print(result)
}
```
### Email Enrichment
```go
package main
import (
"fmt"
"github.com/tomba-io/go/tomba"
)
func main() {
tomba := tomba.New("ta_xxxxx", "ts_xxxxx")
result, err := tomba.Enrichment("b.mohamed@tomba.io")
if err != nil {
fmt.Println("Error : ", err)
return
}
fmt.Print(result)
}
```
### Email Sources
```go
package main
import (
"fmt"
"github.com/tomba-io/go/tomba"
)
func main() {
client := tomba.New("ta_xxxxx", "ts_xxxxx")
result, err := client.Sources("ab@tomba.io")
if err != nil {
fmt.Println("Error : ", err)
return
}
fmt.Print(result.Sources)
}
```
### Domain and Company Status
#### Domain Status
```go
package main
import (
"fmt"
"github.com/tomba-io/go/tomba"
)
func main() {
tomba := tomba.New("ta_xxxxx", "ts_xxxxx")
result, err := tomba.Status("gmail.com")
if err != nil {
fmt.Println("Error : ", err)
return
}
fmt.Print(result)
}
```
#### Similar Domains
```go
package main
import (
"fmt"
"github.com/tomba-io/go/tomba"
)
func main() {
client := tomba.New("", "")
result, err := client.SimilarDomains("tomba.io")
if err != nil {
fmt.Println("Error : ", err)
return
}
fmt.Println("Total Results: ", len(result.Data))
for _, domain := range result.Data {
name := ""
if domain.Name != nil {
name = *domain.Name
}
fmt.Println("Domain: ", name, " - WebsiteURL: ", domain.WebsiteURL)
}
}
```
### Activity Logs
```go
package main
import (
"fmt"
"github.com/tomba-io/go/tomba"
)
func main() {
tomba := tomba.New("ta_xxxxx", "ts_xxxxx")
result, err := tomba.Logs()
if err != nil {
fmt.Println("Error : ", err)
return
}
fmt.Print(result)
}
```
### Usage Statistics
```go
package main
import (
"fmt"
"github.com/tomba-io/go/tomba"
)
func main() {
tomba := tomba.New("ta_xxxxx", "ts_xxxxx")
result, err := tomba.Usage()
if err != nil {
fmt.Println("Error : ", err)
return
}
fmt.Print(result)
}
```
### Complete Bulk Search Example
```go
package main
import (
"fmt"
"log"
"time"
"github.com/tomba-io/go/tomba"
"github.com/tomba-io/go/tomba/models"
)
func main() {
client := tomba.New("ta_xx", "ts_xxx")
// Create a new search bulk
searchParams := &models.BulkSearchCreateParams{
BulkCreateParams: models.BulkCreateParams{
Name: "My Search Bulk",
List: "tomba.io\ndaily.dev",
Verify: false,
},
BulkSearchParams: models.BulkSearchParams{
Maximum: "10",
EmailType: models.BulkSearchParamsType{
Type: "all",
PriorityType: "only",
},
Department: models.BulkSearchParamsDepartment{
Name: []string{"executive"}, // Example department names
PriorityType: "only",
},
},
}
result, err := client.CreateSearchBulk(searchParams)
if err != nil {
log.Fatal(err)
}
if result.Data.ID != nil {
fmt.Printf("Created bulk with ID: %d\n", *result.Data.ID)
// Launch the bulk
_, err = client.LaunchBulk(models.BulkTypeSearch, *result.Data.ID)
if err != nil {
log.Fatal(err)
}
// Get progress
progress, err := client.GetBulkProgress(models.BulkTypeSearch, *result.Data.ID)
if err != nil {
log.Fatal(err)
}
// Wait for the bulk to complete
for progress.Progress < 100 {
fmt.Printf("Waiting for bulk to complete... Current progress: %d%%\n", progress.Progress)
time.Sleep(1 * time.Second)
progress, err = client.GetBulkProgress(models.BulkTypeSearch, *result.Data.ID)
if err != nil {
log.Fatal(err)
}
}
// Download results when completed
downloadData, err := client.DownloadBulk(models.BulkTypeSearch, *result.Data.ID, &models.BulkDownloadParams{
Type: "full",
})
if err != nil {
log.Fatal(err)
}
// Save the downloaded data to a file
if len(downloadData) != 0 {
fmt.Printf("Downloaded %d bytes of results\n", len(downloadData))
// Save full results
err = client.SaveBulkResults(models.BulkTypeSearch, *result.Data.ID, searchParams.Name+".csv", "full")
if err != nil {
log.Printf("Error saving full results: %v", err)
} else {
fmt.Printf("✅ Full results saved to: %s\n", searchParams.Name+".csv")
}
} else {
log.Fatal("No data downloaded, the bulk might not be completed yet or no results found.")
}
}
}
```
For more sample codes, check the [**examples/**](https://github.com/tomba-io/go/tree/master/examples) folder.
---
## Document: elixir Client Library
This is the official elixir client library for the [Tomba.io](https://tomba.io) Email Finder API
URL: /libraries/elixir-email-finder
# elixir Client Library
## Installation
the package can be installed by adding `tomba` to your list of dependencies in `mix.exs`:
```elixir
def deps do
[
{:tomba, "~> 0.1.0"}
]
end
```
And fetch your project's dependencies:
```bash
mix deps.get
```
## Usage
### Domain Search
get email addresses found on the internet.
```elixir
conf = Tomba.new("ta_xxxx", "ts_xxxx")
{:ok, result} = Tomba.domain_search(Tomba,"tomba.io")
```
### Email Finder
Find the verified email address of any professional.
```elixir
conf = Tomba.new("ta_xxxx", "ts_xxxx")
{:ok, result} = Tomba.email_finder(Tomba,"stripe.com", "fname", "lname")
```
### Email Verifier
Verify the validity of any professional email address with the most complete email checker.
```elixir
conf = Tomba.new("ta_xxxx", "ts_xxxx")
{:ok, result} = Tomba.email_verifier(Tomba,"m@wordpress.org")
```
## Examples
Sample codes under [**examples/**](https://github.com/tomba-io/elixir/tree/master/examples) folder.
---
## Document: Deno Client Library
This is the official Deno client library for the [Tomba.io](https://tomba.io) Email Finder API
URL: /libraries/deno-email-finder
# Deno Client Library
## Installation
```javascript
import * as tomba from "https://deno.land/x/tombaio/mod.ts";
```
## Usage
### Domain Search
get email addresses found on the internet.
```js
let client = new tomba.Client();
let domain = new tomba.Domain(client);
client.setKey("ta_xxxx").setSecret("ts_xxxx");
const result = domain.domainSearch("stripe.com");
result
.then((response) => {
console.log(response);
})
.catch((err) => {
console.log(err);
});
```
### Email Finder
Find the verified email address of any professional.
```js
let client = new tomba.Client();
let finder = new tomba.Finder(client);
client
.setKey("ta_xxxx") // Your Key
.setSecret("ts_xxxx"); // Your Secret
const result = finder.emailFinder("stripe.com", "Moskoz", "Dustin");
result
.then((response) => {
console.log(response);
})
.catch((err) => {
console.log(err);
});
```
### Email Verifier
Verify the validity of any professional email address with the most complete
email checker.
```js
let client = new tomba.Client();
let verifier = new tomba.Verifier(client);
client
.setKey("ta_xxxx") // Your Key
.setSecret("ts_xxxx"); // Your Secret
const result = verifier.emailVerifier("m@wordpress.org");
result
.then((response) => {
console.log(response);
})
.catch((err) => {
console.log(err);
});
```
## Examples
### Get Account Information
```javascript
import * as tomba from "https://deno.land/x/tombaio/mod.ts";
// Init SDK
let client = new tomba.Client();
let account = new tomba.Account(client);
client
.setKey("ta_xxxx") // Your Key
.setSecret("ts_xxxx"); // Your Secret
const result = account.getAccount();
result
.then((response) => {
console.log(response);
})
.catch((err) => {
console.log(err);
});
```
### Email Count
```javascript
import * as tomba from "https://deno.land/x/tombaio/mod.ts";
// Init SDK
let client = new tomba.Client();
let count = new tomba.Count(client);
client
.setKey("ta_xxxx") // Your Key
.setSecret("ts_xxxx"); // Your Secret
const result = count.emailCount("tomba.io");
result
.then((response) => {
console.log(response);
})
.catch((err) => {
console.log(err);
});
```
### Finder Services
#### Author Finder
```javascript
import * as tomba from "https://deno.land/x/tombaio/mod.ts";
// Init SDK
let client = new tomba.Client();
let finder = new tomba.Finder(client);
client
.setKey("ta_xxxx") // Your Key
.setSecret("ts_xxxx"); // Your Secret
const result = finder.authorFinder(
"https://clearbit.com/blog/company-name-to-domain-api",
);
result
.then((response) => {
console.log(response);
})
.catch((err) => {
console.log(err);
});
```
#### LinkedIn Finder
```javascript
import * as tomba from "https://deno.land/x/tombaio/mod.ts";
// Init SDK
let client = new tomba.Client();
let finder = new tomba.Finder(client);
client
.setKey("ta_xxxx") // Your Key
.setSecret("ts_xxxx"); // Your Secret
const result = finder.linkedinFinder(
"https://www.linkedin.com/in/alex-maccaw-ab592978",
);
result
.then((response) => {
console.log(response);
})
.catch((err) => {
console.log(err);
});
```
#### Phone Finder
```javascript
import * as tomba from "https://deno.land/x/tombaio/mod.ts";
// Init SDK
let client = new tomba.Client();
let finder = new tomba.Finder(client);
client
.setKey("ta_xxxx") // Your Key
.setSecret("ts_xxxx"); // Your Secret
const result = finder.phoneFinder("******@zapier.com");
result
.then((response) => {
console.log(response);
})
.catch((err) => {
console.log(err);
});
```
### API Key Management
#### Create API Key
```javascript
import * as tomba from "https://deno.land/x/tombaio/mod.ts";
// Init SDK
let client = new tomba.Client();
let keys = new tomba.Keys(client);
client
.setKey("ta_xxxx") // Your Key
.setSecret("ts_xxxx"); // Your Secret
const result = keys.createKey();
result
.then((response) => {
console.log(response);
})
.catch((err) => {
console.log(err);
});
```
#### Delete API Key
```javascript
import * as tomba from "https://deno.land/x/tombaio/mod.ts";
// Init SDK
let client = new tomba.Client();
let keys = new tomba.Keys(client);
client
.setKey("ta_xxxx") // Your Key
.setSecret("ts_xxxx"); // Your Secret
const result = keys.deleteKey("");
result
.then((response) => {
console.log(response);
})
.catch((err) => {
console.log(err);
});
```
#### Get All API Keys
```javascript
import * as tomba from "https://deno.land/x/tombaio/mod.ts";
// Init SDK
let client = new tomba.Client();
let keys = new tomba.Keys(client);
client
.setKey("ta_xxxx") // Your Key
.setSecret("ts_xxxx"); // Your Secret
const result = keys.getKeys();
result
.then((response) => {
console.log(response);
})
.catch((err) => {
console.log(err);
});
```
#### Reset API Key
```javascript
import * as tomba from "https://deno.land/x/tombaio/mod.ts";
// Init SDK
let client = new tomba.Client();
let keys = new tomba.Keys(client);
client
.setKey("ta_xxxx") // Your Key
.setSecret("ts_xxxx"); // Your Secret
const result = keys.resetKey("");
result
.then((response) => {
console.log(response);
})
.catch((err) => {
console.log(err);
});
```
### Lead Attributes Management
#### Create Lead Attribute
```javascript
import * as tomba from "https://deno.land/x/tombaio/mod.ts";
// Init SDK
let client = new tomba.Client();
let leadsAttributes = new tomba.LeadsAttributes(client);
client
.setKey("ta_xxxx") // Your Key
.setSecret("ts_xxxx"); // Your Secret
const result = leadsAttributes.createLeadAttribute();
result
.then((response) => {
console.log(response);
})
.catch((err) => {
console.log(err);
});
```
#### Delete Lead Attribute
```javascript
import * as tomba from "https://deno.land/x/tombaio/mod.ts";
// Init SDK
let client = new tomba.Client();
let leadsAttributes = new tomba.LeadsAttributes(client);
client
.setKey("ta_xxxx") // Your Key
.setSecret("ts_xxxx"); // Your Secret
const result = leadsAttributes.deleteLeadAttribute("[Lead_Attributes_ID]");
result
.then((response) => {
console.log(response);
})
.catch((err) => {
console.log(err);
});
```
#### Get Lead Attributes
```javascript
import * as tomba from "https://deno.land/x/tombaio/mod.ts";
// Init SDK
let client = new tomba.Client();
let leadsAttributes = new tomba.LeadsAttributes(client);
client
.setKey("ta_xxxx") // Your Key
.setSecret("ts_xxxx"); // Your Secret
const result = leadsAttributes.getLeadAttributes();
result
.then((response) => {
console.log(response);
})
.catch((err) => {
console.log(err);
});
```
#### Update Lead Attribute
```javascript
import * as tomba from "https://deno.land/x/tombaio/mod.ts";
// Init SDK
let client = new tomba.Client();
let leadsAttributes = new tomba.LeadsAttributes(client);
client
.setKey("ta_xxxx") // Your Key
.setSecret("ts_xxxx"); // Your Secret
const result = leadsAttributes.updateLeadAttribute("[Lead_Attributes_ID]");
result
.then((response) => {
console.log(response);
})
.catch((err) => {
console.log(err);
});
```
### Lead Lists Management
#### Create Lead List
```javascript
import * as tomba from "https://deno.land/x/tombaio/mod.ts";
// Init SDK
let client = new tomba.Client();
let leadsLists = new tomba.LeadsLists(client);
client
.setKey("ta_xxxx") // Your Key
.setSecret("ts_xxxx"); // Your Secret
const result = leadsLists.createList();
result
.then((response) => {
console.log(response);
})
.catch((err) => {
console.log(err);
});
```
#### Delete Lead List
```javascript
import * as tomba from "https://deno.land/x/tombaio/mod.ts";
// Init SDK
let client = new tomba.Client();
let leadsLists = new tomba.LeadsLists(client);
client
.setKey("ta_xxxx") // Your Key
.setSecret("ts_xxxx"); // Your Secret
const result = leadsLists.deleteListId("[LIST_ID]");
result
.then((response) => {
console.log(response);
})
.catch((err) => {
console.log(err);
});
```
#### Get All Lead Lists
```javascript
import * as tomba from "https://deno.land/x/tombaio/mod.ts";
// Init SDK
let client = new tomba.Client();
let leadsLists = new tomba.LeadsLists(client);
client
.setKey("ta_xxxx") // Your Key
.setSecret("ts_xxxx"); // Your Secret
const result = leadsLists.getLists();
result
.then((response) => {
console.log(response);
})
.catch((err) => {
console.log(err);
});
```
#### Update Lead List
```javascript
import * as tomba from "https://deno.land/x/tombaio/mod.ts";
// Init SDK
let client = new tomba.Client();
let leadsLists = new tomba.LeadsLists(client);
client
.setKey("ta_xxxx") // Your Key
.setSecret("ts_xxxx"); // Your Secret
const result = leadsLists.updateListId("[List_ID]");
result
.then((response) => {
console.log(response);
})
.catch((err) => {
console.log(err);
});
```
### Activity Logs
```javascript
import * as tomba from "https://deno.land/x/tombaio/mod.ts";
// Init SDK
let client = new tomba.Client();
let logs = new tomba.Logs(client);
client
.setKey("ta_xxxx") // Your Key
.setSecret("ts_xxxx"); // Your Secret
const result = logs.getLogs();
result
.then((response) => {
console.log(response);
})
.catch((err) => {
console.log(err);
});
```
### Email Sources
```javascript
import * as tomba from "https://deno.land/x/tombaio/mod.ts";
// Init SDK
let client = new tomba.Client();
let sources = new tomba.Sources(client);
client
.setKey("ta_xxxx") // Your Key
.setSecret("ts_xxxx"); // Your Secret
const result = sources.emailSources("b.mohamed@tomba.io");
result
.then((response) => {
console.log(response);
})
.catch((err) => {
console.log(err);
});
```
### Domain and Company Status
#### Auto Complete
```javascript
import * as tomba from "https://deno.land/x/tombaio/mod.ts";
// Init SDK
let client = new tomba.Client();
let status = new tomba.Status(client);
client
.setKey("ta_xxxx") // Your Key
.setSecret("ts_xxxx"); // Your Secret
const result = status.autoComplete("google");
result
.then((response) => {
console.log(response);
})
.catch((err) => {
console.log(err);
});
```
#### Domain Status
```javascript
import * as tomba from "https://deno.land/x/tombaio/mod.ts";
// Init SDK
let client = new tomba.Client();
let status = new tomba.Status(client);
client
.setKey("ta_xxxx") // Your Key
.setSecret("ts_xxxx"); // Your Secret
const result = status.domainStatus("gmail.com");
result
.then((response) => {
console.log(response);
})
.catch((err) => {
console.log(err);
});
```
### Usage Statistics
```javascript
import * as tomba from "https://deno.land/x/tombaio/mod.ts";
// Init SDK
let client = new tomba.Client();
let usage = new tomba.Usage(client);
client
.setKey("ta_xxxx") // Your Key
.setSecret("ts_xxxx"); // Your Secret
const result = usage.getUsage();
result
.then((response) => {
console.log(response);
})
.catch((err) => {
console.log(err);
});
```
For more sample codes, check the [**examples/**](https://github.com/tomba-io/deno/tree/master/examples) folder.
---
## Document: Dart Client Library
This is the official Dart client library for the [Tomba.io](https://tomba.io) Email Finder API
URL: /libraries/dart-email-finder
# Dart Client Library
## Installation
Add this to your package's `pubspec.yaml` file:
```yml
dependencies:
tomba: ^v1.0.1
```
You can install packages from the command line With [Dart](https://pub.dev/packages/tomba):
```bash
dart pub add tomba
```
## Usage
### Domain Search
get email addresses found on the internet.
```dart
import 'package:tomba/tomba.dart';
void main() {
// Init SDK
Client client = Client();
Domain domain = Domain(client);
client
.setKey("ta_xxxx") // Your Key
.setSecret("ts_xxxx"); // Your Secret
;
Future result = domain.domainSearch(
domain: 'stripe.com',
);
result
.then((response) {
print(response);
}).catchError((error) {
print(error.response);
});
}
```
### Email Finder
Find the verified email address of any professional.
```dart
import 'package:tomba/tomba.dart';
void main() {
// Init SDK
Client client = Client();
Finder finder = Finder(client);
client
.setKey("ta_xxxx") // Your Key
.setSecret("ts_xxxx"); // Your Secret
;
Future result = finder.emailFinder(
domain: 'stripe.com',
firstName: 'Fname',
lastName: 'Lname',
);
result
.then((response) {
print(response);
}).catchError((error) {
print(error.response);
});
}
```
### Email Verifier
Verify the validity of any professional email address with the most complete email checker.
```dart
import 'package:tomba/tomba.dart';
void main() {
// Init SDK
Client client = Client();
Verifier verifier = Verifier(client);
client
.setKey("ta_xxxx") // Your Key
.setSecret("ts_xxxx"); // Your Secret
;
Future result = verifier.emailVerifier(
email: 'm@wordpress.org',
);
result
.then((response) {
print(response);
}).catchError((error) {
print(error.response);
});
}
```
## Examples
### Get Account Information
```dart
import 'package:tomba/tomba.dart';
void main() {
// Init SDK
Client client = Client();
Account account = Account(client);
client
.setKey("ta_xxxx") // Your Key
.setSecret("ts_xxxx"); // Your Secret
;
Future result = account.getAccount();
result
.then((response) {
print(response);
}).catchError((error) {
print(error.response);
});
}
```
### Email Count
```dart
import 'package:tomba/tomba.dart';
void main() {
// Init SDK
Client client = Client();
Count count = Count(client);
client
.setKey("ta_xxxx") // Your Key
.setSecret("ts_xxxx"); // Your Secret
;
Future result = count.emailCount(
domain: 'tomba.io',
);
result
.then((response) {
print(response);
}).catchError((error) {
print(error.response);
});
}
```
### Finder Services
#### Author Finder
```dart
import 'package:tomba/tomba.dart';
void main() {
// Init SDK
Client client = Client();
Finder finder = Finder(client);
client
.setKey("ta_xxxx") // Your Key
.setSecret("ts_xxxx"); // Your Secret
;
Future result = finder.authorFinder(
url: 'https://clearbit.com/blog/company-name-to-domain-api',
);
result
.then((response) {
print(response);
}).catchError((error) {
print(error.response);
});
}
```
#### LinkedIn Finder
```dart
import 'package:tomba/tomba.dart';
void main() {
// Init SDK
Client client = Client();
Finder finder = Finder(client);
client
.setKey("ta_xxxx") // Your Key
.setSecret("ts_xxxx"); // Your Secret
;
Future result = finder.linkedinFinder(
url: 'https://www.linkedin.com/in/alex-maccaw-ab592978',
);
result
.then((response) {
print(response);
}).catchError((error) {
print(error.response);
});
}
```
#### Phone Finder
```dart
import 'package:tomba/tomba.dart';
void main() {
// Init SDK
Client client = Client();
Finder finder = Finder(client);
client
.setKey("ta_xxxx") // Your Key
.setSecret("ts_xxxx"); // Your Secret
;
Future result = finder.phoneFinder(
email: '******@zapier.com',
);
result
.then((response) {
print(response);
}).catchError((error) {
print(error.response);
});
}
```
### API Key Management
#### Create API Key
```dart
import 'package:tomba/tomba.dart';
void main() {
// Init SDK
Client client = Client();
Keys keys = Keys(client);
client
.setKey("ta_xxxx") // Your Key
.setSecret("ts_xxxx"); // Your Secret
;
Future result = keys.createKey();
result
.then((response) {
print(response);
}).catchError((error) {
print(error.response);
});
}
```
#### Delete API Key
```dart
import 'package:tomba/tomba.dart';
void main() {
// Init SDK
Client client = Client();
Keys keys = Keys(client);
client
.setKey("ta_xxxx") // Your Key
.setSecret("ts_xxxx"); // Your Secret
;
Future result = keys.deleteKey(
id: '',
);
result
.then((response) {
print(response);
}).catchError((error) {
print(error.response);
});
}
```
#### Get All API Keys
```dart
import 'package:tomba/tomba.dart';
void main() {
// Init SDK
Client client = Client();
Keys keys = Keys(client);
client
.setKey("ta_xxxx") // Your Key
.setSecret("ts_xxxx"); // Your Secret
;
Future result = keys.getKeys();
result
.then((response) {
print(response);
}).catchError((error) {
print(error.response);
});
}
```
#### Reset API Key
```dart
import 'package:tomba/tomba.dart';
void main() {
// Init SDK
Client client = Client();
Keys keys = Keys(client);
client
.setKey("ta_xxxx") // Your Key
.setSecret("ts_xxxx"); // Your Secret
;
Future result = keys.resetKey(
id: '',
);
result
.then((response) {
print(response);
}).catchError((error) {
print(error.response);
});
}
```
### Lead Attributes Management
#### Create Lead Attribute
```dart
import 'package:tomba/tomba.dart';
void main() {
// Init SDK
Client client = Client();
LeadsAttributes leadsAttributes = LeadsAttributes(client);
client
.setKey("ta_xxxx") // Your Key
.setSecret("ts_xxxx"); // Your Secret
;
Future result = leadsAttributes.createLeadAttribute();
result
.then((response) {
print(response);
}).catchError((error) {
print(error.response);
});
}
```
#### Delete Lead Attribute
```dart
import 'package:tomba/tomba.dart';
void main() {
// Init SDK
Client client = Client();
LeadsAttributes leadsAttributes = LeadsAttributes(client);
client
.setKey("ta_xxxx") // Your Key
.setSecret("ts_xxxx"); // Your Secret
;
Future result = leadsAttributes.deleteLeadAttribute(
id: '[Lead_Attributes_ID]',
);
result
.then((response) {
print(response);
}).catchError((error) {
print(error.response);
});
}
```
#### Get Lead Attributes
```dart
import 'package:tomba/tomba.dart';
void main() {
// Init SDK
Client client = Client();
LeadsAttributes leadsAttributes = LeadsAttributes(client);
client
.setKey("ta_xxxx") // Your Key
.setSecret("ts_xxxx"); // Your Secret
;
Future result = leadsAttributes.getLeadAttributes();
result
.then((response) {
print(response);
}).catchError((error) {
print(error.response);
});
}
```
#### Update Lead Attribute
```dart
import 'package:tomba/tomba.dart';
void main() {
// Init SDK
Client client = Client();
LeadsAttributes leadsAttributes = LeadsAttributes(client);
client
.setKey("ta_xxxx") // Your Key
.setSecret("ts_xxxx"); // Your Secret
;
Future result = leadsAttributes.updateLeadAttribute(
id: '[Lead_Attributes_ID]',
);
result
.then((response) {
print(response);
}).catchError((error) {
print(error.response);
});
}
```
### Lead Lists Management
#### Create Lead List
```dart
import 'package:tomba/tomba.dart';
void main() {
// Init SDK
Client client = Client();
LeadsLists leadsLists = LeadsLists(client);
client
.setKey("ta_xxxx") // Your Key
.setSecret("ts_xxxx"); // Your Secret
;
Future result = leadsLists.createList();
result
.then((response) {
print(response);
}).catchError((error) {
print(error.response);
});
}
```
#### Delete Lead List
```dart
import 'package:tomba/tomba.dart';
void main() {
// Init SDK
Client client = Client();
LeadsLists leadsLists = LeadsLists(client);
client
.setKey("ta_xxxx") // Your Key
.setSecret("ts_xxxx"); // Your Secret
;
Future result = leadsLists.deleteListId(
id: '[LIST_ID]',
);
result
.then((response) {
print(response);
}).catchError((error) {
print(error.response);
});
}
```
#### Get All Lead Lists
```dart
import 'package:tomba/tomba.dart';
void main() {
// Init SDK
Client client = Client();
LeadsLists leadsLists = LeadsLists(client);
client
.setKey("ta_xxxx") // Your Key
.setSecret("ts_xxxx"); // Your Secret
;
Future result = leadsLists.getLists();
result
.then((response) {
print(response);
}).catchError((error) {
print(error.response);
});
}
```
#### Update Lead List
```dart
import 'package:tomba/tomba.dart';
void main() {
// Init SDK
Client client = Client();
LeadsLists leadsLists = LeadsLists(client);
client
.setKey("ta_xxxx") // Your Key
.setSecret("ts_xxxx"); // Your Secret
;
Future result = leadsLists.updateListId(
id: '[List_ID]',
);
result
.then((response) {
print(response);
}).catchError((error) {
print(error.response);
});
}
```
### Activity Logs
```dart
import 'package:tomba/tomba.dart';
void main() {
// Init SDK
Client client = Client();
Logs logs = Logs(client);
client
.setKey("ta_xxxx") // Your Key
.setSecret("ts_xxxx"); // Your Secret
;
Future result = logs.getLogs();
result
.then((response) {
print(response);
}).catchError((error) {
print(error.response);
});
}
```
### Email Sources
```dart
import 'package:tomba/tomba.dart';
void main() {
// Init SDK
Client client = Client();
Sources sources = Sources(client);
client
.setKey("ta_xxxx") // Your Key
.setSecret("ts_xxxx"); // Your Secret
;
Future result = sources.emailSources(
email: 'b.mohamed@tomba.io',
);
result
.then((response) {
print(response);
}).catchError((error) {
print(error.response);
});
}
```
### Domain and Company Status
#### Auto Complete
```dart
import 'package:tomba/tomba.dart';
void main() {
// Init SDK
Client client = Client();
Status status = Status(client);
client
.setKey("ta_xxxx") // Your Key
.setSecret("ts_xxxx"); // Your Secret
;
Future result = status.autoComplete(
query: 'google',
);
result
.then((response) {
print(response);
}).catchError((error) {
print(error.response);
});
}
```
#### Domain Status
```dart
import 'package:tomba/tomba.dart';
void main() {
// Init SDK
Client client = Client();
Status status = Status(client);
client
.setKey("ta_xxxx") // Your Key
.setSecret("ts_xxxx"); // Your Secret
;
Future result = status.domainStatus(
domain: 'gmail.com',
);
result
.then((response) {
print(response);
}).catchError((error) {
print(error.response);
});
}
```
### Usage Statistics
```dart
import 'package:tomba/tomba.dart';
void main() {
// Init SDK
Client client = Client();
Usage usage = Usage(client);
client
.setKey("ta_xxxx") // Your Key
.setSecret("ts_xxxx"); // Your Secret
;
Future result = usage.getUsage();
result
.then((response) {
print(response);
}).catchError((error) {
print(error.response);
});
}
```
For more sample codes, check the [**examples/**](https://github.com/tomba-io/dart/tree/master/examples) folder.
---
## Document: C# Client Library
URL: /libraries/csharp-email-finder
# C# Client Library
## Installation
Add this reference to your project's `.csproj` file:
```xml
setDomain(e.target.value)}
placeholder="Enter company domain (e.g., tomba.io)"
className="domain-input"
/>
{error && {error}
}
{results.length > 0 && (
Found {results.length} emails:
{results.map((email, index) => (
{email.email}
))}
{email.first_name} {email.last_name}
{email.position}
Confidence: {email.confidence}%
setEmail(e.target.value)}
placeholder="Enter email address"
/>
);
};
export default EmailVerification;
```
**Ask Claude Code**:
```
@docs Complete this React component to integrate Tomba email verification:
1. Add proper TypeScript types from API documentation
2. Implement verification logic with error handling
3. Add loading states
4. Show verification results
5. Handle rate limiting
```
### 3. Express.js Integration
**Middleware Development**:
```javascript
// Basic middleware structure
const emailVerificationMiddleware = (req, res, next) => {
// TODO: Implement Tomba verification
next();
};
module.exports = { emailVerificationMiddleware };
```
**Ask Claude Code**:
```
@docs @file:middleware/validation.js
Complete this Express middleware to use Tomba email verification:
- Extract email from request body
- Call Tomba verification API
- Add verification result to request object
- Handle errors appropriately
- Respect rate limits
```
## Code Examples & Patterns
### 1. Async/Await Pattern
**Prompt**:
```
@docs Create an async function for Tomba email verification with:
- Proper TypeScript types
- Error handling with try/catch
- Timeout handling
- Retry logic for failed requests
```
**Generated Code**:
```typescript
import axios, { AxiosResponse } from "axios";
interface TombaVerificationResult {
email: string;
result: "valid" | "invalid" | "unknown";
score: number;
reason: string;
// ... other fields from API docs
}
interface TombaApiError {
error: string;
message: string;
status: number;
}
class TombaClient {
private apiKey: string;
private secretKey: string;
private baseUrl = "https://api.tomba.io/v1";
constructor(apiKey: string, secretKey: string) {
this.apiKey = apiKey;
this.secretKey = secretKey;
}
async verifyEmail(
email: string,
options: { timeout?: number; retries?: number } = {},
): Promise
---
## Top 10 Domains
- **lists.wikimedia.org:** 10.69M records
- **lists.fedoraproject.org:** 4.43M records
- **lists.fedorahosted.org:** 3.61M records
- **lists.centos.org:** 3.40M records
- **classiccmp.org:** 2.76M records
- **lists.openldap.org:** 2.50M records
- **inbox.sourceware.org:** 2.23M records
- **auto.hindustantimes.com:** 1.86M records
- **lists.jboss.org:** 1.74M records
- **lists.lysator.liu.se:** 1.67M records
---
## Role-Based Email Types
- **info@:** 429.66M emails
- **sales@:** 40.96M emails
- **contact@:** 36.21M emails
- **support@:** 29.19M emails
- **office@:** 17.96M emails
- **hello@:** 15.69M emails
- **admin@:** 12.11M emails
- **mail@:** 10.23M emails
- **kontakt@:** 9.89M emails
- **zakaz@:** 9.05M emails
- **Total Role-Based:** 792.68M (48.3% of all emails)
---
## Top 15 Countries
- **Generic TLD:** 789.12M records
- **Russia:** 153.94M records
- **Germany:** 99.44M records
- **Poland:** 50.13M records
- **Italy:** 46.33M records
- **Czech Republic:** 41.81M records
- **United Kingdom:** 41.07M records
- **Netherlands:** 31.39M records
- **France:** 25.10M records
- **Brazil:** 24.76M records
- **Ukraine:** 18.33M records
- **Sweden:** 18.30M records
- **Australia:** 17.09M records
- **Spain:** 16.92M records
- **Vietnam:** 16.14M records
---
## Domain Categories
- **Other:** 1.09B records
- **E-commerce:** 205.74M records
- **News:** 112.48M records
- **Blog:** 76.72M records
- **Technology:** 55.41M records
- **Education:** 53.49M records
- **Business:** 39.92M records
- **Entertainment:** 34.23M records
- **Government:** 29.44M records
- **Social:** 27.14M records
- **Adult:** 5.08M records
---
## Email Analysis
- **Webmail Domains:** 248.10M (542.0% of unique B2B Emails)
- **Business Domains:** 1.39B (84.9% of total)
- **Role-Based Emails:** 792.68M (48.3% of all emails)
- **File Extension Junk:** 91.70M detected and filtered
- **Valid Email Rate:** 94.71%
Role-based emails include: info@, sales@, support@, contact@, office@, hello@, admin@, service@, kontakt@, and more.
---
## Daily Time Series (Last 10 Days)
- **2025-11-10:** 142.05M records
- **2025-11-11:** 140.44M records
- **2025-11-12:** 136.22M records
- **2025-11-13:** 123.86M records
- **2025-11-14:** 137.90M records
- **2025-11-15:** 134.19M records
- **2025-11-16:** 136.49M records
- **2025-11-17:** 136.32M records
- **2025-11-18:** 137.04M records
- **2025-11-19:** 66.46M records
Peak day: November 10, 2025 with 142.05M records processed.
---
---
## Document: November Data Update
First official monthly data update with charts, stats, and new features.
URL: /data/2025/02-november
# November Data Update
This is our **first official data update**
We processed billions of records to keep datasets fresher, more accurate, and more complete.
Here’s what changed this month:
---
## Data Updates
- **Emails**: Imported, updated, and enriched **49.43M** email records for higher accuracy and coverage.
- **Companies**: Enhanced **10.51M** company profiles with social media links, detailed descriptions, country information, and additional attributes.
---
## Statistics Overview
- **Total Crawled Pages:** 2.08B
- **Unique B2B Emails:** 49.43M
- **Duplication Rate:** 97.63%
- **Invalid Email Rate:** 8.97%
- **Processing Time:** 33h 22m 56s
- **Pages Processed:** 2.08 Billion Pages in 33 hours
---
## Email Analysis
- **Webmail Domains:** 278.39M (5.63% of unique B2B Emails)
- **Business Domains:** 1.62B (85.3% of total)
- **Role-Based Emails:** 961.42M (50.7% of all emails; info@, sales@, support@, contact@, etc.)
---
## Top 10 Role-Based Email Types
- info – 504.41M
- sales – 55.77M
- support – 44.84M
- contact – 44.66M
- hello – 25.20M
- office – 20.15M
- admin – 13.74M
- service – 11.95M
- kontakt – 11.40M
- mail – 11.20M
---
## Daily Time Series (Last 10 Days)
- 10-10 – 157.02M
- 10-11 – 166.32M
- 10-12 – 157.82M
- 10-13 – 155.32M
- 10-14 – 161.35M
- 10-15 – 152.41M
- 10-16 – 153.38M
- 10-17 – 121.73M
- 10-18 – 118.43M
- 10-19 – 3.44M
---
## Weekday vs Weekend Activity
- **Weekday**: **1.29B (69.1%)**
- **Weekend**: **576.28M (30.9%)**
---
## Domain Categories
- Other – 1.20B
- E-commerce – 401.28M
- News – 115.82M
- Blog – 88.23M
- Technology – 61.72M
- Education – 55.48M
- Business – 45.93M
- Entertainment – 44.24M
- Government – 32.51M
- Social – 29.87M
- Adult – 7.13M
---
## Top Countries
- Generic TLD – 1.02B
- Russia – 162.57M
- Germany – 108.51M
- United Kingdom – 55.12M
- Poland – 53.96M
- Italy – 48.20M
- Czech Republic – 45.58M
- Netherlands – 37.64M
- France – 28.47M
- Brazil – 28.05M
- Australia – 27.36M
- Sweden – 21.74M
- Canada – 21.14M
- Spain – 19.52M
- Ukraine – 19.38M
---
## Hourly Activity
- **Peak hour**: **5:00 AM (80.87M records)**
---
## Top Domains
- lists.wikimedia.org – 8.23M
- lists.fedorahosted.org – 4.23M
- lists.fedoraproject.org – 4.16M
- lists.jboss.org – 3.72M
- lists.centos.org – 3.30M
- classiccmp.org – 2.61M
- lists.openldap.org – 2.42M
- inbox.sourceware.org – 2.25M
- lists.stg.fedoraproject.org – 2.13M
- lists.lysator.liu.se – 1.92M
---
---
## Document: October Data Update
First official monthly data update with charts, stats, and new features.
URL: /data/2025/01-october
# October Data Update
This is our **first official data update**
We processed billions of records to keep datasets fresher, more accurate, and more complete.
Here’s what changed this month:
---
## Data Updates
- **Emails**: Imported, updated, and enriched **46.47M** email records for higher accuracy and coverage.
- **Companies**: Enhanced **12M** company profiles with social media links, detailed descriptions, country information, and additional attributes.
---
## Statistics Overview
- **Total Records Processed**: **1.86B**
- **Unique Emails**: **46.47M**
- **Duplication Rate**: **97.5%**
- **Invalid Email Rate**: **8.98%**
- **Processing Time**: **30 days**
---
## Email Analysis
- **Webmail Domains**: **245.32M** (14.5%)
- **Business Domains**: **1.45B** (85.5%)
- **File Extension Junk**: **167.22M**
- **Role-based Emails**: **1.0K** _(note: role-based stats flagged for correction in next update)_
---
## Daily Time Series (Last 10 Days)
- Range: **09-09 → 09-18**
- Peak: **149.68M (09-09)**
- Low: **64.18M (09-18)**
---
## Weekday vs Weekend Activity
- **Weekday**: **1.29B (69.1%)**
- **Weekend**: **576.28M (30.9%)**
---
## Domain Categories
- Other: **1.07B**
- E-commerce: **359.28M**
- News: **108.47M**
- Blog: **75.84M**
- Technology: **57.30M**
- Education: **52.25M**
- Business: **38.82M**
- Entertainment: **38.53M**
- Government: **29.81M**
- Social: **26.95M**
- Adult: **6.35M**
---
## Top Countries
1. Generic TLD — 886.57M
2. Russia — 147.26M
3. Germany — 105.13M
4. UK — 48.30M
5. Italy — 44.35M
6. Poland — 44.01M
7. Czech Republic — 37.34M
8. Netherlands — 35.15M
9. Australia — 31.59M
10. France — 25.04M
11. Brazil — 22.59M
12. Ukraine — 20.33M
13. Canada — 19.77M
14. Austria — 17.29M
15. Spain — 17.13M
---
## Hourly Activity
- **Peak hour**: **5:00 AM (80.87M records)**
---
## Top Domains
- lists.wikimedia.org — 5.84M
- lists.fedoraproject.org — 4.14M
- lists.fedorahosted.org — 3.97M
- inbox.dpdk.org — 3.79M
- inbox.sourceware.org — 2.81M
- lists.centos.org — 2.77M
- mail.python.org — 2.35M
- lists.linuxaudio.org — 2.22M
- classiccmp.org — 1.79M
- auto.hindustantimes.com — 1.63M
---
---
## Document: January 2026 Data Update
Monthly data update with comprehensive statistics, charts, and insights.
URL: /data/2026/01-january
# January 2026 Data Update
We processed hundreds of millions of records to maintain fresh, accurate, and complete datasets.
Here's what changed this month:
---
## Data Updates
- **Total Records Processed:** 640M pages crawled
- **Unique B2B Emails:** 44.94M high-quality business emails
- **Data Quality:** 99.94% valid email rate with minimal duplication
- **Collection Period:** 10 days of continuous web crawling
---
## Overview Statistics
- **Total Crawled Pages:** 640M
- **Unique B2B Emails:** 44.94M
- **Duplication Rate:** 92.98%
- **Invalid Email Rate:** 0.06%
- **Data Collection Period:** 10 Days
- **Pages Processed:** 640 Million Pages in 10 days
---
## Top 10 Domains
- **inbox.sourceware.org:** 835.96K records
- **ville-bagnolet.fr:** 530.73K records
- **wtcgdynia.com.pl:** 453.11K records
- **ys99.com:** 419.44K records
- **nagasawa-mfg.co.jp:** 389.36K records
- **feedc0de.org:** 382.44K records
- **tvwatchers.nl:** 369.94K records
- **jsimlo.sk:** 369.15K records
- **macrumors.com:** 328.69K records
- **arrl.org:** 324.86K records
---
## Role-Based Email Types
- **info@:** 155.15M emails
- **contact@:** 15.18M emails
- **sales@:** 14.09M emails
- **support@:** 13.14M emails
- **office@:** 6.67M emails
- **hello@:** 6.41M emails
- **kontakt@:** 3.79M emails
- **mail@:** 3.62M emails
- **service@:** 3.46M emails
- **contato@:** 2.41M emails
- **Total Role-Based:** 288.37M (45.1% of all emails)
---
## Top 15 Countries
- **Generic TLD:** 286.55M records
- **Russia:** 44.88M records
- **Germany:** 39.91M records
- **Poland:** 23.31M records
- **Italy:** 20.77M records
- **United Kingdom:** 15.27M records
- **Czech Republic:** 13.83M records
- **Netherlands:** 12.02M records
- **France:** 10.67M records
- **Brazil:** 9.61M records
- **Switzerland:** 6.79M records
- **Australia:** 6.60M records
- **Sweden:** 6.50M records
- **Spain:** 6.47M records
- **Ukraine:** 6.44M records
---
## Domain Categories
- **Other:** 402.12M records
- **E-commerce:** 72.37M records
- **News:** 41.24M records
- **Blog:** 31.16M records
- **Education:** 23.28M records
- **Technology:** 17.20M records
- **Business:** 14.12M records
- **Entertainment:** 13.21M records
- **Government:** 12.95M records
- **Social:** 10.39M records
- **Adult:** 1.90M records
---
## Email Analysis
- **Webmail Domains:** 103.13M (22.9% of unique B2B Emails)
- **Business Domains:** 536.38M (83.9% of total)
- **Role-Based Emails:** 288.37M (45.1% of all emails)
- **File Extension Junk:** 406.78K detected and filtered
- **Valid Email Rate:** 99.94%
Role-based emails include: info@, sales@, support@, contact@, office@, hello@, kontakt@, mail@, service@, and more.
---
## Daily Time Series (Last 10 Days)
- **2025-12-08:** 52.23M records
- **2025-12-09:** 52.26M records
- **2025-12-10:** 49.97M records
- **2025-12-11:** 48.41M records
- **2025-12-12:** 48.97M records
- **2025-12-13:** 50.11M records
- **2025-12-14:** 50.85M records
- **2025-12-15:** 49.00M records
- **2025-12-16:** 49.16M records
- **2025-12-17:** 29.94M records
Peak day: December 9, 2025 with 52.26M records processed.
---
## Key Highlights
- **Record Quality:** Achieved 99.94% valid email rate, our highest ever
- **Deduplication Efficiency:** 92.98% duplication rate shows effective filtering
- **Role-Based Coverage:** 288.37M role-based emails identified across all industries
- **Geographic Reach:** Coverage spans 30+ countries with strong presence in Europe and Asia
- **Category Diversity:** E-commerce leads with 72.37M records, followed by News and Blog sectors
- [Tomba.io OpenAPI Documentation](/openapi.md): Complete OpenAPI specification and endpoint reference.