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}%
))}
)}
); }; export default EmailFinder;``
### 2\. API Client with Error Handling[](https://docs.tomba.io/llm/editor/cursor#2-api-client-with-error-handling)
**Prompt:**
Code
`@docs Create a robust Tomba API client class with: - Rate limiting - Retry logic - Comprehensive error handling - TypeScript support - All major endpoints`
### 3\. Integration with Form Validation[](https://docs.tomba.io/llm/editor/cursor#3-integration-with-form-validation)
**Prompt:**
Code
`@docs Create a form validation hook that uses Tomba email verifier to validate email addresses in real-time`
Advanced Features[](https://docs.tomba.io/llm/editor/cursor#advanced-features)
-------------------------------------------------------------------------------
### 1\. Custom Commands[](https://docs.tomba.io/llm/editor/cursor#1-custom-commands)
Create custom Cursor commands for Tomba API:
Code
`{ "commands": [ { "name": "Generate Tomba Email Finder", "command": "@docs Create an email finder function using Tomba API for the selected domain variable" }, { "name": "Add Tomba Verification", "command": "@docs Add Tomba email verification to the selected email input field" } ] }`
### 2\. Code Actions[](https://docs.tomba.io/llm/editor/cursor#2-code-actions)
Set up code actions for common Tomba API patterns:
Code
`{ "codeActions": { "tomba.addEmailVerification": { "title": "Add Tomba Email Verification", "kind": "refactor" } } }`
Best Practices[](https://docs.tomba.io/llm/editor/cursor#best-practices)
-------------------------------------------------------------------------
### 1\. Use Contextual Prompts[](https://docs.tomba.io/llm/editor/cursor#1-use-contextual-prompts)
Instead of generic requests, provide context:
Code
`@docs In my user registration form, add Tomba email verification before allowing signup`
### 2\. Leverage Cursor's Understanding[](https://docs.tomba.io/llm/editor/cursor#2-leverage-cursors-understanding)
Let Cursor understand your project structure:
Code
`@codebase @docs Integrate Tomba email finder into my existing user management system`
### 3\. Iterative Development[](https://docs.tomba.io/llm/editor/cursor#3-iterative-development)
Build incrementally:
Code
`@docs Start with a basic Tomba email verification function`
Then enhance:
Code
`@docs Add caching and rate limiting to the previous email verification function`
Troubleshooting[](https://docs.tomba.io/llm/editor/cursor#troubleshooting)
---------------------------------------------------------------------------
### Documentation Not Loading[](https://docs.tomba.io/llm/editor/cursor#documentation-not-loading)
1. Check your internet connection
2. Verify the URL: `https://docs.tomba.io/llms.txt`
3. Try refreshing the documentation panel
### API Code Not Working[](https://docs.tomba.io/llm/editor/cursor#api-code-not-working)
1. Ensure your API keys are properly set
2. Check the generated endpoint URLs
3. Verify authentication headers are included
### Context Issues[](https://docs.tomba.io/llm/editor/cursor#context-issues)
1. Make sure `.cursorrules` is in your project root
2. Check that custom instructions are properly formatted
3. Try restarting Cursor after configuration changes
Additional Resources[](https://docs.tomba.io/llm/editor/cursor#additional-resources)
-------------------------------------------------------------------------------------
* [Cursor Documentation](https://docs.cursor.com/)
* [Tomba API Reference](https://docs.tomba.io/api)
* [Authentication Guide](https://docs.tomba.io/authentication)
* [Rate Limits](https://docs.tomba.io/rate-limits)
Last modified on October 3, 2025
[VSCode Setup](https://docs.tomba.io/llm/editor/vscode)
[Zed Editor Setup](https://docs.tomba.io/llm/editor/zed)
JSON
JSON
TypeScript
JSON
JSON
---
# Pipedream Integration | Tomba Documentation
Menu
Overview[](https://docs.tomba.io/integrations/pipedream#overview)
------------------------------------------------------------------
Connect Tomba.io with 2,000+ apps on Pipedream to build serverless workflows with code-level control. Pipedream is a developer-first integration platform that lets you build powerful automations with Node.js code or pre-built actions.
Prerequisites[](https://docs.tomba.io/integrations/pipedream#prerequisites)
----------------------------------------------------------------------------
* Active Tomba.io account with API credentials
* Pipedream account (free or paid)
Setup & Authentication[](https://docs.tomba.io/integrations/pipedream#setup--authentication)
---------------------------------------------------------------------------------------------
### Connecting Tomba.io to Pipedream[](https://docs.tomba.io/integrations/pipedream#connecting-tombaio-to-pipedream)
1. In your workflow, search for **Tomba** in the action/trigger selector
2. Click **Connect Account**
3. Enter your Tomba.io credentials:
* **API Key**: Your Tomba.io API key
* **Secret Key**: Your Tomba.io secret key
4. Click **Save**
**Getting Your API Credentials:**
1. Log in to your [Tomba.io dashboard](https://app.tomba.io/)
2. Navigate to [API Keys](https://app.tomba.io/api)
3. Copy your API Key and Secret Key
Available Actions[](https://docs.tomba.io/integrations/pipedream#available-actions)
------------------------------------------------------------------------------------
### Email Finder[](https://docs.tomba.io/integrations/pipedream#email-finder)
Find professional email addresses using a person's name and company domain.
**Input:**
* **Domain** (required) - Company domain (e.g., `tomba.io`)
* **First Name** (required) - Person's first name
* **Last Name** (required) - Person's last name
**Output:**
* Email address
* Verification status
* Score (accuracy confidence)
* Position
* Department
* Social profiles
**Example Code:**
Code
``import { axios } from "@pipedream/platform"; export default defineComponent({ props: { tomba: { type: "app", app: "tomba", }, }, async run({ steps, $ }) { return await axios($, { url: `https://api.tomba.io/v1/email-finder`, params: { domain: "tomba.io", first_name: "Mohamed", last_name: "Ben rebia", }, headers: { "X-Tomba-Key": `${this.tomba.$auth.api_key}`, "X-Tomba-Secret": `${this.tomba.$auth.secret_key}`, }, }); }, });``
### Email Verifier[](https://docs.tomba.io/integrations/pipedream#email-verifier)
Verify if an email address is valid and deliverable.
**Input:**
* **Email** (required) - Email address to verify
**Output:**
* Email status (valid/invalid)
* Result (deliverable/undeliverable/risky)
* Score (0-100)
* SMTP check results
* Accept-all detection
* Disposable email detection
**Example Code:**
Code
``import { axios } from "@pipedream/platform"; export default defineComponent({ props: { tomba: { type: "app", app: "tomba", }, }, async run({ steps, $ }) { return await axios($, { url: `https://api.tomba.io/v1/email-verifier`, params: { email: "mohamed@tomba.io", }, headers: { "X-Tomba-Key": `${this.tomba.$auth.api_key}`, "X-Tomba-Secret": `${this.tomba.$auth.secret_key}`, }, }); }, });``
### Domain Search[](https://docs.tomba.io/integrations/pipedream#domain-search)
Search for all email addresses associated with a domain.
**Input:**
* **Domain** (required) - Company domain
* **Page** (optional) - Page number for pagination
* **Limit** (optional) - Results per page (max: 100)
* **Department** (optional) - Filter by department
**Output:**
* Array of email addresses
* Full names and positions
* Departments
* Social profiles
* Total count
**Example Code:**
Code
``import { axios } from "@pipedream/platform"; export default defineComponent({ props: { tomba: { type: "app", app: "tomba", }, }, async run({ steps, $ }) { return await axios($, { url: `https://api.tomba.io/v1/domain-search`, params: { domain: "tomba.io", page: 1, limit: 10, }, headers: { "X-Tomba-Key": `${this.tomba.$auth.api_key}`, "X-Tomba-Secret": `${this.tomba.$auth.secret_key}`, }, }); }, });``
### Email Count[](https://docs.tomba.io/integrations/pipedream#email-count)
Get the total number of email addresses for a domain.
**Input:**
* **Domain** (required) - Company domain
**Output:**
* Total email count
* Personal emails count
* Generic emails count
### LinkedIn Email Finder[](https://docs.tomba.io/integrations/pipedream#linkedin-email-finder)
Find email addresses from LinkedIn profile URLs.
**Input:**
* **LinkedIn URL** (required) - LinkedIn profile URL
**Output:**
* Email address
* Full name
* Position
* Company
* Verification status
### Enrichment[](https://docs.tomba.io/integrations/pipedream#enrichment)
Enrich company or contact data using email or domain.
**Input:**
* **Email** (optional) - Email address to enrich
* **Domain** (optional) - Domain to enrich
**Output:**
* Full profile data
* Company information
* Social profiles
* Technologies used
* Employee count
### Phone Finder[](https://docs.tomba.io/integrations/pipedream#phone-finder)
Find phone numbers associated with a domain, email, or LinkedIn URL.
**Input:**
* **Domain** (optional) - Company domain
* **Email** (optional) - Email address
* **LinkedIn URL** (optional) - LinkedIn profile URL
**Output:**
* Phone number(s)
* Phone type (mobile/work)
* Country code
* Verified status
Example Workflows[](https://docs.tomba.io/integrations/pipedream#example-workflows)
------------------------------------------------------------------------------------
### Lead Enrichment Pipeline[](https://docs.tomba.io/integrations/pipedream#lead-enrichment-pipeline)
**Trigger:** HTTP Webhook (receives lead data)
**Steps:**
1. **Parse webhook data** - Extract name, company, domain
2. **Tomba - Email Finder** - Find email using name + domain
3. **Tomba - Email Verifier** - Verify the found email
4. **Tomba - Enrichment** - Get additional profile data
5. **Filter** - Only continue if email is deliverable
6. **Send to CRM** - Create lead in Salesforce/HubSpot
7. **Slack notification** - Alert sales team
**Code Example:**
Code
``export default defineComponent({ async run({ steps, $ }) { const lead = steps.trigger.event.body; // Find email const emailResult = await axios($, { url: `https://api.tomba.io/v1/email-finder`, params: { domain: lead.domain, first_name: lead.firstName, last_name: lead.lastName, }, headers: { "X-Tomba-Key": this.tomba.$auth.api_key, "X-Tomba-Secret": this.tomba.$auth.secret_key, }, }); // Verify email const verifyResult = await axios($, { url: `https://api.tomba.io/v1/email-verifier`, params: { email: emailResult.data.email, }, headers: { "X-Tomba-Key": this.tomba.$auth.api_key, "X-Tomba-Secret": this.tomba.$auth.secret_key, }, }); // Return enriched lead data return { ...lead, email: emailResult.data.email, verification: verifyResult.data, }; }, });``
### Email Validation Service[](https://docs.tomba.io/integrations/pipedream#email-validation-service)
**Trigger:** New row in Google Sheets
**Steps:**
1. **For each row** - Iterate through email list
2. **Tomba - Email Verifier** - Verify each email
3. **Transform data** - Format verification results
4. **Update Google Sheets** - Write verification status
5. **Filter invalid** - Separate invalid emails
6. **Send summary email** - Report validation results
### Company Research Automation[](https://docs.tomba.io/integrations/pipedream#company-research-automation)
**Trigger:** New company added to CRM
**Steps:**
1. **Extract domain** - Get company website domain
2. **Tomba - Domain Search** - Find all company emails
3. **Tomba - Email Count** - Get total email count
4. **Loop through emails** - Process each found email
5. **Tomba - Enrichment** - Enrich each contact
6. **Store in Database** - Save to PostgreSQL/Airtable
7. **Generate report** - Create company research document
Advanced Features[](https://docs.tomba.io/integrations/pipedream#advanced-features)
------------------------------------------------------------------------------------
### Custom Code Steps[](https://docs.tomba.io/integrations/pipedream#custom-code-steps)
Pipedream allows you to write custom Node.js code for complex logic:
Code
`export default defineComponent({ async run({ steps, $ }) { const tombaResults = steps.tomba_email_finder.$return_value; // Custom validation logic if (tombaResults.data.score > 90) { // High confidence - proceed with outreach return { action: "send_email", email: tombaResults.data.email }; } else if (tombaResults.data.score > 70) { // Medium confidence - manual review return { action: "review", email: tombaResults.data.email }; } else { // Low confidence - skip return { action: "skip" }; } }, });`
### Error Handling[](https://docs.tomba.io/integrations/pipedream#error-handling)
Add try-catch blocks for robust workflows:
Code
``export default defineComponent({ async run({ steps, $ }) { try { const result = await axios($, { url: `https://api.tomba.io/v1/email-finder`, params: steps.trigger.event.body, headers: { "X-Tomba-Key": this.tomba.$auth.api_key, "X-Tomba-Secret": this.tomba.$auth.secret_key, }, }); return result; } catch (error) { // Log error and return gracefully console.error("Tomba API Error:", error); return { error: error.message, status: "failed" }; } }, });``
### Batch Processing[](https://docs.tomba.io/integrations/pipedream#batch-processing)
Process multiple items efficiently:
Code
``export default defineComponent({ async run({ steps, $ }) { const leads = steps.trigger.event.body.leads; // Process in batches of 10 const batchSize = 10; const results = []; for (let i = 0; i < leads.length; i += batchSize) { const batch = leads.slice(i, i + batchSize); const promises = batch.map((lead) => axios($, { url: `https://api.tomba.io/v1/email-finder`, params: { domain: lead.domain, first_name: lead.firstName, last_name: lead.lastName, }, headers: { "X-Tomba-Key": this.tomba.$auth.api_key, "X-Tomba-Secret": this.tomba.$auth.secret_key, }, }), ); const batchResults = await Promise.all(promises); results.push(...batchResults); // Rate limiting - wait between batches await new Promise((resolve) => setTimeout(resolve, 1000)); } return results; }, });``
Troubleshooting[](https://docs.tomba.io/integrations/pipedream#troubleshooting)
--------------------------------------------------------------------------------
### Authentication Issues[](https://docs.tomba.io/integrations/pipedream#authentication-issues)
**Problem:** "Authentication failed" or 401 errors
**Solutions:**
* Verify API credentials in [Tomba.io dashboard](https://app.tomba.io/api)
* Reconnect the Tomba account in Pipedream
* Check that your Tomba.io account is active
* Ensure API keys haven't been regenerated
### Rate Limiting[](https://docs.tomba.io/integrations/pipedream#rate-limiting)
**Problem:** 429 "Too Many Requests" errors
**Solutions:**
* Add delays between API calls using `setTimeout`
* Implement exponential backoff
* Check your [Tomba.io plan limits](https://tomba.io/pricing)
* Use batch processing with rate limiting
**Example with delay:**
Code
`// Add delay between requests await new Promise((resolve) => setTimeout(resolve, 1000));`
### No Data Returned[](https://docs.tomba.io/integrations/pipedream#no-data-returned)
**Problem:** Empty results from Tomba API
**Solutions:**
* Verify input parameters are correct
* Check that the email/domain exists in Tomba's database
* Review workflow execution logs in Pipedream
* Test the API call directly using curl or Postman
### Workflow Execution Errors[](https://docs.tomba.io/integrations/pipedream#workflow-execution-errors)
**Problem:** Workflow fails mid-execution
**Solutions:**
* Add error handling with try-catch blocks
* Use conditional steps to handle missing data
* Enable "Continue on error" for non-critical steps
* Check Pipedream's execution history for detailed logs
Best Practices[](https://docs.tomba.io/integrations/pipedream#best-practices)
------------------------------------------------------------------------------
1. **Use Environment Variables** - Store sensitive data in Pipedream secrets
2. **Implement Retries** - Add retry logic for failed API calls
3. **Validate Inputs** - Check data before sending to Tomba API
4. **Log Important Events** - Use `console.log()` for debugging
5. **Test Workflows** - Use Pipedream's testing feature before deploying
6. **Monitor Usage** - Track your Tomba.io API usage regularly
7. **Handle Edge Cases** - Account for missing or invalid data
8. **Optimize Performance** - Use parallel processing where possible
Pipedream Features[](https://docs.tomba.io/integrations/pipedream#pipedream-features)
--------------------------------------------------------------------------------------
### Event Sources[](https://docs.tomba.io/integrations/pipedream#event-sources)
Pipedream can listen to events from various sources:
* HTTP webhooks
* Cron schedules
* Email (incoming)
* RSS feeds
* App events (new row in sheets, new email, etc.)
### Data Stores[](https://docs.tomba.io/integrations/pipedream#data-stores)
Store data between workflow runs:
Code
`// Store email verification results await require("@pipedream/platform").axios($, { method: "POST", url: this.$checkpoint, data: { email: steps.tomba_verify.$return_value.data.email, status: steps.tomba_verify.$return_value.data.result, timestamp: Date.now(), }, });`
### SQL Queries[](https://docs.tomba.io/integrations/pipedream#sql-queries)
Query databases directly in workflows:
Code
`import { PrismaClient } from "@prisma/client"; const prisma = new PrismaClient(); await prisma.lead.create({ data: { email: steps.tomba_finder.$return_value.data.email, verified: true, }, });`
API Rate Limits[](https://docs.tomba.io/integrations/pipedream#api-rate-limits)
--------------------------------------------------------------------------------
Tomba.io API limits vary by plan:
* **Free**: 50 requests/month
* **Starter**: 1,000 requests/month
* **Growth**: 5,000 requests/month
* **Business**: 25,000 requests/month
* **Enterprise**: Custom limits
[View detailed pricing](https://tomba.io/pricing)
Pipedream Pricing[](https://docs.tomba.io/integrations/pipedream#pipedream-pricing)
------------------------------------------------------------------------------------
* **Free**: 100 workflow executions/day
* **Basic**: $19/month - 1,000 executions/day
* **Advanced**: $49/month - 5,000 executions/day
* **Business**: Custom pricing
[View Pipedream pricing](https://pipedream.com/pricing)
Resources[](https://docs.tomba.io/integrations/pipedream#resources)
--------------------------------------------------------------------
* [Tomba.io API Documentation](https://docs.tomba.io/)
* [Pipedream Documentation](https://pipedream.com/docs)
* [Tomba on Pipedream](https://pipedream.com/apps/tomba)
* [Pipedream Community](https://pipedream.com/community)
* [API Status](https://status.tomba.io/)
Support[](https://docs.tomba.io/integrations/pipedream#support)
----------------------------------------------------------------
### Tomba.io Support[](https://docs.tomba.io/integrations/pipedream#tombaio-support)
* Email: [support@tomba.io](mailto:support@tomba.io)
* Dashboard: [app.tomba.io](https://app.tomba.io/)
### Pipedream Support[](https://docs.tomba.io/integrations/pipedream#pipedream-support)
* Community: [pipedream.com/community](https://pipedream.com/community)
* Documentation: [pipedream.com/docs](https://pipedream.com/docs)
* Twitter: [@PipedreamHQ](https://twitter.com/PipedreamHQ)
FAQs[](https://docs.tomba.io/integrations/pipedream#faqs)
----------------------------------------------------------
**Q: Can I use Tomba.io in scheduled workflows?** A: Yes, create a Cron trigger and connect Tomba actions to run on a schedule.
**Q: How do I handle pagination in Domain Search?** A: Use a loop step to iterate through pages, incrementing the page parameter.
**Q: Can I export Tomba data to a database?** A: Yes, use Pipedream's database integrations (PostgreSQL, MySQL, etc.) after Tomba steps.
**Q: Is it possible to combine multiple Tomba actions?** A: Absolutely! Chain multiple Tomba actions together in a single workflow.
**Q: How do I test my workflow without consuming API credits?** A: Use Pipedream's test mode with sample data before deploying to production.
Version History[](https://docs.tomba.io/integrations/pipedream#version-history)
--------------------------------------------------------------------------------
**v1.0.0** - Initial Pipedream integration
* Email Finder action
* Email Verifier action
* Domain Search action
* LinkedIn Finder action
* Enrichment action
* Phone Finder action
* Full Node.js SDK support
Last modified on February 11, 2026
[Make (Integromat) Integration](https://docs.tomba.io/integrations/make)
[Integrate Tomba Finder with n8n](https://docs.tomba.io/integrations/n8n)
Javascript
Javascript
Javascript
Javascript
Javascript
Javascript
Javascript
Javascript
Javascript
Javascript
---
# Integrate Tomba Finder with MyBB | Tomba Documentation
Menu
Overview[](https://docs.tomba.io/integrations/mybb#overview)
-------------------------------------------------------------
The **MyBB Disposable Email Blocker** is an indispensable security tool that provides a superior line of defense for your forum registration process. This plugin enhances security and reliability by preventing users from registering with disposable, temporary, or invalid email addresses.
### Why Use This Plugin?[](https://docs.tomba.io/integrations/mybb#why-use-this-plugin)
* 🛡️ **Enhanced Security**: Prevents spam registrations and fake accounts
* 📧 **Email Quality**: Ensures only legitimate email addresses are used
* 🚫 **Spam Reduction**: Significantly reduces spam and bot registrations
* **User Experience**: Provides real-time validation feedback
* 📊 **Data Integrity**: Maintains clean and reliable user database
* ⚡ **JavaScript-Based**: Fast, client-side validation with instant feedback
### Key Benefits[](https://docs.tomba.io/integrations/mybb#key-benefits)
* **Real-time Validation**: Instant feedback during registration
* **Always Up-to-Date**: Daily updates of disposable email domains
* **Fully Customizable**: Custom error messages and settings
* **Lightweight**: JavaScript-based solution with minimal server load
* **User-Friendly**: Clear error messages guide users to valid emails
* **Comprehensive Protection**: Blocks disposable, invalid, and webmail addresses
Features[](https://docs.tomba.io/integrations/mybb#features)
-------------------------------------------------------------
### Core Protection Features[](https://docs.tomba.io/integrations/mybb#core-protection-features)
* **Invalid Email Detection**: Identifies malformed email addresses
* **Invalid Domain Detection**: Blocks emails from non-existent domains
* **Disposable Email Blocking**: Prevents temporary/throwaway email services
* **Webmail Blocking**: Optional blocking of free webmail providers
* **Real-time Validation**: Instant feedback during typing
* **Custom Error Messages**: Personalized validation messages
### 🔄 Advanced Features[](https://docs.tomba.io/integrations/mybb#-advanced-features)
* **Daily Domain Updates**: Automatically updated disposable email database
* **Pattern Recognition**: Advanced detection algorithms
* **Whitelist Support**: Allow specific domains despite general rules
* **Multiple Validation Levels**: Different strictness levels available
* **API Integration**: Powered by Tomba.io's email intelligence
* **Browser Compatibility**: Works across all modern browsers
### 📋 Supported Detection Types[](https://docs.tomba.io/integrations/mybb#-supported-detection-types)
| Detection Type | Description | Customizable |
| --- | --- | --- |
| **Invalid Format** | Malformed email addresses | Yes |
| **Invalid Domains** | Non-existent or invalid domains | Yes |
| **Disposable Emails** | Temporary/throwaway email services | Yes |
| **Webmail Services** | Free email providers (Gmail, Yahoo, etc.) | Yes |
| **Spam Domains** | Known spam and abuse domains | Yes |
Installation[](https://docs.tomba.io/integrations/mybb#installation)
---------------------------------------------------------------------
### Prerequisites[](https://docs.tomba.io/integrations/mybb#prerequisites)
* MyBB 1.8.x or higher
* Administrator access to your MyBB forum
* Web server with JavaScript support
### Step 1: Download the Plugin[](https://docs.tomba.io/integrations/mybb#step-1-download-the-plugin)
1. **Download** the latest release from [GitHub](https://github.com/tomba-io/mybb-disposable-email-blocker)
2. **Extract** the downloaded ZIP file
3. **Locate** the `inc` folder in the extracted files
### Step 2: Upload Files[](https://docs.tomba.io/integrations/mybb#step-2-upload-files)
1. **Connect** to your server via FTP or file manager
2. **Navigate** to your MyBB forum root directory
3. **Upload** the contents of the `inc` folder to your forum's `inc` folder
4. **Ensure** all files are properly uploaded and permissions are correct
### Step 3: Activate the Plugin[](https://docs.tomba.io/integrations/mybb#step-3-activate-the-plugin)
1. **Log in** to your MyBB Admin Control Panel (ACP)
2. **Navigate** to `Configuration` → `Plugins`
3. **Find** "Disposable Email Blocker" in the inactive plugins list
4. **Click** "Activate" to enable the plugin
5. **Verify** the plugin appears in the active plugins list
### File Structure After Installation[](https://docs.tomba.io/integrations/mybb#file-structure-after-installation)
Code
`inc/ ├── plugins/ │ └── disposable_email_blocker.php ├── languages/ │ └── english/ │ └── disposable_email_blocker.lang.php └── jscripts/ └── disposable-email-blocker.min.js`
Configuration[](https://docs.tomba.io/integrations/mybb#configuration)
-----------------------------------------------------------------------
### Access Plugin Settings[](https://docs.tomba.io/integrations/mybb#access-plugin-settings)
1. **Navigate** to MyBB Admin Control Panel
2. **Go to** `Configuration` → `Settings`
3. **Find** "Disposable Email Blocker" settings group
4. **Configure** options according to your needs
### Available Settings[](https://docs.tomba.io/integrations/mybb#available-settings)
#### General Settings[](https://docs.tomba.io/integrations/mybb#general-settings)
| Setting | Description | Default | Options |
| --- | --- | --- | --- |
| **Enable Plugin** | Enable/disable the blocker | Enabled | On/Off |
| **Validation Mode** | When to validate emails | Real-time | Real-time, On Submit |
| **API Endpoint** | Custom API URL for validation | Tomba.io | Custom URL |
| **Debug Mode** | Show debug information | Disabled | On/Off |
#### Disposable Email Settings[](https://docs.tomba.io/integrations/mybb#disposable-email-settings)
| Setting | Description | Default |
| --- | --- | --- |
| **Block Disposable** | Block disposable email services | Enabled |
| **Disposable Message** | Custom error message | "Disposable emails are not allowed" |
| **Update Frequency** | How often to update domain list | Daily |
| **Custom Domains** | Additional domains to block | Empty |
#### Webmail Settings[](https://docs.tomba.io/integrations/mybb#webmail-settings)
| Setting | Description | Default |
| --- | --- | --- |
| **Block Webmail** | Block webmail providers | Disabled |
| **Webmail Message** | Warning/error message | "Professional email recommended" |
| **Webmail Action** | Block or warn | Warn |
| **Allowed Webmail** | Whitelist specific webmail | Empty |
#### Error Display Settings[](https://docs.tomba.io/integrations/mybb#error-display-settings)
| Setting | Description | Default |
| --- | --- | --- |
| **Error Style** | CSS styling for error messages | Red text |
| **Error Position** | Where to show errors | Below field |
| **Animation** | Error message animation | Fade in |
| **Icon Display** | Show warning/error icons | Enabled |
### Sample Configuration[](https://docs.tomba.io/integrations/mybb#sample-configuration)
Code
`// Example settings in MyBB ACP 'disposable_email_blocker_enabled' => '1', 'disposable_email_blocker_block_webmail' => '0', 'disposable_email_blocker_disposable_message' => 'Disposable emails are not allowed. Please use a permanent email address.', 'disposable_email_blocker_webmail_message' => 'Warning: Professional email addresses are recommended for better account security.', 'disposable_email_blocker_debug' => '0'`
Usage[](https://docs.tomba.io/integrations/mybb#usage)
-------------------------------------------------------
### For Forum Administrators[](https://docs.tomba.io/integrations/mybb#for-forum-administrators)
#### Basic Setup[](https://docs.tomba.io/integrations/mybb#basic-setup)
1. **Install and activate** the plugin
2. **Configure settings** in the ACP
3. **Test registration** with disposable emails
4. **Monitor** registration attempts and spam reduction
5. **Adjust settings** based on your community needs
#### Advanced Configuration[](https://docs.tomba.io/integrations/mybb#advanced-configuration)
Code
`// Custom JavaScript configuration (optional) `
### For Users (Registration Experience)[](https://docs.tomba.io/integrations/mybb#for-users-registration-experience)
#### Valid Email Registration[](https://docs.tomba.io/integrations/mybb#valid-email-registration)
Code
`User enters: john.doe@company.com Result: Email accepted, registration proceeds`
#### Disposable Email Attempt[](https://docs.tomba.io/integrations/mybb#disposable-email-attempt)
Code
`User enters: temp123@10minutemail.com ❌ Result: Error message appears "Disposable emails are not allowed. Please use a permanent email address."`
#### Webmail Warning (If Configured)[](https://docs.tomba.io/integrations/mybb#webmail-warning-if-configured)
Code
`User enters: john.doe@gmail.com ⚠️ Result: Warning message (registration still allowed) "Professional email addresses are recommended for better account security."`
Technical Details[](https://docs.tomba.io/integrations/mybb#technical-details)
-------------------------------------------------------------------------------
### How It Works[](https://docs.tomba.io/integrations/mybb#how-it-works)
1. **JavaScript Integration**: Plugin integrates with MyBB registration forms
2. **Real-time Validation**: Validates emails as users type
3. **API Communication**: Checks emails against Tomba.io database
4. **Domain Database**: Maintains updated list of disposable domains
5. **Client-side Processing**: Fast validation without server round-trips
6. **Fallback Protection**: Server-side validation as backup
### Validation Process[](https://docs.tomba.io/integrations/mybb#validation-process)
Code
`graph TD A[User Types Email] --> B[JavaScript Validation] B --> C{Email Format Valid?} C -->|No| D[Show Format Error] C -->|Yes| E[Check Domain] E --> F{Domain Valid?} F -->|No| G[Show Domain Error] F -->|Yes| H[Check Disposable] H --> I{Is Disposable?} I -->|Yes| J[Show Disposable Error] I -->|No| K[Check Webmail] K --> L{Is Webmail?} L -->|Yes & Blocked| M[Show Webmail Error] L -->|Yes & Warning| N[Show Warning] L -->|No| O[Email Approved]`
### JavaScript API[](https://docs.tomba.io/integrations/mybb#javascript-api)
The plugin provides a JavaScript API for advanced customization:
Code
`// Initialize with custom settings new Disposable.Blocker({ disposable: { message: "Custom disposable email error message", }, webmail: { message: "Custom webmail warning message", block: false, }, }); // Event listeners disposableBlocker.on("invalid", function (email, reason) { console.log("Invalid email:", email, "Reason:", reason); }); disposableBlocker.on("valid", function (email) { console.log("Valid email:", email); });`
Troubleshooting[](https://docs.tomba.io/integrations/mybb#troubleshooting)
---------------------------------------------------------------------------
### Common Issues[](https://docs.tomba.io/integrations/mybb#common-issues)
#### Issue: False Positives (Valid Emails Blocked)[](https://docs.tomba.io/integrations/mybb#issue-false-positives-valid-emails-blocked)
**Symptoms:**
* Legitimate emails being rejected
* Users can't register with business emails
* Over-aggressive blocking
**Solutions:**
1. **Adjust settings** - reduce strictness level
2. **Add to whitelist** - allow specific domains
3. **Check domain status** - verify domain isn't miscategorized
4. **Update plugin** - ensure latest domain database
#### Issue: Disposable Emails Still Getting Through[](https://docs.tomba.io/integrations/mybb#issue-disposable-emails-still-getting-through)
**Symptoms:**
* Spam registrations continuing
* Known disposable domains not blocked
* Plugin seems ineffective
**Solutions:**
1. **Update domain database** - ensure latest disposable domain list
2. **Check plugin settings** - verify disposable blocking is enabled
3. **Monitor new domains** - add newly discovered disposable services
4. **Enable server-side validation** - add backup validation
#### Issue: Performance Problems[](https://docs.tomba.io/integrations/mybb#issue-performance-problems)
**Symptoms:**
* Slow page loading
* Registration form lag
* High server load
**Solutions:**
1. **Enable caching** - cache domain lookups locally
2. **Optimize settings** - reduce API calls frequency
3. **Use CDN** - load JavaScript from CDN
4. **Check server resources** - ensure adequate server capacity
### Debug Mode[](https://docs.tomba.io/integrations/mybb#debug-mode)
Enable debug mode to troubleshoot issues:
1. **Access** plugin settings in ACP
2. **Enable** debug mode
3. **Check** browser console for detailed logs
4. **Review** validation process step-by-step
Code
`// Debug output example Disposable Blocker Debug: - Email: test@10minutemail.com - Domain: 10minutemail.com - Type: disposable - Action: block - Message: Disposable emails are not allowed`
### Log File Analysis[](https://docs.tomba.io/integrations/mybb#log-file-analysis)
Check MyBB error logs for plugin-related issues:
TerminalCode
`# Common log locations tail -f /path/to/mybb/inc/logs/error.log tail -f /var/log/apache2/error.log tail -f /var/log/nginx/error.log`
Support[](https://docs.tomba.io/integrations/mybb#support)
-----------------------------------------------------------
### Getting Help[](https://docs.tomba.io/integrations/mybb#getting-help)
#### Documentation & Resources[](https://docs.tomba.io/integrations/mybb#documentation--resources)
* 📚 [Plugin Documentation](https://github.com/tomba-io/mybb-disposable-email-blocker/wiki)
* 🔧 [MyBB Community Forums](https://community.mybb.com/)
* 🌐 [Tomba.io API Documentation](https://docs.tomba.io/)
* 💡 [MyBB Plugin Development Guide](https://docs.mybb.com/1.8/development/)
#### Support Channels[](https://docs.tomba.io/integrations/mybb#support-channels)
* 🐛 **Bug Reports**: [GitHub Issues](https://github.com/tomba-io/mybb-disposable-email-blocker/issues)
* 💬 **Feature Requests**: [GitHub Discussions](https://github.com/tomba-io/mybb-disposable-email-blocker/discussions)
* 📧 **Email Support**: [support@tomba.io](mailto:support@tomba.io)
* 🏛️ **MyBB Community**: [MyBB Forum Thread](https://community.mybb.com/mods.php?action=view&pid=1571)
### Frequently Asked Questions[](https://docs.tomba.io/integrations/mybb#frequently-asked-questions)
#### Q: Is this plugin free?[](https://docs.tomba.io/integrations/mybb#q-is-this-plugin-free)
**A:** Yes, the Disposable Email Blocker plugin is completely free to use.
#### Q: Does it work with custom MyBB themes?[](https://docs.tomba.io/integrations/mybb#q-does-it-work-with-custom-mybb-themes)
**A:** Yes, the plugin is designed to work with all MyBB themes. The JavaScript integrates automatically with registration forms.
#### Q: Can I customize the error messages?[](https://docs.tomba.io/integrations/mybb#q-can-i-customize-the-error-messages)
**A:** Yes, all error messages are fully customizable through the plugin settings in your MyBB Admin Control Panel.
#### Q: How often is the disposable domain list updated?[](https://docs.tomba.io/integrations/mybb#q-how-often-is-the-disposable-domain-list-updated)
**A:** The domain database is updated daily to include new disposable email services and remove inactive ones.
#### Q: Can I block specific domains manually?[](https://docs.tomba.io/integrations/mybb#q-can-i-block-specific-domains-manually)
**A:** Yes, you can add custom domains to the blocklist through the plugin settings.
#### Q: Does it affect forum performance?[](https://docs.tomba.io/integrations/mybb#q-does-it-affect-forum-performance)
**A:** No, the plugin uses client-side JavaScript validation, which doesn't impact server performance.
#### Q: Can users bypass the validation?[](https://docs.tomba.io/integrations/mybb#q-can-users-bypass-the-validation)
**A:** The plugin includes both client-side and server-side validation to prevent bypassing.
Last modified on April 27, 2026
[Orthogonal Integration](https://docs.tomba.io/integrations/orthogonal)
[Integrate Tomba Finder with Maltego](https://docs.tomba.io/integrations/maltego)
PHP
Javascript
Javascript
Javascript
---
# Phone Finder Bulk | Tomba Documentation
Menu
Overview[](https://docs.tomba.io/bulks/phone-finder#overview)
--------------------------------------------------------------
[Bulks Phone Finder](https://tomba.io/bulks/phone-finder)
enables you to discover phone numbers associated with email addresses, company websites, and LinkedIn profiles. Expand your contact methods and enable multi-channel outreach strategies with comprehensive phone number discovery.
### Key Features[](https://docs.tomba.io/bulks/phone-finder#key-features)
* **Multi-Source Discovery**: Find phone numbers from emails, websites, and LinkedIn URLs
* **Bulk Processing**: Process up to 2,500 contacts per operation
* **Contact Expansion**: Add phone numbers to existing contact databases
* **Multi-Channel Outreach**: Enable phone-based sales and marketing activities
* **Quality Filtering**: Filter out invalid and non-business phone numbers
### How Phone Finder Bulk Works[](https://docs.tomba.io/bulks/phone-finder#how-phone-finder-bulk-works)
1. **Prepare Contact List**: Compile emails, website URLs, or LinkedIn profile URLs
2. **Upload Data**: Provide contact information for phone number discovery
3. **Process Discovery**: Launch phone number search algorithms
4. **Review Results**: Examine discovered phone numbers with source context
5. **Export Contacts**: Download enriched contact lists with phone numbers
### Limitations[](https://docs.tomba.io/bulks/phone-finder#limitations)
* Each Bulk is limited to 2,500 email addresses, websites, or LinkedIn profile URLs
* Webmail addresses (Gmail, Outlook, etc.) and disposable emails are skipped
* Special or unexpected characters may be removed from your file
* Duplicate and invalid lines will not be imported
Go SDK Integration[](https://docs.tomba.io/bulks/phone-finder#go-sdk-integration)
----------------------------------------------------------------------------------
### Installation[](https://docs.tomba.io/bulks/phone-finder#installation)
TerminalCode
`go get github.com/tomba-io/go`
### Basic Setup[](https://docs.tomba.io/bulks/phone-finder#basic-setup)
Code
`package main import ( "fmt" "log" "time" "strings" "github.com/tomba-io/go/tomba" "github.com/tomba-io/go/tomba/models" ) func main() { // Initialize Tomba client client := tomba.NewTomba("your-api-key", "your-secret-key") // Your phone finder code here }`
### Finding Phone Numbers from Email List[](https://docs.tomba.io/bulks/phone-finder#finding-phone-numbers-from-email-list)
Code
`// Email addresses for phone number discovery emailList := []string{ "contact@techcorp.com", "sales@startup.io", "info@enterprise.com", "support@business.net", "hello@company.org", } params := &models.BulkCreateParams{ Name: "Phone Discovery - Email Sources", List: strings.Join(emailList, "\n"), Sources: true, // Include sources for context Notifie: true, // Notify when complete } // Create phone finder bulk operation response, err := client.CreateBulk(models.BulkTypePhoneFinder, params) if err != nil { log.Fatal("Failed to create phone finder bulk:", err) } bulkID := *response.Data.ID fmt.Printf("Created phone finder bulk with ID: %d\n", bulkID)`
### Finding Phone Numbers from Website URLs[](https://docs.tomba.io/bulks/phone-finder#finding-phone-numbers-from-website-urls)
Code
`// Company websites for phone discovery websites := []string{ "https://techcorp.com", "https://startup.io", "https://enterprise.com", "https://business.net", "https://company.org", } params := &models.BulkCreateParams{ Name: "Phone Discovery - Company Websites", List: strings.Join(websites, "\n"), Sources: true, Notifie: true, } response, err := client.CreateBulk(models.BulkTypePhoneFinder, params) if err != nil { log.Fatal("Failed to create phone finder bulk:", err) } bulkID := *response.Data.ID fmt.Printf("Created website phone finder bulk: %d\n", bulkID)`
### Creating Phone Finder from CSV File[](https://docs.tomba.io/bulks/phone-finder#creating-phone-finder-from-csv-file)
Code
`// Create phone finder from CSV with mixed sources params := &models.BulkCreateParams{ Name: "Multi-Channel Phone Discovery", Delimiter: ",", Column: 2, // Source column (email/website/linkedin URL) Sources: true, Notifie: true, } // CSV can contain emails, websites, or LinkedIn URLs response, err := client.CreateBulkWithFile( models.BulkTypePhoneFinder, params, "/path/to/contact-sources.csv", ) if err != nil { log.Fatal("Failed to create bulk with file:", err) } bulkID := *response.Data.ID fmt.Printf("Created phone finder bulk: %d\n", bulkID)`
### Launching and Monitoring Phone Discovery[](https://docs.tomba.io/bulks/phone-finder#launching-and-monitoring-phone-discovery)
Code
`// Launch the phone discovery process launchResponse, err := client.LaunchBulk(models.BulkTypePhoneFinder, bulkID) if err != nil { log.Fatal("Failed to launch phone finder:", err) } fmt.Println("Phone number discovery started!") // Monitor progress startTime := time.Now() for { progress, err := client.GetBulkProgress(models.BulkTypePhoneFinder, bulkID) if err != nil { log.Printf("Error checking progress: %v", err) time.Sleep(30 * time.Second) continue } elapsed := time.Since(startTime).Round(time.Second) fmt.Printf("Phone discovery: %d%% (%d processed) - %v elapsed\n", progress.Progress, progress.Processed, elapsed, ) if progress.Status { fmt.Println("Phone number discovery completed!") break } // Check every 45 seconds (phone discovery can be slower) time.Sleep(45 * time.Second) }`
### Retrieving Phone Discovery Results[](https://docs.tomba.io/bulks/phone-finder#retrieving-phone-discovery-results)
Code
`// Get detailed results bulk, err := client.GetBulk(models.BulkTypePhoneFinder, bulkID) if err != nil { log.Fatal("Failed to get bulk details:", err) } bulkInfo := bulk.Data[0] fmt.Printf("Phone Discovery Results:\n") fmt.Printf("- Campaign: %s\n", bulkInfo.Name) fmt.Printf("- Status: %v\n", bulkInfo.Status) fmt.Printf("- Sources Processed: %d\n", bulkInfo.Processed) // Download results with phone numbers err = client.SaveBulkResults( models.BulkTypePhoneFinder, bulkID, "phone-numbers.csv", "full", ) if err != nil { log.Fatal("Failed to download results:", err) } fmt.Println("Phone numbers saved to phone-numbers.csv") // Download only records where phones were found err = client.SaveBulkResults( models.BulkTypePhoneFinder, bulkID, "found-phones.csv", "valid", ) if err != nil { log.Printf("Warning: Could not save found phones: %v", err) } else { fmt.Println("Found phone numbers saved to found-phones.csv") }`
### Managing Phone Finder Operations[](https://docs.tomba.io/bulks/phone-finder#managing-phone-finder-operations)
Code
`// List all phone finder bulks params := &models.BulkGetParams{ Page: 1, Limit: 15, Direction: "desc", Filter: "all", } bulks, err := client.GetAllPhoneFinderBulks(params) if err != nil { log.Fatal("Failed to get phone finder bulks:", err) } fmt.Printf("Phone Finder Operations:\n") for _, bulk := range bulks.Data { status := "In Progress" if bulk.Status { status = "Completed" } fmt.Printf("- %s (ID: %d)\n", bulk.Name, bulk.BulkID) fmt.Printf(" Status: %s | Progress: %d%% | Processed: %d\n", status, bulk.Progress, bulk.Processed) created := bulk.CreatedAt.Format("2006-01-02 15:04") fmt.Printf(" Created: %s\n", created) fmt.Println() } // Archive old completed operations for _, bulk := range bulks.Data { if bulk.Status && time.Since(bulk.CreatedAt) > 7*24*time.Hour { // 7 days old _, err := client.ArchiveBulk(models.BulkTypePhoneFinder, bulk.BulkID) if err != nil { log.Printf("Failed to archive bulk %d: %v", bulk.BulkID, err) } else { fmt.Printf("Archived old phone finder: %s\n", bulk.Name) } } }`
### Advanced Phone Discovery Workflow[](https://docs.tomba.io/bulks/phone-finder#advanced-phone-discovery-workflow)
Code
``type PhoneDiscoveryResult struct { Source string SourceType string // "email", "website", "linkedin" PhoneNumber string Found bool Country string Type string // "mobile", "landline", etc. } func discoverPhonesFromMixedSources(client *tomba.Tomba, sources []string) ([]PhoneDiscoveryResult, error) { // Step 1: Categorize sources var emails, websites, linkedinURLs []string for _, source := range sources { source = strings.TrimSpace(source) if strings.Contains(source, "@") { emails = append(emails, source) } else if strings.Contains(source, "linkedin.com") { linkedinURLs = append(linkedinURLs, source) } else if strings.HasPrefix(source, "http") { websites = append(websites, source) } } log.Printf("Categorized sources: %d emails, %d websites, %d LinkedIn profiles", len(emails), len(websites), len(linkedinURLs)) var allResults []PhoneDiscoveryResult // Step 2: Process each category separately for better tracking if len(emails) > 0 { results, err := processPhoneDiscoveryBatch(client, emails, "email") if err != nil { log.Printf("Email phone discovery failed: %v", err) } else { allResults = append(allResults, results...) } } if len(websites) > 0 { results, err := processPhoneDiscoveryBatch(client, websites, "website") if err != nil { log.Printf("Website phone discovery failed: %v", err) } else { allResults = append(allResults, results...) } } if len(linkedinURLs) > 0 { results, err := processPhoneDiscoveryBatch(client, linkedinURLs, "linkedin") if err != nil { log.Printf("LinkedIn phone discovery failed: %v", err) } else { allResults = append(allResults, results...) } } return allResults, nil } func processPhoneDiscoveryBatch(client *tomba.Tomba, sources []string, sourceType string) ([]PhoneDiscoveryResult, error) { // Respect the 2,500 limit if len(sources) > 2500 { log.Printf("Warning: Truncating %s sources from %d to 2,500", sourceType, len(sources)) sources = sources[:2500] } // Create batch operation params := &models.BulkCreateParams{ Name: fmt.Sprintf("Phone Discovery - %s sources - %s", strings.Title(sourceType), time.Now().Format("15:04:05")), List: strings.Join(sources, "\n"), Sources: true, Notifie: false, } response, err := client.CreateBulk(models.BulkTypePhoneFinder, params) if err != nil { return nil, fmt.Errorf("failed to create phone finder bulk: %w", err) } bulkID := *response.Data.ID log.Printf("Created %s phone discovery bulk: %d", sourceType, bulkID) // Launch and monitor _, err = client.LaunchBulk(models.BulkTypePhoneFinder, bulkID) if err != nil { return nil, fmt.Errorf("failed to launch bulk: %w", err) } // Wait for completion with timeout timeout := time.After(45 * time.Minute) ticker := time.NewTicker(30 * time.Second) defer ticker.Stop() for { select { case <-timeout: return nil, fmt.Errorf("phone discovery timed out for %s sources", sourceType) case <-ticker.C: progress, err := client.GetBulkProgress(models.BulkTypePhoneFinder, bulkID) if err != nil { log.Printf("Error checking progress: %v", err) continue } if progress.Progress%25 == 0 || progress.Status { log.Printf("%s phone discovery: %d%% (%d processed)", strings.Title(sourceType), progress.Progress, progress.Processed) } if progress.Status { // Parse results return parsePhoneResults(client, bulkID, sourceType) } } } } func parsePhoneResults(client *tomba.Tomba, bulkID int64, sourceType string) ([]PhoneDiscoveryResult, error) { // Download results data, err := client.DownloadBulk(models.BulkTypePhoneFinder, bulkID, &models.BulkDownloadParams{Type: "full"}) if err != nil { return nil, fmt.Errorf("failed to download results: %w", err) } // Parse CSV results (simplified parsing) var results []PhoneDiscoveryResult lines := strings.Split(string(data), "\n") for i, line := range lines { if i == 0 || strings.TrimSpace(line) == "" { continue // Skip header and empty lines } // Simple CSV parsing - use proper CSV parser in production parts := strings.Split(line, ",") if len(parts) >= 2 { result := PhoneDiscoveryResult{ Source: strings.Trim(parts[0], `"`), SourceType: sourceType, Found: false, } if len(parts) > 1 && strings.TrimSpace(parts[1]) != "" { result.PhoneNumber = strings.Trim(parts[1], `"`) result.Found = true } // Extract additional metadata if available if len(parts) > 2 { result.Country = strings.Trim(parts[2], `"`) } if len(parts) > 3 { result.Type = strings.Trim(parts[3], `"`) } results = append(results, result) } } log.Printf("Parsed %d %s phone results (%d found)", len(results), sourceType, countFoundPhones(results)) return results, nil } func countFoundPhones(results []PhoneDiscoveryResult) int { count := 0 for _, result := range results { if result.Found { count++ } } return count } // Complete workflow example func runPhoneDiscoveryCampaign(client *tomba.Tomba, csvPath string) error { // Read sources from CSV file, err := os.Open(csvPath) if err != nil { return fmt.Errorf("failed to open CSV: %w", err) } defer file.Close() reader := csv.NewReader(file) records, err := reader.ReadAll() if err != nil { return fmt.Errorf("failed to read CSV: %w", err) } var sources []string for i, record := range records { if i == 0 || len(record) == 0 { // Skip header and empty rows continue } sources = append(sources, record[0]) } log.Printf("Processing phone discovery for %d sources", len(sources)) // Discover phones results, err := discoverPhonesFromMixedSources(client, sources) if err != nil { return fmt.Errorf("phone discovery failed: %w", err) } // Analyze results totalSources := len(results) phonesFound := countFoundPhones(results) // Group by source type typeStats := make(map[string]struct{ Total, Found int }) for _, result := range results { stats := typeStats[result.SourceType] stats.Total++ if result.Found { stats.Found++ } typeStats[result.SourceType] = stats } // Report results fmt.Printf("\nPhone Discovery Campaign Results:\n") fmt.Printf("Total Sources: %d\n", totalSources) fmt.Printf("Phones Found: %d\n", phonesFound) fmt.Printf("Success Rate: %.1f%%\n", float64(phonesFound)/float64(totalSources)*100) fmt.Printf("\nBreakdown by Source Type:\n") for sourceType, stats := range typeStats { successRate := float64(stats.Found) / float64(stats.Total) * 100 fmt.Printf("- %s: %d/%d (%.1f%%)\n", strings.Title(sourceType), stats.Found, stats.Total, successRate) } // Save consolidated results timestamp := time.Now().Format("20060102-150405") outputFile := fmt.Sprintf("phone-discovery-results-%s.csv", timestamp) return savePhoneResults(results, outputFile) } func savePhoneResults(results []PhoneDiscoveryResult, filename string) error { file, err := os.Create(filename) if err != nil { return err } defer file.Close() writer := csv.NewWriter(file) defer writer.Flush() // Write header writer.Write([]string{"Source", "Source_Type", "Phone_Number", "Found", "Country", "Type"}) // Write results for _, result := range results { writer.Write([]string{ result.Source, result.SourceType, result.PhoneNumber, fmt.Sprintf("%v", result.Found), result.Country, result.Type, }) } log.Printf("Saved phone discovery results to: %s", filename) return nil } // Usage example func main() { client := tomba.NewTomba("your-api-key", "your-secret-key") err := runPhoneDiscoveryCampaign(client, "mixed-sources.csv") if err != nil { log.Fatal("Phone discovery campaign failed:", err) } }``
### CSV File Format Examples[](https://docs.tomba.io/bulks/phone-finder#csv-file-format-examples)
**Mixed Sources**
Code
`source john.doe@example.com https://techcorp.com https://www.linkedin.com/in/jane-smith contact@startup.io https://business.net support@company.org`
**With Source Type Labels**
Code
`source,notes john.doe@example.com,Sales contact https://techcorp.com,website,Company https://www.linkedin.com/in/jane-smith,linkedin,CTO profile contact@startup.io,General inquiry https://business.net/contact,Contact page`
Best Practices[](https://docs.tomba.io/bulks/phone-finder#best-practices)
--------------------------------------------------------------------------
* **Business Focus**: Prioritize business contacts over personal ones
* **Data Quality**: Use verified email addresses and legitimate websites as sources
* **Compliance**: Ensure compliance with telecommunications regulations and privacy laws
* **Multi-Channel Strategy**: Integrate phone data with email and social outreach
* **Regular Updates**: Refresh phone data as contact information changes
* **Source Validation**: Validate input sources before processing
* **Batch Management**: Process sources in manageable batches under 2,500 limit
* **Result Analysis**: Track success rates by source type to optimize strategies
* **Privacy Respect**: Use discovered phone numbers responsibly and ethically
* **Quality Control**: Verify phone numbers before using for outreach campaigns
Last modified on April 27, 2026
[LinkedIn Finder Bulk](https://docs.tomba.io/bulks/linkedin-finder)
[Phone Validator Bulk](https://docs.tomba.io/bulks/phone-validator)
Go
Go
Go
Go
Go
Go
Go
Go
---
# LinkedIn Finder Bulk | Tomba Documentation
Menu
Overview[](https://docs.tomba.io/bulks/linkedin-finder#overview)
-----------------------------------------------------------------
[Bulk Linkedin Finder](https://tomba.io/bulks/linkedin-finder)
allows you to extract email addresses from LinkedIn profile URLs at scale. Transform your LinkedIn prospecting efforts by converting profile links into actionable contact information for direct outreach.
### Key Features[](https://docs.tomba.io/bulks/linkedin-finder#key-features)
* **LinkedIn Integration**: Process LinkedIn profile URLs to find email addresses
* **Bulk Processing**: Handle up to 10,000 LinkedIn URLs per operation
* **Professional Context**: Maintain connection between LinkedIn profiles and email contacts
* **Pattern Matching**: Use LinkedIn data to improve email accuracy
* **Export Capabilities**: Download results with LinkedIn profile associations
### How LinkedIn Finder Bulk Works[](https://docs.tomba.io/bulks/linkedin-finder#how-linkedin-finder-bulk-works)
1. **Collect LinkedIn URLs**: Gather LinkedIn profile URLs from your prospecting activities
2. **Upload URL List**: Provide LinkedIn URLs via text input or file upload
3. **Process Profiles**: Launch the email discovery process
4. **Review Results**: Examine found email addresses with LinkedIn context
5. **Export Data**: Download email addresses linked to LinkedIn profiles
### Limitations[](https://docs.tomba.io/bulks/linkedin-finder#limitations)
* Each Bulk is limited to 10,000 URLs
* Additional rows will be skipped
* Some special or unexpected characters may be deleted in the file
* Invalid URLs won't be imported
* Duplicate URLs won't be imported
Go SDK Integration[](https://docs.tomba.io/bulks/linkedin-finder#go-sdk-integration)
-------------------------------------------------------------------------------------
### Installation[](https://docs.tomba.io/bulks/linkedin-finder#installation)
TerminalCode
`go get github.com/tomba-io/go`
#### Basic Setup[](https://docs.tomba.io/bulks/linkedin-finder#basic-setup)
Code
`package main import ( "fmt" "log" "time" "strings" "github.com/tomba-io/go/tomba" "github.com/tomba-io/go/tomba/models" ) func main() { // Initialize Tomba client client := tomba.NewTomba("your-api-key", "your-secret-key") // Your LinkedIn finder code here }`
### Creating LinkedIn Finder Bulk with URL List[](https://docs.tomba.io/bulks/linkedin-finder#creating-linkedin-finder-bulk-with-url-list)
Code
`// LinkedIn URLs collected from prospecting linkedinURLs := []string{ "https://www.linkedin.com/in/johndoe", "https://www.linkedin.com/in/janesmith", "https://www.linkedin.com/in/mikejohnson", "https://linkedin.com/in/sarahwilson", "https://www.linkedin.com/in/company-ceo", } // Join URLs with newlines for the bulk operation urlList := strings.Join(linkedinURLs, "\n") params := &models.BulkCreateParams{ Name: "LinkedIn Prospects - Tech Industry Q1", List: urlList, Sources: true, // Include sources for context Verify: false, // Skip verification for LinkedIn findings Notifie: true, // Notify when complete } // Create the LinkedIn finder bulk response, err := client.CreateBulk(models.BulkTypeLinkedIn, params) if err != nil { log.Fatal("Failed to create LinkedIn finder bulk:", err) } bulkID := *response.Data.ID fmt.Printf("Created LinkedIn finder bulk with ID: %d\n", bulkID)`
### Creating LinkedIn Finder Bulk from CSV File[](https://docs.tomba.io/bulks/linkedin-finder#creating-linkedin-finder-bulk-from-csv-file)
Code
`// Create LinkedIn finder from CSV containing URLs params := &models.BulkCreateParams{ Name: "Sales Prospects - LinkedIn Discovery", Delimiter: ",", Column: 1, // LinkedIn URL column (1-based index) Sources: true, Notifie: true, } // Upload CSV file with LinkedIn URLs response, err := client.CreateBulkWithFile( models.BulkTypeLinkedIn, params, "/path/to/linkedin-profiles.csv", ) if err != nil { log.Fatal("Failed to create bulk with file:", err) } bulkID := *response.Data.ID fmt.Printf("Created LinkedIn finder bulk: %d\n", bulkID)`
### Single LinkedIn Profile Processing (for comparison)[](https://docs.tomba.io/bulks/linkedin-finder#single-linkedin-profile-processing-for-comparison)
Code
`// Process a single LinkedIn profile linkedinURL := "https://www.linkedin.com/in/example-profile" result, err := client.LinkedinFinder(linkedinURL) if err != nil { log.Printf("Failed to find email for %s: %v", linkedinURL, err) } else { fmt.Printf("LinkedIn Profile: %s\n", linkedinURL) if result.Data.Email != nil { fmt.Printf("Found Email: %s\n", *result.Data.Email) fmt.Printf("Name: %s %s\n", result.Data.FirstName, result.Data.LastName) if result.Data.Position != nil { fmt.Printf("Position: %s\n", *result.Data.Position) } } else { fmt.Println("No email found for this profile") } }`
### Launching and Monitoring LinkedIn Processing[](https://docs.tomba.io/bulks/linkedin-finder#launching-and-monitoring-linkedin-processing)
Code
`// Launch the LinkedIn email discovery launchResponse, err := client.LaunchBulk(models.BulkTypeLinkedIn, bulkID) if err != nil { log.Fatal("Failed to launch LinkedIn finder:", err) } fmt.Println("LinkedIn email discovery started!") // Monitor progress with detailed logging startTime := time.Now() ticker := time.NewTicker(30 * time.Second) defer ticker.Stop() for { progress, err := client.GetBulkProgress(models.BulkTypeLinkedIn, bulkID) if err != nil { log.Printf("Error checking progress: %v", err) time.Sleep(30 * time.Second) continue } elapsed := time.Since(startTime).Round(time.Second) fmt.Printf("LinkedIn processing: %d%% (%d profiles processed) - %v elapsed\n", progress.Progress, progress.Processed, elapsed, ) if progress.Status { fmt.Println("LinkedIn email discovery completed!") break } // LinkedIn processing can be slower, check every 30 seconds time.Sleep(30 * time.Second) }`
### Retrieving LinkedIn Discovery Results[](https://docs.tomba.io/bulks/linkedin-finder#retrieving-linkedin-discovery-results)
Code
`// Get detailed results bulk, err := client.GetBulk(models.BulkTypeLinkedIn, bulkID) if err != nil { log.Fatal("Failed to get bulk details:", err) } bulkInfo := bulk.Data[0] fmt.Printf("LinkedIn Discovery Results:\n") fmt.Printf("- Campaign: %s\n", bulkInfo.Name) fmt.Printf("- Status: %v\n", bulkInfo.Status) fmt.Printf("- Profiles Processed: %d\n", bulkInfo.Processed) if bulkInfo.TotalEmails != nil { fmt.Printf("- Emails Found: %d\n", *bulkInfo.TotalEmails) successRate := float64(*bulkInfo.TotalEmails) / float64(bulkInfo.Processed) * 100 fmt.Printf("- Success Rate: %.1f%%\n", successRate) } // Download all results with LinkedIn context err = client.SaveBulkResults( models.BulkTypeLinkedIn, bulkID, "linkedin-emails.csv", "full", ) if err != nil { log.Fatal("Failed to download results:", err) } fmt.Println("LinkedIn results saved to linkedin-emails.csv")`
### Advanced Processing with URL Validation[](https://docs.tomba.io/bulks/linkedin-finder#advanced-processing-with-url-validation)
Code
`// Validate and process LinkedIn URLs func validateLinkedInURL(url string) bool { url = strings.ToLower(strings.TrimSpace(url)) return strings.Contains(url, "linkedin.com/in/") || strings.Contains(url, "linkedin.com/pub/") } func processLinkedInProspects(client *tomba.Tomba, urls []string) error { // Step 1: Validate URLs var validURLs []string for _, url := range urls { if validateLinkedInURL(url) { validURLs = append(validURLs, url) } else { log.Printf("Skipping invalid URL: %s", url) } } if len(validURLs) == 0 { return fmt.Errorf("no valid LinkedIn URLs found") } fmt.Printf("Processing %d valid LinkedIn URLs\n", len(validURLs)) // Step 2: Create bulk operation params := &models.BulkCreateParams{ Name: fmt.Sprintf("LinkedIn Discovery - %s", time.Now().Format("2006-01-02")), List: strings.Join(validURLs, "\n"), Sources: true, Notifie: true, } response, err := client.CreateBulk(models.BulkTypeLinkedIn, params) if err != nil { return fmt.Errorf("failed to create LinkedIn bulk: %w", err) } bulkID := *response.Data.ID log.Printf("Created LinkedIn bulk: %d", bulkID) // Step 3: Launch and monitor _, err = client.LaunchBulk(models.BulkTypeLinkedIn, bulkID) if err != nil { return fmt.Errorf("failed to launch bulk: %w", err) } // Monitor with timeout and progress tracking timeout := time.After(60 * time.Minute) // LinkedIn processing can take longer ticker := time.NewTicker(45 * time.Second) defer ticker.Stop() startTime := time.Now() for { select { case <-timeout: return fmt.Errorf("LinkedIn processing timed out after 60 minutes") case <-ticker.C: progress, err := client.GetBulkProgress(models.BulkTypeLinkedIn, bulkID) if err != nil { log.Printf("Error checking progress: %v", err) continue } if progress.Progress%25 == 0 || progress.Status { elapsed := time.Since(startTime).Round(time.Second) log.Printf("LinkedIn progress: %d%% (%d/%d) - %v", progress.Progress, progress.Processed, len(validURLs), elapsed) } if progress.Status { // Download and analyze results bulk, err := client.GetBulk(models.BulkTypeLinkedIn, bulkID) if err != nil { return fmt.Errorf("failed to get final results: %w", err) } info := bulk.Data[0] log.Printf("LinkedIn discovery completed!") log.Printf("Total processed: %d", info.Processed) if info.TotalEmails != nil { successRate := float64(*info.TotalEmails) / float64(info.Processed) * 100 log.Printf("Emails found: %d (%.1f%% success rate)", *info.TotalEmails, successRate) } // Save results timestamp := time.Now().Format("20060102-150405") outputFile := fmt.Sprintf("linkedin-results-%s.csv", timestamp) err = client.SaveBulkResults(models.BulkTypeLinkedIn, bulkID, outputFile, "full") if err != nil { return fmt.Errorf("failed to save results: %w", err) } log.Printf("Results saved to: %s", outputFile) return nil } } } }`
### Managing LinkedIn Finder Operations[](https://docs.tomba.io/bulks/linkedin-finder#managing-linkedin-finder-operations)
Code
`// List all LinkedIn finder bulks params := &models.BulkGetParams{ Page: 1, Limit: 10, Direction: "desc", Filter: "all", } bulks, err := client.GetAllLinkedInBulks(params) if err != nil { log.Fatal("Failed to get LinkedIn bulks:", err) } fmt.Printf("LinkedIn Finder Operations:\n") for _, bulk := range bulks.Data { status := "In Progress" if bulk.Status { status = "Completed" } fmt.Printf("- %s (ID: %d)\n", bulk.Name, bulk.BulkID) fmt.Printf(" Status: %s | Progress: %d%% | Processed: %d\n", status, bulk.Progress, bulk.Processed) if bulk.TotalEmails != nil { fmt.Printf(" Emails Found: %d\n", *bulk.TotalEmails) } fmt.Println() } // Clean up old operations for _, bulk := range bulks.Data { if bulk.Status && time.Since(bulk.CreatedAt) > 30*24*time.Hour { // 30 days old _, err := client.ArchiveBulk(models.BulkTypeLinkedIn, bulk.BulkID) if err != nil { log.Printf("Failed to archive bulk %d: %v", bulk.BulkID, err) } else { fmt.Printf("Archived old bulk: %s\n", bulk.Name) } } }`
### Complete LinkedIn Prospecting Workflow[](https://docs.tomba.io/bulks/linkedin-finder#complete-linkedin-prospecting-workflow)
Code
`type LinkedInProspect struct { URL string Email string Name string Position string Company string Found bool } func runLinkedInCampaign(client *tomba.Tomba, csvPath string) ([]LinkedInProspect, error) { // Step 1: Read and validate LinkedIn URLs from CSV file, err := os.Open(csvPath) if err != nil { return nil, fmt.Errorf("failed to open CSV: %w", err) } defer file.Close() reader := csv.NewReader(file) records, err := reader.ReadAll() if err != nil { return nil, fmt.Errorf("failed to read CSV: %w", err) } var validURLs []string for i, record := range records { if i == 0 { // Skip header continue } if len(record) > 0 && validateLinkedInURL(record[0]) { validURLs = append(validURLs, record[0]) } } log.Printf("Found %d valid LinkedIn URLs", len(validURLs)) // Step 2: Process URLs in batches if needed batchSize := 5000 // Process in smaller batches for better management var allResults []LinkedInProspect for i := 0; i < len(validURLs); i += batchSize { end := i + batchSize if end > len(validURLs) { end = len(validURLs) } batchURLs := validURLs[i:end] log.Printf("Processing batch %d/%d (%d URLs)", i/batchSize+1, (len(validURLs)+batchSize-1)/batchSize, len(batchURLs)) batchResults, err := processLinkedInBatch(client, batchURLs) if err != nil { log.Printf("Batch processing failed: %v", err) continue } allResults = append(allResults, batchResults...) // Small delay between batches if end < len(validURLs) { time.Sleep(5 * time.Second) } } return allResults, nil } func processLinkedInBatch(client *tomba.Tomba, urls []string) ([]LinkedInProspect, error) { // Create and process batch params := &models.BulkCreateParams{ Name: fmt.Sprintf("LinkedIn Batch - %s", time.Now().Format("15:04:05")), List: strings.Join(urls, "\n"), Sources: true, Notifie: false, // Don't notify for batches } response, err := client.CreateBulk(models.BulkTypeLinkedIn, params) if err != nil { return nil, err } bulkID := *response.Data.ID // Launch and wait for completion _, err = client.LaunchBulk(models.BulkTypeLinkedIn, bulkID) if err != nil { return nil, err } // Wait for completion for { progress, err := client.GetBulkProgress(models.BulkTypeLinkedIn, bulkID) if err != nil { time.Sleep(30 * time.Second) continue } if progress.Status { break } time.Sleep(30 * time.Second) } // Parse results data, err := client.DownloadBulk(models.BulkTypeLinkedIn, bulkID, &models.BulkDownloadParams{Type: "full"}) if err != nil { return nil, err } // Parse CSV results (simplified - would need proper CSV parsing) var results []LinkedInProspect lines := strings.Split(string(data), "\n") for _, line := range lines[1:] { // Skip header if strings.TrimSpace(line) == "" { continue } // Parse CSV line and create LinkedInProspect // This is simplified - use proper CSV parsing library parts := strings.Split(line, ",") if len(parts) >= 2 { prospect := LinkedInProspect{ URL: parts[0], Email: parts[1], Found: parts[1] != "", } results = append(results, prospect) } } return results, nil } // Usage example func main() { client := tomba.NewTomba("your-api-key", "your-secret-key") results, err := runLinkedInCampaign(client, "linkedin-prospects.csv") if err != nil { log.Fatal("LinkedIn campaign failed:", err) } // Analyze results totalProspects := len(results) emailsFound := 0 for _, prospect := range results { if prospect.Found { emailsFound++ } } fmt.Printf("\nLinkedIn Campaign Summary:\n") fmt.Printf("Total Prospects: %d\n", totalProspects) fmt.Printf("Emails Found: %d\n", emailsFound) fmt.Printf("Success Rate: %.1f%%\n", float64(emailsFound)/float64(totalProspects)*100) }`
### CSV File Format Examples[](https://docs.tomba.io/bulks/linkedin-finder#csv-file-format-examples)
**Simple LinkedIn URL List**
Code
`linkedin_url https://www.linkedin.com/in/johndoe https://www.linkedin.com/in/janesmith https://linkedin.com/in/mikejohnson https://www.linkedin.com/in/sarahconnor`
**With Additional Context**
Code
`linkedin_url,name,company,notes https://www.linkedin.com/in/johndoe,John Doe,Tech Corp,CEO prospect https://www.linkedin.com/in/janesmith,Jane Smith,StartupXYZ,CTO contact https://linkedin.com/in/mikejohnson,Mike Johnson,Enterprise Co,Decision maker`
Best Practices[](https://docs.tomba.io/bulks/linkedin-finder#best-practices)
-----------------------------------------------------------------------------
* **Valid LinkedIn URLs**: Ensure URLs are properly formatted and accessible
* **Profile Quality**: Use complete, professional LinkedIn profiles for better results
* **Compliance**: Respect LinkedIn's terms of service and privacy policies
* **Data Integration**: Connect LinkedIn insights with email outreach strategies
* **Regular Updates**: Refresh data as LinkedIn profiles change
* **Batch Processing**: Process large lists in manageable batches
* **Rate Limiting**: Be mindful of processing limits and API quotas
* **Result Analysis**: Track success rates to optimize prospecting strategies
* **Privacy Considerations**: Ensure compliance with data privacy regulations
* **Quality Control**: Validate found emails before using for outreach
Last modified on April 27, 2026
[Email Verifier Bulk](https://docs.tomba.io/bulks/email-verifier)
[Phone Finder Bulk](https://docs.tomba.io/bulks/phone-finder)
Go
Go
Go
Go
Go
Go
Go
Go
Go
---
# Phone Validator Bulk | Tomba Documentation
Menu
Overview[](https://docs.tomba.io/bulks/phone-validator#overview)
-----------------------------------------------------------------
[Bulks Phone Validator](https://tomba.io/bulks/phone-validator)
verifies phone numbers at scale to ensure accuracy and validity for SMS campaigns, sales calling, and customer communication. Improve contact rates and reduce wasted outreach efforts with comprehensive phone validation.
### Key Features[](https://docs.tomba.io/bulks/phone-validator#key-features)
* **Number Validation**: Verify phone number format, validity, and carrier information
* **Bulk Processing**: Validate up to 2,500 phone numbers per operation
* **Carrier Detection**: Identify mobile vs. landline numbers for appropriate outreach
* **Geographic Information**: Determine location and timezone data for numbers
* **Quality Scoring**: Get detailed validation status for each phone number
* **Export Options**: Download validated numbers with detailed metadata
### How Phone Validator Bulk Works[](https://docs.tomba.io/bulks/phone-validator#how-phone-validator-bulk-works)
1. **Prepare Phone List**: Compile phone numbers requiring validation
2. **Upload Numbers**: Provide phone numbers via CSV file with country information
3. **Configure Validation**: Set validation parameters and quality requirements
4. **Process Validation**: Launch comprehensive phone number verification
5. **Export Results**: Download validated phone lists with quality scores
### Limitations[](https://docs.tomba.io/bulks/phone-validator#limitations)
* Each Bulk is limited to 2,500 phone numbers
* Special or unexpected characters may be removed from your file
* Duplicate and invalid lines will not be imported
Go SDK Integration[](https://docs.tomba.io/bulks/phone-validator#go-sdk-integration)
-------------------------------------------------------------------------------------
### Installation[](https://docs.tomba.io/bulks/phone-validator#installation)
TerminalCode
`go get github.com/tomba-io/go`
### Basic Setup[](https://docs.tomba.io/bulks/phone-validator#basic-setup)
Code
`package main import ( "fmt" "log" "time" "encoding/csv" "os" "github.com/tomba-io/go/tomba" "github.com/tomba-io/go/tomba/models" ) func main() { // Initialize Tomba client client := tomba.NewTomba("your-api-key", "your-secret-key") // Your phone validation code here }`
### Creating Phone Validator Bulk from CSV[](https://docs.tomba.io/bulks/phone-validator#creating-phone-validator-bulk-from-csv)
Code
`// Create phone validator bulk with column mapping params := &models.BulkPhoneValidatorCreateParams{ BulkCreateParams: models.BulkCreateParams{ Name: "Phone Validation - Customer Database", Delimiter: ",", }, BulkPhoneValidatorParams: models.BulkPhoneValidatorParams{ ColumnPhone: 2, // Phone number column (1-based) ColumnCountry: 3, // Country code column (optional but recommended) }, } // Upload CSV and create validation bulk response, err := client.CreatePhoneValidatorBulk(params, "/path/to/phone-list.csv") if err != nil { log.Fatal("Failed to create phone validator bulk:", err) } bulkID := *response.Data.ID fmt.Printf("Created phone validator bulk: %d\n", bulkID)`
### Alternative: Phone Numbers Only CSV[](https://docs.tomba.io/bulks/phone-validator#alternative-phone-numbers-only-csv)
Code
`// When CSV contains only phone numbers without country codes params := &models.BulkPhoneValidatorCreateParams{ BulkCreateParams: models.BulkCreateParams{ Name: "Phone Validation - Simple List", Delimiter: ",", }, BulkPhoneValidatorParams: models.BulkPhoneValidatorParams{ ColumnPhone: 1, // Phone number in first column ColumnCountry: 0, // No country column }, } response, err := client.CreatePhoneValidatorBulk(params, "simple-phone-list.csv") if err != nil { log.Fatal("Failed to create validation bulk:", err) }`
### Launching and Monitoring Validation[](https://docs.tomba.io/bulks/phone-validator#launching-and-monitoring-validation)
Code
`// Launch the validation process launchResponse, err := client.LaunchBulk(models.BulkTypePhoneValidator, bulkID) if err != nil { log.Fatal("Failed to launch phone validation:", err) } fmt.Println("Phone validation started!") // Monitor progress with detailed status startTime := time.Now() for { progress, err := client.GetBulkProgress(models.BulkTypePhoneValidator, bulkID) if err != nil { log.Printf("Error checking progress: %v", err) time.Sleep(20 * time.Second) continue } elapsed := time.Since(startTime).Round(time.Second) fmt.Printf("Validation: %d%% complete (%d processed) - %v elapsed\n", progress.Progress, progress.Processed, elapsed, ) if progress.Status { fmt.Println("Phone validation completed!") break } // Check every 20 seconds (validation is typically faster) time.Sleep(20 * time.Second) }`
### Retrieving Validation Results[](https://docs.tomba.io/bulks/phone-validator#retrieving-validation-results)
Code
`// Get detailed validation results bulk, err := client.GetBulk(models.BulkTypePhoneValidator, bulkID) if err != nil { log.Fatal("Failed to get bulk details:", err) } bulkInfo := bulk.Data[0] fmt.Printf("Validation Summary:\n") fmt.Printf("- Campaign: %s\n", bulkInfo.Name) fmt.Printf("- Status: %v\n", bulkInfo.Status) fmt.Printf("- Numbers Processed: %d\n", bulkInfo.Processed) // Download all validation results err = client.SaveBulkResults( models.BulkTypePhoneValidator, bulkID, "validation-results.csv", "full", ) if err != nil { log.Fatal("Failed to download results:", err) } fmt.Println("Validation results saved to validation-results.csv")`
### Downloading Segmented Results[](https://docs.tomba.io/bulks/phone-validator#downloading-segmented-results)
Code
`// Download only valid phone numbers err = client.SaveBulkResults( models.BulkTypePhoneValidator, bulkID, "valid-phones.csv", "valid", ) if err != nil { log.Printf("Error downloading valid phones: %v", err) } else { fmt.Println("Valid phone numbers saved to valid-phones.csv") } // Download invalid or unverifiable phone numbers err = client.SaveBulkResults( models.BulkTypePhoneValidator, bulkID, "invalid-phones.csv", "not_found", ) if err != nil { log.Printf("Error downloading invalid phones: %v", err) } else { fmt.Println("Invalid phone numbers saved to invalid-phones.csv") }`
### Managing Phone Validator Operations[](https://docs.tomba.io/bulks/phone-validator#managing-phone-validator-operations)
Code
`// List all phone validator bulks params := &models.BulkGetParams{ Page: 1, Limit: 10, Direction: "desc", Filter: "all", } bulks, err := client.GetAllPhoneValidatorBulks(params) if err != nil { log.Fatal("Failed to get phone validator bulks:", err) } fmt.Printf("Phone Validator Operations:\n") for _, bulk := range bulks.Data { status := "In Progress" if bulk.Status { status = "Completed" } fmt.Printf("- %s (ID: %d)\n", bulk.Name, bulk.BulkID) fmt.Printf(" Status: %s | Progress: %d%% | Processed: %d\n", status, bulk.Progress, bulk.Processed) created := bulk.CreatedAt.Format("2006-01-02 15:04") fmt.Printf(" Created: %s\n", created) fmt.Println() } // Rename a validation bulk renameParams := &models.BulkRenameParams{ Name: "Updated Phone Validation Campaign", } _, err = client.RenameBulk(models.BulkTypePhoneValidator, bulkID, renameParams) if err != nil { log.Fatal("Failed to rename bulk:", err) } // Archive completed validation _, err = client.ArchiveBulk(models.BulkTypePhoneValidator, bulkID) if err != nil { log.Fatal("Failed to archive bulk:", err) }`
### Advanced Validation Workflow with Analysis[](https://docs.tomba.io/bulks/phone-validator#advanced-validation-workflow-with-analysis)
Code
``type PhoneValidationResult struct { OriginalNumber string FormattedNumber string Valid bool LineType string // "mobile", "landline", "voip", etc. Carrier string Country string CountryCode string Region string Timezone string Risk string // "low", "medium", "high" } func validatePhoneDatabase(client *tomba.Tomba, csvPath string, phoneCol, countryCol int) (*ValidationSummary, error) { // Step 1: Create validation bulk params := &models.BulkPhoneValidatorCreateParams{ BulkCreateParams: models.BulkCreateParams{ Name: fmt.Sprintf("Phone Validation - %s", time.Now().Format("2006-01-02")), Delimiter: ",", }, BulkPhoneValidatorParams: models.BulkPhoneValidatorParams{ ColumnPhone: phoneCol, ColumnCountry: countryCol, }, } response, err := client.CreatePhoneValidatorBulk(params, csvPath) if err != nil { return nil, fmt.Errorf("failed to create validation bulk: %w", err) } bulkID := *response.Data.ID log.Printf("Created phone validation bulk: %d", bulkID) // Step 2: Launch validation _, err = client.LaunchBulk(models.BulkTypePhoneValidator, bulkID) if err != nil { return nil, fmt.Errorf("failed to launch validation: %w", err) } log.Println("Phone validation in progress...") // Step 3: Monitor with progress tracking timeout := time.After(30 * time.Minute) ticker := time.NewTicker(15 * time.Second) defer ticker.Stop() startTime := time.Now() for { select { case <-timeout: return nil, fmt.Errorf("validation timed out after 30 minutes") case <-ticker.C: progress, err := client.GetBulkProgress(models.BulkTypePhoneValidator, bulkID) if err != nil { log.Printf("Error checking progress: %v", err) continue } if progress.Progress%25 == 0 || progress.Status { elapsed := time.Since(startTime).Round(time.Second) log.Printf("Validation: %d%% (%d processed) - %v", progress.Progress, progress.Processed, elapsed) } if progress.Status { // Step 4: Analyze and download results summary, err := analyzeValidationResults(client, bulkID, startTime) if err != nil { return nil, fmt.Errorf("failed to analyze results: %w", err) } log.Printf("Phone validation completed! %d numbers processed in %v", summary.TotalNumbers, summary.Duration.Round(time.Second)) return summary, nil } } } } func analyzeValidationResults(client *tomba.Tomba, bulkID int64, startTime time.Time) (*ValidationSummary, error) { // Get bulk details bulk, err := client.GetBulk(models.BulkTypePhoneValidator, bulkID) if err != nil { return nil, err } info := bulk.Data[0] // Download and parse results timestamp := time.Now().Format("20060102-150405") allResultsFile := fmt.Sprintf("phone-validation-all-%s.csv", timestamp) validPhonesFile := fmt.Sprintf("phone-validation-valid-%s.csv", timestamp) // Download all results err = client.SaveBulkResults(models.BulkTypePhoneValidator, bulkID, allResultsFile, "full") if err != nil { log.Printf("Warning: Failed to save all results: %v", err) } // Download valid results err = client.SaveBulkResults(models.BulkTypePhoneValidator, bulkID, validPhonesFile, "valid") if err != nil { log.Printf("Warning: Failed to save valid results: %v", err) } // Parse results for analysis results, err := parseValidationResults(allResultsFile) if err != nil { log.Printf("Warning: Could not parse results for analysis: %v", err) results = []PhoneValidationResult{} // Continue with empty results } // Build summary summary := &ValidationSummary{ BulkID: bulkID, Name: info.Name, TotalNumbers: info.Processed, Duration: time.Since(startTime), AllResultsFile: allResultsFile, ValidPhonesFile: validPhonesFile, } // Analyze results if len(results) > 0 { summary.ValidNumbers = countValidNumbers(results) summary.LineTypes = analyzeLineTypes(results) summary.Countries = analyzeCountries(results) summary.Carriers = analyzeCarriers(results) } return summary, nil } func parseValidationResults(filename string) ([]PhoneValidationResult, error) { file, err := os.Open(filename) if err != nil { return nil, err } defer file.Close() reader := csv.NewReader(file) records, err := reader.ReadAll() if err != nil { return nil, err } var results []PhoneValidationResult // Skip header row for i := 1; i < len(records); i++ { record := records[i] if len(record) < 3 { continue } result := PhoneValidationResult{ OriginalNumber: getCSVField(record, 0), Valid: getCSVField(record, 1) == "valid", LineType: getCSVField(record, 2), } // Parse additional fields if available if len(record) > 3 { result.FormattedNumber = getCSVField(record, 3) } if len(record) > 4 { result.Carrier = getCSVField(record, 4) } if len(record) > 5 { result.Country = getCSVField(record, 5) } if len(record) > 6 { result.CountryCode = getCSVField(record, 6) } results = append(results, result) } return results, nil } func getCSVField(record []string, index int) string { if index < len(record) { return strings.Trim(record[index], `"`) } return "" } func countValidNumbers(results []PhoneValidationResult) int { count := 0 for _, result := range results { if result.Valid { count++ } } return count } func analyzeLineTypes(results []PhoneValidationResult) map[string]int { types := make(map[string]int) for _, result := range results { if result.Valid && result.LineType != "" { types[result.LineType]++ } } return types } func analyzeCountries(results []PhoneValidationResult) map[string]int { countries := make(map[string]int) for _, result := range results { if result.Valid && result.Country != "" { countries[result.Country]++ } } return countries } func analyzeCarriers(results []PhoneValidationResult) map[string]int { carriers := make(map[string]int) for _, result := range results { if result.Valid && result.Carrier != "" { carriers[result.Carrier]++ } } return carriers } // Summary structure for validation results type ValidationSummary struct { BulkID int64 Name string TotalNumbers int ValidNumbers int Duration time.Duration AllResultsFile string ValidPhonesFile string LineTypes map[string]int Countries map[string]int Carriers map[string]int } func (s *ValidationSummary) String() string { validRate := float64(s.ValidNumbers) / float64(s.TotalNumbers) * 100 result := fmt.Sprintf(` Phone Validation Summary: - Bulk ID: %d - Name: %s - Total Numbers: %d - Valid Numbers: %d (%.1f%%) - Duration: %v - All Results: %s - Valid Only: %s`, s.BulkID, s.Name, s.TotalNumbers, s.ValidNumbers, validRate, s.Duration.Round(time.Second), s.AllResultsFile, s.ValidPhonesFile) if len(s.LineTypes) > 0 { result += "\n\nLine Type Distribution:" for lineType, count := range s.LineTypes { percent := float64(count) / float64(s.ValidNumbers) * 100 result += fmt.Sprintf("\n- %s: %d (%.1f%%)", lineType, count, percent) } } if len(s.Countries) > 0 { result += "\n\nTop Countries:" // Show top 5 countries type countryCount struct { country string count int } var sorted []countryCount for country, count := range s.Countries { sorted = append(sorted, countryCount{country, count}) } // Simple sort by count (descending) for i := 0; i < len(sorted)-1; i++ { for j := 0; j < len(sorted)-i-1; j++ { if sorted[j].count < sorted[j+1].count { sorted[j], sorted[j+1] = sorted[j+1], sorted[j] } } } for i, cc := range sorted { if i >= 5 { // Top 5 only break } percent := float64(cc.count) / float64(s.ValidNumbers) * 100 result += fmt.Sprintf("\n- %s: %d (%.1f%%)", cc.country, cc.count, percent) } } return result } // Usage example func main() { client := tomba.NewTomba("your-api-key", "your-secret-key") // Validate phone database summary, err := validatePhoneDatabase(client, "phone-database.csv", 2, 3) if err != nil { log.Fatal("Phone validation failed:", err) } fmt.Println(summary) }``
### CSV File Format Examples[](https://docs.tomba.io/bulks/phone-validator#csv-file-format-examples)
**With Country Codes**
Code
`name,phone,country John Doe,+1-555-0123,US Jane Smith,+44-20-7123-4567,GB Pierre Martin,+33-1-23-45-67-89,FR Maria Garcia,+34-91-123-4567,ES`
**Phone Numbers Only**
Code
`phone +1-555-0123 +44-20-7123-4567 +33-1-23-45-67-89 +34-91-123-4567 555-0123`
**With Additional Context**
Code
`customer_id,name,phone,country,source 12345,John Doe,+1-555-0123,US,Website 12346,Jane Smith,+44-20-7123-4567,GB,CRM Import 12347,Pierre Martin,+33-1-23-45-67-89,FR,Lead Gen`
Best Practices[](https://docs.tomba.io/bulks/phone-validator#best-practices)
-----------------------------------------------------------------------------
* **Consistent Formatting**: Use consistent international phone number formatting
* **Country Information**: Include country codes or country columns for accurate validation
* **Regular Validation**: Validate phone lists regularly to maintain quality
* **Campaign Optimization**: Use validation results to improve calling and SMS campaigns
* **Compliance Checking**: Verify numbers comply with local telecommunications regulations
* **Batch Processing**: Process large lists in batches under 2,500 limit
* **Result Segmentation**: Separate valid, invalid, and risky numbers for targeted use
* **Quality Thresholds**: Set validation quality standards based on use case
* **Data Privacy**: Ensure phone validation complies with privacy regulations
* **Cost Optimization**: Track validation costs and optimize processing efficiency
Last modified on April 27, 2026
[Phone Finder Bulk](https://docs.tomba.io/bulks/phone-finder)
[Similar Domain Bulk](https://docs.tomba.io/bulks/similar)
Go
Go
Go
Go
Go
Go
Go
Go
---
# 95% Delivery Guarantee - Email Finder | Tomba Documentation
Menu
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[](https://docs.tomba.io/email-finder-delivery-guarantee#what-our-95-delivery-guarantee-covers)
--------------------------------------------------------------------------------------------------------------------------------------
### Scope of Guarantee[](https://docs.tomba.io/email-finder-delivery-guarantee#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[](https://docs.tomba.io/email-finder-delivery-guarantee#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[](https://docs.tomba.io/email-finder-delivery-guarantee#how-we-achieve-95-deliverability)
----------------------------------------------------------------------------------------------------------------------------
### Advanced Discovery Methods[](https://docs.tomba.io/email-finder-delivery-guarantee#advanced-discovery-methods)
#### 1\. **Multi-Source Verification**[](https://docs.tomba.io/email-finder-delivery-guarantee#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**[](https://docs.tomba.io/email-finder-delivery-guarantee#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**[](https://docs.tomba.io/email-finder-delivery-guarantee#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[](https://docs.tomba.io/email-finder-delivery-guarantee#quality-assurance-process)
#### Pre-Discovery Filtering[](https://docs.tomba.io/email-finder-delivery-guarantee#pre-discovery-filtering)
* Domain reputation analysis
* Company legitimacy verification
* Public data source validation
* Pattern reliability assessment
#### Post-Discovery Verification[](https://docs.tomba.io/email-finder-delivery-guarantee#post-discovery-verification)
* Comprehensive deliverability testing
* Format validation and standardization
* Duplicate detection and removal
* Confidence score calculation
* * *
Confidence Scoring System[](https://docs.tomba.io/email-finder-delivery-guarantee#confidence-scoring-system)
-------------------------------------------------------------------------------------------------------------
Every email discovered through our Email Finder includes a confidence score that indicates delivery probability:
### Score Ranges[](https://docs.tomba.io/email-finder-delivery-guarantee#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[](https://docs.tomba.io/email-finder-delivery-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[](https://docs.tomba.io/email-finder-delivery-guarantee#guarantee-terms-and-conditions)
-----------------------------------------------------------------------------------------------------------------------
### Eligibility Requirements[](https://docs.tomba.io/email-finder-delivery-guarantee#eligibility-requirements)
#### Qualifying Usage[](https://docs.tomba.io/email-finder-delivery-guarantee#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[](https://docs.tomba.io/email-finder-delivery-guarantee#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[](https://docs.tomba.io/email-finder-delivery-guarantee#measurement-criteria)
#### Delivery Success Metrics[](https://docs.tomba.io/email-finder-delivery-guarantee#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[](https://docs.tomba.io/email-finder-delivery-guarantee#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[](https://docs.tomba.io/email-finder-delivery-guarantee#claim-process)
-------------------------------------------------------------------------------------
### When to File a Claim[](https://docs.tomba.io/email-finder-delivery-guarantee#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[](https://docs.tomba.io/email-finder-delivery-guarantee#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[](https://docs.tomba.io/email-finder-delivery-guarantee#claim-submission-process)
#### Step 1: Gather Evidence[](https://docs.tomba.io/email-finder-delivery-guarantee#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[](https://docs.tomba.io/email-finder-delivery-guarantee#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[](https://docs.tomba.io/email-finder-delivery-guarantee#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[](https://docs.tomba.io/email-finder-delivery-guarantee#remedies-and-compensation)
-------------------------------------------------------------------------------------------------------------
### Available Remedies[](https://docs.tomba.io/email-finder-delivery-guarantee#available-remedies)
#### Service Credits[](https://docs.tomba.io/email-finder-delivery-guarantee#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[](https://docs.tomba.io/email-finder-delivery-guarantee#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[](https://docs.tomba.io/email-finder-delivery-guarantee#account-optimization)
* Personal consultation on delivery best practices
* Email authentication setup assistance
* Sender reputation improvement guidance
* Custom integration support
### Credit Calculation[](https://docs.tomba.io/email-finder-delivery-guarantee#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[](https://docs.tomba.io/email-finder-delivery-guarantee#best-practices-for-maximum-deliverability)
---------------------------------------------------------------------------------------------------------------------------------------------
### Email Discovery Optimization[](https://docs.tomba.io/email-finder-delivery-guarantee#email-discovery-optimization)
#### Target Quality Sources[](https://docs.tomba.io/email-finder-delivery-guarantee#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[](https://docs.tomba.io/email-finder-delivery-guarantee#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[](https://docs.tomba.io/email-finder-delivery-guarantee#sending-best-practices)
#### Technical Setup[](https://docs.tomba.io/email-finder-delivery-guarantee#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[](https://docs.tomba.io/email-finder-delivery-guarantee#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[](https://docs.tomba.io/email-finder-delivery-guarantee#monitoring-and-reporting)
-----------------------------------------------------------------------------------------------------------
### Delivery Analytics[](https://docs.tomba.io/email-finder-delivery-guarantee#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[](https://docs.tomba.io/email-finder-delivery-guarantee#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[](https://docs.tomba.io/email-finder-delivery-guarantee#technical-support)
---------------------------------------------------------------------------------------------
### Guarantee Support Team[](https://docs.tomba.io/email-finder-delivery-guarantee#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[](https://docs.tomba.io/email-finder-delivery-guarantee#contact-information)
* **Guarantee Claims**: [info@tomba.io](mailto:info@tomba.io)
* **Technical Support**: [support@tomba.io](mailto:support@tomba.io)
* * *
Frequently Asked Questions[](https://docs.tomba.io/email-finder-delivery-guarantee#frequently-asked-questions)
---------------------------------------------------------------------------------------------------------------
### Q: What happens if my delivery rate is exactly 95%?[](https://docs.tomba.io/email-finder-delivery-guarantee#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?[](https://docs.tomba.io/email-finder-delivery-guarantee#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?[](https://docs.tomba.io/email-finder-delivery-guarantee#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?[](https://docs.tomba.io/email-finder-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.
Last modified on September 29, 2025
[Anti-Spam Policy](https://docs.tomba.io/anti-spam-policy)
[98% Delivery Guarantee - Email Verifier](https://docs.tomba.io/email-verifier-delivery-guarantee)
---
# Person Attributes | Tomba Documentation
Menu
These attributes represent personal and professional details for an individual, as returned by Tomba's enrichment services.
* * *
Basic Details[](https://docs.tomba.io/attributes/person#basic-details)
-----------------------------------------------------------------------
| Attribute | Description | Example |
| --- | --- | --- |
| `email` | The person's email address | [m@wordpress.org](mailto:m@wordpress.org) |
| `first_name` | The person’s first name | Matt |
| `last_name` | The person’s last name | Mullenweg |
| `full_name` | The complete name | Matt Mullenweg |
| `gender` | Gender of the individual | male |
| `phone_number` | Phone number if available (`false` if not) | false |
| `type` | Classification type (generic, personal) | generic |
| `country` | Country of the individual | US |
| `score` | Confidence score (0–100) | 99 |
* * *
Professional Role[](https://docs.tomba.io/attributes/person#professional-role)
-------------------------------------------------------------------------------
| Attribute | Description | Example |
| --- | --- | --- |
| `position` | Job title or role | CEO |
| `department` | Department the person belongs to | executive |
| `seniority` | Seniority level | senior |
* * *
Social Profiles[](https://docs.tomba.io/attributes/person#social-profiles)
---------------------------------------------------------------------------
| Attribute | Description | Example |
| --- | --- | --- |
| `linkedin` | LinkedIn profile URL | [https://www.linkedin.com/in/mattm](https://www.linkedin.com/in/mattm) |
| `twitter` | Twitter handle or URL | null |
* * *
Verification[](https://docs.tomba.io/attributes/person#verification)
---------------------------------------------------------------------
| Attribute | Description | Example |
| --- | --- | --- |
| `verification.date` | Date of last successful verification | 2021-05-25T00:00:00+02:00 |
| `verification.status` | Status of the most recent verification | valid |
* * *
Note: Fields may return `false` or `null` when data is unavailable.
Email Type Attribute[](https://docs.tomba.io/attributes/person#email-type-attribute)
-------------------------------------------------------------------------------------
The `type` field defines the nature of the email address based on the role or naming pattern used. It helps distinguish between direct contacts and role-based addresses.
* * *
### Available Values[](https://docs.tomba.io/attributes/person#available-values)
| Value | Description |
| --- | --- |
| `personal` | The email address belongs to a specific individual (for example, [john@company.com](mailto:john@company.com)
`
Rendered results for `tomba.io`:
| `?s=48` | `?s=80` (default) | `?s=128` | `?s=128&greyscale=true` |
| --- | --- | --- | --- |
|  |  |  |  |
**Response Headers:**
| Header | Description |
| --- | --- |
| `Content-Type` | Image MIME type (`image/png`, `image/webp`, etc.) |
| `Content-Disposition` | `attachment; filename="domain.ext"` |
| `Cache-Control` | `public, max-age=86400` (24h for logos, 5min for defaults) |
| `X-Cache` | `hit` or `miss` (in-memory cache status) |
**Response:**
| Status | Description |
| --- | --- |
| 200 | Logo image with `Content-Type: image/png\|webp\|avif` |
| 400 | Invalid domain or invalid size parameter |
Default Image[](https://docs.tomba.io/logo-api#default-image)
--------------------------------------------------------------
When a domain has no matching Tomba logo, a default placeholder image is returned instead of a 404 error. The default image is a gray square with a "?" mark, sized according to the `s`/`size` parameter (or 80x80 by default).
If you'd prefer to use your own default image, supply the URL in the `d=` or `default=` parameter. The URL should be URL-encoded to ensure that it carries across correctly. When a custom default is provided and the logo is not found, the API proxies the image from your URL.
TerminalCode
`# Custom default image curl "https://logo.tomba.io/unknown.com?d=https%3A%2F%2Fexample.com%2Fimages%2Favatar.jpg" # Using default= alias curl "https://logo.tomba.io/unknown.com?default=https%3A%2F%2Fexample.com%2Flogo.png"`
Only `https` URLs are accepted. Invalid URLs return a `400 Bad Request`.
Examples[](https://docs.tomba.io/logo-api#examples)
----------------------------------------------------
TerminalCode
`# Default size (80x80) curl -O https://logo.tomba.io/zynga.com # Custom size (200x200) curl -O "https://logo.tomba.io/stripe.com?s=200" # Using size= alias curl -O "https://logo.tomba.io/google.com?size=128" # Greyscale curl -O "https://logo.tomba.io/zynga.com?greyscale=true" # Greyscale with custom size curl -O "https://logo.tomba.io/stripe.com?s=128&greyscale=true" # Subdomain resolves to root domain curl -O https://logo.tomba.io/www.google.com # Unknown domain returns default placeholder curl -O https://logo.tomba.io/unknown-domain.com`
Last modified on July 10, 2026
[Webhooks](https://docs.tomba.io/webhook)
[Official Language Libraries](https://docs.tomba.io/libraries)
---
# January 2026 Data Update | Tomba Documentation
Menu
We processed hundreds of millions of records to maintain fresh, accurate, and complete datasets.
Here's what changed this month:
* * *
Data Updates[](https://docs.tomba.io/data/2026/01-january#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[](https://docs.tomba.io/data/2026/01-january#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[](https://docs.tomba.io/data/2026/01-january#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[](https://docs.tomba.io/data/2026/01-january#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[](https://docs.tomba.io/data/2026/01-january#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[](https://docs.tomba.io/data/2026/01-january#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[](https://docs.tomba.io/data/2026/01-january#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)[](https://docs.tomba.io/data/2026/01-january#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[](https://docs.tomba.io/data/2026/01-january#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
Last modified on January 8, 2026
[February 2026 Data Update](https://docs.tomba.io/data/2026/02-february)
[October Data Update](https://docs.tomba.io/data/2025/01-october)
---
# Key Features and Endpoints | Tomba Documentation
Menu
Tomba.io provides a robust set of API endpoints for email discovery, enrichment, and lead generation workflows. Below is an overview of the main features, with short descriptions and direct links.
* * *
[Account Information](https://app.tomba.io/settings/)
[](https://docs.tomba.io/features#account-information)
-------------------------------------------------------------------------------------------------------------
**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)
[](https://docs.tomba.io/features#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)
[](https://docs.tomba.io/features#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.
Quick API example:
TerminalCode
`curl -X GET "https://api.tomba.io/v1/email-finder?domain=example.com&first_name=John&last_name=Doe" \ -H "X-Tomba-Key: your_api_key" \ -H "X-Tomba-Secret: your_secret_key"`
* * *
[Email Enrichment](https://tomba.io/enrichment)
[](https://docs.tomba.io/features#email-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)
[](https://docs.tomba.io/features#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)
[](https://docs.tomba.io/features#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)
[](https://docs.tomba.io/features#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)
[](https://docs.tomba.io/features#email-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)
[](https://docs.tomba.io/features#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)
[](https://docs.tomba.io/features#usage-stats)
-----------------------------------------------------------------------------------------
**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)
[](https://docs.tomba.io/features#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)
[](https://docs.tomba.io/features#lead-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[](https://docs.tomba.io/features#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)
[](https://docs.tomba.io/features#account-logs)
----------------------------------------------------------------------------------------------------
**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)
[](https://docs.tomba.io/features#api-keys)
---------------------------------------------------------------------------------
**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)
[](https://docs.tomba.io/features#email-count)
---------------------------------------------------------------------------------------------
**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](https://docs.tomba.io/api/~endpoints#technology)
[](https://docs.tomba.io/features#technology-detection)
--------------------------------------------------------------------------------------------------------------------------------
**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](https://docs.tomba.io/api/~endpoints#similar)
[](https://docs.tomba.io/features#similar-websites)
---------------------------------------------------------------------------------------------------------------------
**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 endpoint includes request parameters, examples, and responses in our [API Reference Documentation](https://docs.tomba.io/api)
.
Last modified on April 28, 2026
[Rate Limits](https://docs.tomba.io/rate-limits)
[Data](https://docs.tomba.io/data)
---
# Migrate to Tomba Email Finder | Tomba Documentation
Menu
Looking to switch from your current email finder service? This guide will help you migrate to Tomba's comprehensive email finding platform with better accuracy, more data points, and competitive pricing.
* * *
Why Choose Tomba Email Finder?[](https://docs.tomba.io/migration/email-finder/introduction#why-choose-tomba-email-finder)
--------------------------------------------------------------------------------------------------------------------------
| Feature | Hunter / Snov / Prospeo / Findymail | Tomba |
| --- | --- | --- |
| **Accuracy** | 85-92% | 98%+ with verification included |
| **Database Size** | 100M-200M emails | 450M+ emails and growing |
| **Data Attributes** | 5-8 fields | 20+ comprehensive attributes |
| **Email Verification** | Separate cost or limited | Included free with every search |
| **Domain Search** | Yes | Yes, with advanced filters |
| **Author Finder** | No | Find emails from article URLs |
| **LinkedIn Finder** | Limited | Direct LinkedIn profile to email |
| **Phone Numbers** | No | Phone Finder & Phone Validator included |
| **Technology Detection** | No | Detect tech stack (6000+ technologies) |
| **Similar Companies** | No | Find similar companies to expand reach |
| **Email Enrichment** | Basic | Complete contact and company data |
| **Bulk Operations** | Yes | Yes, with better processing |
| **API Access** | REST API | REST API + MCP integration |
| **Pricing** | $49-199/month | From $49/month (40% more affordable) |
* * *
Key Advantages of Tomba[](https://docs.tomba.io/migration/email-finder/introduction#key-advantages-of-tomba)
-------------------------------------------------------------------------------------------------------------
### 1\. All-in-One Platform[](https://docs.tomba.io/migration/email-finder/introduction#1-all-in-one-platform)
Unlike competitors that require multiple tools, Tomba provides:
* **Email Finder**: Find emails by name + domain
* **Domain Search**: Discover all emails at a company
* **Email Verifier**: Verify deliverability (included free!)
* **Author Finder**: Extract author emails from articles
* **LinkedIn Finder**: Find emails from LinkedIn profiles
* **Phone Finder**: Get phone numbers for contacts
* **Phone Validator**: Validate phone number format and location
* **Email Enrichment**: Complete contact data
* **Technology Finder**: Detect tech stacks (6000+ technologies)
* **Similar Companies**: Expand your target list
**One API key. One dashboard. One bill.**
### 2\. Free Email Verification[](https://docs.tomba.io/migration/email-finder/introduction#2-free-email-verification)
Every email found is automatically verified at no extra cost:
* Deliverability check
* SMTP validation
* MX record verification
* Disposable email detection
* Role-based email detection
**Competitors charge separately** for verification or provide limited checks.
### 3\. Rich Data Attributes (20+ Fields)[](https://docs.tomba.io/migration/email-finder/introduction#3-rich-data-attributes-20-fields)
Tomba provides comprehensive contact data:
**Person Data:**
* Full name (first, last)
* Position/title
* Department
* Seniority level
* Email address (verified)
* Phone numbers
* LinkedIn profile
* Twitter handle
* Social profiles
**Company Data:**
* Company name
* Domain/website
* Industry
* Size (employees)
* Location (country, city)
* Founded year
* Revenue
* Technology stack
* Social profiles
**Email Intelligence:**
* Verification status
* Confidence score (0-100)
* Sources (URLs where found)
* Last verified date
* Email type (generic, personal)
* Accept-all status
### 4\. Better Pricing (Save 40-50%)[](https://docs.tomba.io/migration/email-finder/introduction#4-better-pricing-save-40-50)
**Hunter pricing:** $49-199/month + extra for verification **Snov.io pricing:** $39-189/month + credit system **Prospeo pricing:** $119/month + limited searches **Findymail pricing:** $49-999/month
**Tomba pricing:** From $49/month
* All features included
* Free verification
* No hidden costs
* Credits roll over
* Volume discounts available
### 5\. Advanced Features[](https://docs.tomba.io/migration/email-finder/introduction#5-advanced-features)
* **Model Context Protocol (MCP)**: AI tool integration
* **Chrome Extension**: Find emails while browsing
* **Google Sheets Add-on**: Bulk find in spreadsheets
* **Microsoft Excel Add-in**: Find and verify emails directly in Excel
* **Airtable Extension**: Find and verify email addresses directly in Airtable
* **Bulk API**: Process thousands of emails
* **Zapier/n8n**: Workflow automation
* **10+ Official SDKs**: Easy integration
* * *
Quick Start Migration[](https://docs.tomba.io/migration/email-finder/introduction#quick-start-migration)
---------------------------------------------------------------------------------------------------------
### Step 1: Sign Up[](https://docs.tomba.io/migration/email-finder/introduction#step-1-sign-up)
Create your Tomba account at [app.tomba.io](https://app.tomba.io/)
### Step 2: Get API Credentials[](https://docs.tomba.io/migration/email-finder/introduction#step-2-get-api-credentials)
1. Navigate to **API** → **API Keys**
2. Copy your **API Key** and **Secret Key**
### Step 3: Update Your Code[](https://docs.tomba.io/migration/email-finder/introduction#step-3-update-your-code)
**Generic example (any competitor):**
Code
``// Before (Hunter/Snov/Prospeo/Findymail) const response = await axios.get("https://competitor-api.com/v2/email-finder", { params: { domain: "stripe.com", first_name: "John", last_name: "Doe", }, headers: { Authorization: `Bearer ${API_KEY}` }, }); // After (Tomba) const response = await axios.get("https://api.tomba.io/v1/email-finder", { params: { domain: "stripe.com", first_name: "John", last_name: "Doe", }, headers: { "X-Tomba-Key": TOMBA_KEY, "X-Tomba-Secret": TOMBA_SECRET, }, }); // Tomba response includes verification for free! const email = response.data.data.email; // "john.doe@stripe.com" const verified = response.data.data.verification.status; // "valid" const score = response.data.data.score; // 95``
### Step 4: Explore Additional Features[](https://docs.tomba.io/migration/email-finder/introduction#step-4-explore-additional-features)
Code
`// Author Finder (unique to Tomba) const author = await axios.get("https://api.tomba.io/v1/author-finder", { params: { url: "https://blog.stripe.com/article" }, headers: { "X-Tomba-Key": KEY, "X-Tomba-Secret": SECRET }, }); // LinkedIn Finder (unique to Tomba) const linkedin = await axios.get("https://api.tomba.io/v1/linkedin", { params: { url: "https://linkedin.com/in/johndoe" }, headers: { "X-Tomba-Key": KEY, "X-Tomba-Secret": SECRET }, }); // Technology Detection (unique to Tomba) const tech = await axios.get("https://api.tomba.io/v1/technology", { params: { domain: "stripe.com" }, headers: { "X-Tomba-Key": KEY, "X-Tomba-Secret": SECRET }, });`
* * *
Service-Specific Migration Guides[](https://docs.tomba.io/migration/email-finder/introduction#service-specific-migration-guides)
---------------------------------------------------------------------------------------------------------------------------------
Choose your current provider for detailed migration instructions:
### From Hunter[](https://docs.tomba.io/migration/email-finder/introduction#from-hunter)
* [Hunter Email Finder Migration Guide](https://docs.tomba.io/migration/email-finder/hunter)
* Complete API mapping and code examples
* Hunter Credits → Tomba Credits conversion
* Advanced feature comparison
### From Snov.io[](https://docs.tomba.io/migration/email-finder/introduction#from-snovio)
* [Snov.io Migration Guide](https://docs.tomba.io/migration/email-finder/snov)
* Drip campaign alternative strategies
* API endpoint mapping
* Bulk operation migration
### From Prospeo[](https://docs.tomba.io/migration/email-finder/introduction#from-prospeo)
* [Prospeo Migration Guide](https://docs.tomba.io/migration/email-finder/prospeo)
* LinkedIn export migration
* Credit system comparison
* Bulk verification migration
### From Findymail[](https://docs.tomba.io/migration/email-finder/introduction#from-findymail)
* [Findymail Migration Guide](https://docs.tomba.io/migration/email-finder/findymail)
* Waterfall enrichment alternative
* API comparison and mapping
* Cost savings calculator
* * *
Feature Comparison Matrix[](https://docs.tomba.io/migration/email-finder/introduction#feature-comparison-matrix)
-----------------------------------------------------------------------------------------------------------------
| Feature | Hunter | Snov.io | Prospeo | Findymail | Tomba |
| --- | --- | --- | --- | --- | --- |
| **Email Finder** | ✅ | ✅ | ✅ | ✅ | ✅ |
| **Domain Search** | ✅ | ✅ | ✅ | ✅ | ✅ |
| **Email Verification** | 💰 Paid extra | 💰 Limited | 💰 Paid extra | ✅ | ✅ Free |
| **Author Finder** | ❌ | ❌ | ❌ | ❌ | ✅ |
| **LinkedIn Finder** | ❌ | ⚠️ Limited | ✅ | ✅ | ✅ |
| **Phone Finder** | ❌ | ❌ | ❌ | ⚠️ Limited | ✅ |
| **Technology Detection** | ❌ | ❌ | ❌ | ❌ | ✅ |
| **Similar Companies** | ❌ | ❌ | ❌ | ❌ | ✅ |
| **Email Enrichment** | ⚠️ Basic | ⚠️ Basic | ⚠️ Basic | ✅ | ✅ |
| **Bulk Operations** | ✅ | ✅ | ✅ | ✅ | ✅ |
| **Chrome Extension** | ✅ | ✅ | ✅ | ✅ | ✅ |
| **Google Sheets** | ✅ | ✅ | ❌ | ❌ | ✅ |
| **Excel Add-in** | ❌ | ❌ | ❌ | ❌ | ✅ |
| **Airtable Extension** | ❌ | ❌ | ❌ | ❌ | ✅ |
| **Bulk API** | ⚠️ Limited | ✅ | ⚠️ Limited | ✅ | ✅ |
| **MCP/AI Integration** | ❌ | ❌ | ❌ | ❌ | ✅ |
| **Database Size** | 200M | 150M | 100M | 250M | 450M+ |
| **Accuracy** | 85-90% | 85-88% | 87-92% | 90-95% | 98%+ |
| **Starting Price** | $49/mo | $39/mo | $119/mo | $49/mo | $49/mo |
Legend: ✅ Full support | ⚠️ Limited | ❌ Not available | 💰 Additional cost
* * *
Common Migration Questions[](https://docs.tomba.io/migration/email-finder/introduction#common-migration-questions)
-------------------------------------------------------------------------------------------------------------------
### Q: Will I lose any data during migration?[](https://docs.tomba.io/migration/email-finder/introduction#q-will-i-lose-any-data-during-migration)
**A:** No. You can run Tomba alongside your current service during testing. Export your existing data and gradually transition workflows.
### Q: How long does migration take?[](https://docs.tomba.io/migration/email-finder/introduction#q-how-long-does-migration-take)
**A:** Most teams complete migration in 1-3 days:
* Day 1: Account setup, API integration, testing
* Day 2: Bulk operations migration, workflow updates
* Day 3: Team training, full production deployment
### Q: What about my existing credits?[](https://docs.tomba.io/migration/email-finder/introduction#q-what-about-my-existing-credits)
**A:** Use remaining credits with your current provider while gradually shifting to Tomba. We offer flexible plans to match your needs.
### Q: Can I import my saved searches/campaigns?[](https://docs.tomba.io/migration/email-finder/introduction#q-can-i-import-my-saved-searchescampaigns)
**A:** Yes! Tomba supports bulk imports via CSV or API. Our team can help migrate large datasets for enterprise customers.
### Q: Do you offer migration assistance?[](https://docs.tomba.io/migration/email-finder/introduction#q-do-you-offer-migration-assistance)
**A:** Yes! We provide:
* Free migration consultation
* API integration support
* Code review and optimization
* Bulk data migration help (enterprise)
* Dedicated onboarding for teams
### Q: What if Tomba doesn't have a feature I need?[](https://docs.tomba.io/migration/email-finder/introduction#q-what-if-tomba-doesnt-have-a-feature-i-need)
**A:** Contact us! We actively develop based on customer feedback. Many features were built from user requests.
* * *
Next Steps[](https://docs.tomba.io/migration/email-finder/introduction#next-steps)
-----------------------------------------------------------------------------------
1. **Choose your migration guide** from the list above
2. **Sign up** at [app.tomba.io](https://app.tomba.io/)
3. **Test in parallel** with your current service
4. **Compare results** (accuracy, speed, data quality)
5. **Migrate workflows** gradually
6. **Train your team** on new features
7. **Cancel old service** and enjoy savings!
* * *
Support and Resources[](https://docs.tomba.io/migration/email-finder/introduction#support-and-resources)
---------------------------------------------------------------------------------------------------------
* [Tomba API Documentation](https://docs.tomba.io/)
* [Email Finder API](https://docs.tomba.io/api#tag/Email-Finder)
* [Domain Search API](https://docs.tomba.io/api#tag/Domain-Search)
* [SDKs and Libraries](https://docs.tomba.io/libraries)
* [Chrome Extension](https://chrome.google.com/webstore/detail/tomba-email-finder/icmjegjggphchjckknoooajmklibccjb)
* [Support Portal](https://help.tomba.io/)
* [Live Chat](https://app.tomba.io/)
- Available in dashboard
Need personalized migration assistance? [Contact our team](https://app.tomba.io/contact)
for dedicated support.
Last modified on April 28, 2026
[Migrate from Hunter to Tomba](https://docs.tomba.io/migration/email-verifier/hunter)
[Migrate from Hunter Email Finder to Tomba](https://docs.tomba.io/migration/email-finder/hunter)
Javascript
Javascript
---
# Migrate from Prospeo to Tomba Email Finder | Tomba Documentation
Menu
Switch from Prospeo to Tomba for a larger database, better pricing, free verification, and more features.
* * *
Why Switch from Prospeo to Tomba?[](https://docs.tomba.io/migration/email-finder/prospeo#why-switch-from-prospeo-to-tomba)
---------------------------------------------------------------------------------------------------------------------------
| Feature | Prospeo | Tomba |
| --- | --- | --- |
| **Database Size** | 100M emails | 450M+ emails (5x larger) |
| **Accuracy** | 87-92% | 98%+ |
| **Email Verification** | Paid extra | FREE with every search |
| **Data Attributes** | 6-8 fields | 20+ fields |
| **LinkedIn Export** | ✅ | ✅ Better |
| **Author Finder** | ❌ | ✅ |
| **Phone Finder** | ❌ | ✅ Finder & Validator |
| **Technology Detection** | ❌ | ✅ 6000+ techs |
| **Similar Companies** | ❌ | ✅ |
| **Chrome Extension** | ✅ | ✅ Enhanced |
| **Google Sheets** | ❌ | ✅ |
| **Excel Integration** | ❌ | ✅ Native add-in |
| **Airtable Extension** | ❌ | ✅ Native |
| **MCP/AI Integration** | ❌ | ✅ |
| **Pricing (10k searches)** | $199/mo | $119/mo (40% savings) |
* * *
Migration Steps[](https://docs.tomba.io/migration/email-finder/prospeo#migration-steps)
----------------------------------------------------------------------------------------
### Step 1: Get Tomba Credentials[](https://docs.tomba.io/migration/email-finder/prospeo#step-1-get-tomba-credentials)
1. Sign up at [app.tomba.io](https://app.tomba.io/)
2. Get your **API Key** and **Secret Key**
### Step 2: Update API Endpoints[](https://docs.tomba.io/migration/email-finder/prospeo#step-2-update-api-endpoints)
**Prospeo:**
Code
`POST https://api.prospeo.io/email-finder`
**Tomba:**
Code
`GET https://api.tomba.io/v1/email-finder`
### Step 3: Update Authentication[](https://docs.tomba.io/migration/email-finder/prospeo#step-3-update-authentication)
**Prospeo:**
Code
`{ headers: { 'X-KEY': PROSPEO_KEY } }`
**Tomba:**
Code
`{ headers: { 'X-Tomba-Key': TOMBA_KEY, 'X-Tomba-Secret': TOMBA_SECRET } }`
* * *
Code Examples[](https://docs.tomba.io/migration/email-finder/prospeo#code-examples)
------------------------------------------------------------------------------------
### Node.js[](https://docs.tomba.io/migration/email-finder/prospeo#nodejs)
**Before (Prospeo):**
Code
`const axios = require("axios"); async function findEmail(domain, firstName, lastName) { const response = await axios.post( "https://api.prospeo.io/email-finder", { domain: domain, first_name: firstName, last_name: lastName, }, { headers: { "X-KEY": process.env.PROSPEO_KEY }, }, ); return response.data; } // Verification costs extra async function verifyEmail(email) { const response = await axios.post( "https://api.prospeo.io/email-verifier", { email: email }, { headers: { "X-KEY": process.env.PROSPEO_KEY } }, ); return response.data; }`
**After (Tomba with FREE verification):**
Code
``const axios = require("axios"); async function findEmail(domain, firstName, lastName) { const response = await axios.get("https://api.tomba.io/v1/email-finder", { params: { domain: domain, first_name: firstName, last_name: lastName, }, headers: { "X-Tomba-Key": process.env.TOMBA_KEY, "X-Tomba-Secret": process.env.TOMBA_SECRET, }, }); const data = response.data.data; // Verification included FREE! console.log(`Email: ${data.email}`); console.log(`Verified: ${data.verification.status}`); console.log(`Score: ${data.score}`); console.log(`Phone: ${data.phone_number}`); // BONUS! return data; } // No separate verification call needed!``
### Python[](https://docs.tomba.io/migration/email-finder/prospeo#python)
**Before (Prospeo):**
Code
`import requests def find_email(domain, first_name, last_name): response = requests.post( 'https://api.prospeo.io/email-finder', json={ 'domain': domain, 'first_name': first_name, 'last_name': last_name }, headers={'X-KEY': os.environ['PROSPEO_KEY']} ) return response.json() def verify_email(email): # Extra cost response = requests.post( 'https://api.prospeo.io/email-verifier', json={'email': email}, headers={'X-KEY': os.environ['PROSPEO_KEY']} ) return response.json()`
**After (Tomba):**
Code
`import requests def find_email(domain, first_name, last_name): response = requests.get( 'https://api.tomba.io/v1/email-finder', params={ 'domain': domain, 'first_name': first_name, 'last_name': last_name }, headers={ 'X-Tomba-Key': os.environ['TOMBA_KEY'], 'X-Tomba-Secret': os.environ['TOMBA_SECRET'] } ) data = response.json()['data'] # Verification included FREE! print(f"Verified: {data['verification']['status']}") print(f"Phone: {data.get('phone_number', 'N/A')}") return data # No separate verification needed!`
* * *
LinkedIn Export Migration[](https://docs.tomba.io/migration/email-finder/prospeo#linkedin-export-migration)
------------------------------------------------------------------------------------------------------------
### Prospeo LinkedIn Export[](https://docs.tomba.io/migration/email-finder/prospeo#prospeo-linkedin-export)
**Before:** Export LinkedIn leads → Prospeo enrichment
**After:** Use Tomba LinkedIn Finder directly
Code
`// Tomba LinkedIn Finder (direct) const axios = require("axios"); async function enrichLinkedInProfile(linkedinUrl) { const response = await axios.get("https://api.tomba.io/v1/linkedin", { params: { url: linkedinUrl }, headers: { "X-Tomba-Key": process.env.TOMBA_KEY, "X-Tomba-Secret": process.env.TOMBA_SECRET, }, }); const data = response.data.data; return { email: data.email, phone: data.phone_number, verified: data.verification.status, company: data.company, position: data.position, linkedin: data.linkedin, }; } // Process LinkedIn Sales Navigator export const csvData = readCSV("linkedin_export.csv"); for (const row of csvData) { const enriched = await enrichLinkedInProfile(row.linkedin_url); // Save to CRM }`
* * *
Cost Comparison[](https://docs.tomba.io/migration/email-finder/prospeo#cost-comparison)
----------------------------------------------------------------------------------------
### 10,000 Emails/Month[](https://docs.tomba.io/migration/email-finder/prospeo#10000-emailsmonth)
**Prospeo:**
* Plan: $199/month (10,000 credits)
* Verification: $80/month (10,000 @ $0.008)
* **Total: $279/month**
**Tomba:**
* Plan: $119/month (10,000 searches)
* Verification: FREE
* **Total: $119/month**
**💰 Savings: $160/month = $1,920/year (57% cheaper!)**
* * *
Unique Tomba Features[](https://docs.tomba.io/migration/email-finder/prospeo#unique-tomba-features)
----------------------------------------------------------------------------------------------------
### Author Finder[](https://docs.tomba.io/migration/email-finder/prospeo#author-finder)
Code
`const author = await axios.get("https://api.tomba.io/v1/author-finder", { params: { url: "https://example.com/blog/article" }, headers: { "X-Tomba-Key": KEY, "X-Tomba-Secret": SECRET }, });`
### Technology Detection[](https://docs.tomba.io/migration/email-finder/prospeo#technology-detection)
Code
`const tech = await axios.get("https://api.tomba.io/v1/technology", { params: { domain: "stripe.com" }, headers: { "X-Tomba-Key": KEY, "X-Tomba-Secret": SECRET }, });`
### Similar Companies[](https://docs.tomba.io/migration/email-finder/prospeo#similar-companies)
Code
`const similar = await axios.get("https://api.tomba.io/v1/similar", { params: { domain: "stripe.com" }, headers: { "X-Tomba-Key": KEY, "X-Tomba-Secret": SECRET }, });`
### Phone Finder[](https://docs.tomba.io/migration/email-finder/prospeo#phone-finder)
Code
`const phone = await axios.get("https://api.tomba.io/v1/phone-finder", { params: { full_name: "John Doe", domain: "stripe.com", }, headers: { "X-Tomba-Key": KEY, "X-Tomba-Secret": SECRET }, });`
* * *
Bulk Operations[](https://docs.tomba.io/migration/email-finder/prospeo#bulk-operations)
----------------------------------------------------------------------------------------
Code
`// Bulk email finding with Tomba const axios = require("axios"); async function bulkFind(contacts) { const response = await axios.post( "https://api.tomba.io/v1/bulk/email-finder", { contacts: contacts }, { headers: { "X-Tomba-Key": process.env.TOMBA_KEY, "X-Tomba-Secret": process.env.TOMBA_SECRET, }, }, ); return response.data.task_id; } // Process thousands of contacts const contacts = [ { domain: "stripe.com", first_name: "John", last_name: "Doe" }, { domain: "shopify.com", first_name: "Jane", last_name: "Smith" }, // ... thousands more ]; const taskId = await bulkFind(contacts);`
* * *
Migration Checklist[](https://docs.tomba.io/migration/email-finder/prospeo#migration-checklist)
------------------------------------------------------------------------------------------------
* [ ] Sign up for Tomba
* [ ] Get API credentials
* [ ] Update API endpoints
* [ ] Update authentication
* [ ] Test email finding
* [ ] Migrate LinkedIn workflows
* [ ] Update bulk operations
* [ ] Install Chrome extension
* [ ] Train team
* [ ] Cancel Prospeo subscription
* * *
Support[](https://docs.tomba.io/migration/email-finder/prospeo#support)
------------------------------------------------------------------------
* [API Documentation](https://docs.tomba.io/)
* [Email Finder API](https://docs.tomba.io/api#tag/Email-Finder)
* [LinkedIn Finder](https://docs.tomba.io/bulks/linkedin-finder)
* [Support Portal](https://help.tomba.io/)
Need help? [Contact us](https://app.tomba.io/contact)
for migration assistance.
Last modified on April 28, 2026
[Migrate from Snov.io to Tomba Email Finder](https://docs.tomba.io/migration/email-finder/snov)
[Migrate from Findymail to Tomba Email Finder](https://docs.tomba.io/migration/email-finder/findymail)
Javascript
Javascript
Javascript
Javascript
Javascript
Javascript
Javascript
Javascript
Javascript
Javascript
---
# Clearbit Company API Replacement | Tomba Documentation
Menu
This guide provides step-by-step instructions for migrating from Clearbit's Company API to Tomba's `/companies/find` endpoint.
* * *
API Comparison[](https://docs.tomba.io/migration/clearbit/company-api#api-comparison)
--------------------------------------------------------------------------------------
| Feature | Clearbit Company API | Tomba Company API |
| --- | --- | --- |
| **Endpoint** | `company.clearbit.com/v2/companies/find` | `api.tomba.io/v1/companies/find` |
| **Input** | Domain | Domain |
| **Authentication** | Bearer token | API Key + Secret headers |
| **Rate Limit** | 600 req/min | 300 req/min |
| **Company Data** | ✅ | ✅ Enhanced |
| **Social Profiles** | ✅ | ✅ |
| **Logo & Assets** | ✅ | ✅ |
| **Technology Stack** | ❌ | ✅ 6000+ technologies |
| **Similar Companies** | ❌ | ✅ |
| **Phone Number** | Limited | ✅ Verified |
| **Email Count** | ❌ | ✅ |
| **Free Trial** | 50 calls | 50 searches + 500 verifications |
* * *
Endpoint Migration[](https://docs.tomba.io/migration/clearbit/company-api#endpoint-migration)
----------------------------------------------------------------------------------------------
### Clearbit Company API[](https://docs.tomba.io/migration/clearbit/company-api#clearbit-company-api)
Code
`GET https://company.clearbit.com/v2/companies/find?domain=tomba.io Authorization: Bearer sk_clearbit_xxx`
### Tomba Company API[](https://docs.tomba.io/migration/clearbit/company-api#tomba-company-api)
Code
`GET https://api.tomba.io/v1/companies/find?domain=tomba.io X-Tomba-Key: your-api-key X-Tomba-Secret: your-secret-key`
* * *
Response Format Comparison[](https://docs.tomba.io/migration/clearbit/company-api#response-format-comparison)
--------------------------------------------------------------------------------------------------------------
### Clearbit Response[](https://docs.tomba.io/migration/clearbit/company-api#clearbit-response)
Code
`{ "id": "027b0d40-016c-40ea-8925-a076fa640992", "name": "Tomba", "legalName": "Tomba Technology Web Service LLC", "domain": "tomba.io", "domainAliases": [], "url": "https://tomba.io", "site": { "title": "Tomba - Email Finder", "h1": "Find Anyone's Email Address", "metaDescription": "Tomba helps you find email addresses", "phoneNumbers": ["+1-234-567-8900"] }, "tags": ["Technology", "B2B", "SaaS"], "description": "Email finding and verification platform", "foundedYear": 2018, "location": "123 Tech Street, San Francisco, CA 94105, USA", "timeZone": "America/Los_Angeles", "utcOffset": -8, "geo": { "streetNumber": "123", "streetName": "Tech Street", "subPremise": null, "city": "San Francisco", "postalCode": "94105", "state": "California", "stateCode": "CA", "country": "United States", "countryCode": "US", "lat": 37.7749, "lng": -122.4194 }, "logo": "https://logo.clearbit.com/tomba.io", "facebook": { "handle": "tombaio" }, "linkedin": { "handle": "company/tomba" }, "twitter": { "handle": "tomba_io", "id": "123456789", "followers": 5000 }, "crunchbase": { "handle": "organization/tomba" }, "emailProvider": false, "type": "private", "ticker": null, "phone": "+1-234-567-8900", "metrics": { "alexaUsRank": 50000, "alexaGlobalRank": 150000, "googleRank": 5, "employees": 50, "employeesRange": "11-50", "marketCap": null, "raised": 2000000, "annualRevenue": null, "estimatedAnnualRevenue": "$5M-$10M" }, "category": { "sector": "Information Technology", "industryGroup": "Software", "industry": "Application Software", "subIndustry": "Business Intelligence Software", "gicsCode": "45103010" }, "tech": ["google_analytics", "stripe"], "parent": { "domain": null } }`
### Tomba Response[](https://docs.tomba.io/migration/clearbit/company-api#tomba-response)
Code
`{ "data": { "organization": "Tomba", "email_count": 15, "phone_number": "+1-234-567-8900", "website": "https://tomba.io", "country": "US", "state": "California", "city": "San Francisco", "postal_code": "94105", "street": "123 Tech Street", "revenue": "5000000-10000000", "employees": "11-50", "founded": 2018, "industry": "Computer Software", "description": "Tomba helps you find and verify professional email addresses", "logo": "https://d12h6n0d1mbsct.cloudfront.net/logos/tomba-io.jpg", "twitter": "tomba_io", "linkedin": "tomba", "facebook": "tombaio", "technologies": [ { "name": "Google Analytics", "category": "Analytics", "icon": "https://d12h6n0d1mbsct.cloudfront.net/technologies/google-analytics.png" }, { "name": "Stripe", "category": "Payment", "icon": "https://d12h6n0d1mbsct.cloudfront.net/technologies/stripe.png" } ], "similar_domains": ["xxx.io", "xxx.io", "xxx.com"] } }`
* * *
Field Mapping[](https://docs.tomba.io/migration/clearbit/company-api#field-mapping)
------------------------------------------------------------------------------------
| Clearbit Field | Tomba Field | Notes |
| --- | --- | --- |
| `name` | `organization` | Company name |
| `domain` | N/A | Input parameter |
| `url` | `website` | Company website |
| `description` | `description` | Company description |
| `foundedYear` | `founded` | Year founded |
| `geo.city` | `city` | City location |
| `geo.state` | `state` | State/Province |
| `geo.country` | `country` | Country code |
| `geo.postalCode` | `postal_code` | Postal code |
| `geo.streetName` + `geo.streetNumber` | `street` | Street address |
| `logo` | `logo` | Logo URL |
| `phone` | `phone_number` | Company phone |
| `metrics.employees` | `employees` | Employee count |
| `metrics.estimatedAnnualRevenue` | `revenue` | Revenue estimate |
| `facebook.handle` | `facebook` | Facebook username |
| `linkedin.handle` | `linkedin` | LinkedIn handle |
| `twitter.handle` | `twitter` | Twitter handle |
| `tech` | `technologies` | **Enhanced array with details** |
| N/A | `email_count` | **New: Total emails available** |
| N/A | `similar_domains` | **New: Competitor list** |
* * *
Code Examples[](https://docs.tomba.io/migration/clearbit/company-api#code-examples)
------------------------------------------------------------------------------------
### Node.js / JavaScript[](https://docs.tomba.io/migration/clearbit/company-api#nodejs--javascript)
**Before (Clearbit):**
Code
``const clearbit = require("clearbit")("sk_clearbit_xxx"); async function getCompany(domain) { try { const company = await clearbit.Company.find({ domain }); return { name: company.name, employees: company.metrics?.employees, industry: company.category?.industry, location: `${company.geo?.city}, ${company.geo?.country}`, }; } catch (error) { console.error("Clearbit error:", error); throw error; } }``
**After (Tomba):**
Code
``const axios = require("axios"); async function getCompany(domain) { try { const response = await axios.get( "https://api.tomba.io/v1/companies/find", { params: { domain }, headers: { "X-Tomba-Key": process.env.TOMBA_API_KEY, "X-Tomba-Secret": process.env.TOMBA_API_SECRET, }, }, ); const company = response.data.data; return { name: company.organization, employees: company.employees, industry: company.industry, location: `${company.city}, ${company.country}`, // Bonus fields not in Clearbit emailCount: company.email_count, technologies: company.technologies?.map((t) => t.name), competitors: company.similar_domains, }; } catch (error) { console.error("Tomba error:", error); throw error; } } // Usage getCompany("stripe.com").then(console.log);``
### Python[](https://docs.tomba.io/migration/clearbit/company-api#python)
**Before (Clearbit):**
Code
`import clearbit clearbit.key = 'sk_clearbit_xxx' def get_company(domain): try: company = clearbit.Company.find(domain=domain) return { 'name': company['name'], 'employees': company.get('metrics', {}).get('employees'), 'industry': company.get('category', {}).get('industry'), 'location': f"{company.get('geo', {}).get('city')}, {company.get('geo', {}).get('country')}" } except clearbit.errors.NotFoundError: return None`
**After (Tomba):**
Code
`import requests import os def get_company(domain): try: response = requests.get( 'https://api.tomba.io/v1/companies/find', params={'domain': domain}, headers={ 'X-Tomba-Key': os.getenv('TOMBA_API_KEY'), 'X-Tomba-Secret': os.getenv('TOMBA_API_SECRET') } ) response.raise_for_status() company = response.json()['data'] return { 'name': company['organization'], 'employees': company.get('employees'), 'industry': company.get('industry'), 'location': f"{company.get('city')}, {company.get('country')}", # Bonus fields 'email_count': company.get('email_count'), 'technologies': [t['name'] for t in company.get('technologies', [])], 'competitors': company.get('similar_domains', []) } except requests.exceptions.HTTPError as e: if e.response.status_code == 404: return None raise # Usage company = get_company('stripe.com') print(company)`
### PHP[](https://docs.tomba.io/migration/clearbit/company-api#php)
**Before (Clearbit):**
Code
`find(['domain' => $domain]); return [ 'name' => $company->name, 'employees' => $company->metrics->employees ?? null, 'industry' => $company->category->industry ?? null, 'location' => "{$company->geo->city}, {$company->geo->country}" ]; } catch (\Clearbit\Errors\NotFoundError $e) { return null; } }`
**After (Tomba):**
Code
`get('https://api.tomba.io/v1/companies/find', [ 'query' => ['domain' => $domain], 'headers' => [ 'X-Tomba-Key' => getenv('TOMBA_API_KEY'), 'X-Tomba-Secret' => getenv('TOMBA_API_SECRET') ] ]); $company = json_decode($response->getBody())->data; return [ 'name' => $company->organization, 'employees' => $company->employees ?? null, 'industry' => $company->industry ?? null, 'location' => "{$company->city}, {$company->country}", // Bonus fields 'email_count' => $company->email_count ?? 0, 'technologies' => array_map(fn($t) => $t->name, $company->technologies ?? []), 'competitors' => $company->similar_domains ?? [] ]; } catch (\GuzzleHttp\Exception\ClientException $e) { if ($e->getResponse()->getStatusCode() === 404) { return null; } throw $e; } } // Usage $company = getCompany('stripe.com'); print_r($company);`
### Ruby[](https://docs.tomba.io/migration/clearbit/company-api#ruby)
**Before (Clearbit):**
Code
`require 'clearbit' Clearbit.key = 'sk_clearbit_xxx' def get_company(domain) company = Clearbit::Enrichment::Company.find(domain: domain) { name: company.name, employees: company.metrics&.employees, industry: company.category&.industry, location: "#{company.geo&.city}, #{company.geo&.country}" } rescue Clearbit::NotFoundError nil end`
**After (Tomba):**
Code
`require 'httparty' def get_company(domain) response = HTTParty.get( 'https://api.tomba.io/v1/companies/find', query: { domain: domain }, headers: { 'X-Tomba-Key' => ENV['TOMBA_API_KEY'], 'X-Tomba-Secret' => ENV['TOMBA_API_SECRET'] } ) return nil if response.code == 404 raise "API Error: #{response.code}" unless response.success? company = response.parsed_response['data'] { name: company['organization'], employees: company['employees'], industry: company['industry'], location: "#{company['city']}, #{company['country']}", # Bonus fields email_count: company['email_count'], technologies: company['technologies']&.map { |t| t['name'] }, competitors: company['similar_domains'] } end # Usage company = get_company('stripe.com') puts company`
* * *
Enhanced Features[](https://docs.tomba.io/migration/clearbit/company-api#enhanced-features)
--------------------------------------------------------------------------------------------
### Technology Stack Detection[](https://docs.tomba.io/migration/clearbit/company-api#technology-stack-detection)
Tomba provides detailed technology information not available in Clearbit:
Code
``const response = await axios.get("https://api.tomba.io/v1/companies/find", { params: { domain: "shopify.com" }, headers: { "X-Tomba-Key": process.env.TOMBA_API_KEY, "X-Tomba-Secret": process.env.TOMBA_API_SECRET, }, }); console.log("Technologies used:"); response.data.data.technologies.forEach((tech) => { console.log(`- ${tech.name} (${tech.category})`); }); // Output: // - Google Analytics (Analytics) // - Stripe (Payment Processing) // - Cloudflare (CDN) // - Shopify (E-commerce) // - Mailchimp (Email Marketing)``
### Similar Companies / Competitors[](https://docs.tomba.io/migration/clearbit/company-api#similar-companies--competitors)
Find competitors automatically:
Code
``const company = response.data.data; console.log(`Companies similar to ${company.organization}:`); console.log(company.similar_domains); // Output: // ['bigcommerce.com', 'woocommerce.com', 'magento.com']``
### Email Count[](https://docs.tomba.io/migration/clearbit/company-api#email-count)
Know how many contacts are available:
Code
``const company = response.data.data; console.log( `${company.email_count} contacts available at ${company.organization}`, ); // Output: "147 contacts available at Shopify"``
* * *
Error Handling[](https://docs.tomba.io/migration/clearbit/company-api#error-handling)
--------------------------------------------------------------------------------------
### Clearbit Errors[](https://docs.tomba.io/migration/clearbit/company-api#clearbit-errors)
Code
`try { const company = await clearbit.Company.find({ domain }); } catch (error) { if (error.type === "not_found") { // Company not found } else if (error.type === "rate_limit") { // Rate limited } else if (error.type === "invalid_request") { // Bad request } }`
### Tomba Errors[](https://docs.tomba.io/migration/clearbit/company-api#tomba-errors)
Code
`try { const response = await axios.get("https://api.tomba.io/v1/companies/find", { params: { domain }, headers: { "X-Tomba-Key": process.env.TOMBA_API_KEY, "X-Tomba-Secret": process.env.TOMBA_API_SECRET, }, }); } catch (error) { if (error.response?.status === 404) { // Company not found console.log("Company not found in database"); } else if (error.response?.status === 429) { // Rate limited console.log("Rate limit exceeded"); } else if (error.response?.status === 400) { // Bad request console.log("Invalid domain format"); } else if (error.response?.status === 401) { // Authentication failed console.log("Invalid API credentials"); } }`
* * *
Testing[](https://docs.tomba.io/migration/clearbit/company-api#testing)
------------------------------------------------------------------------
### Sample Test Cases[](https://docs.tomba.io/migration/clearbit/company-api#sample-test-cases)
Code
`const assert = require("assert"); describe("Company API Migration", () => { it("should return company data for valid domain", async () => { const company = await getCompany("stripe.com"); assert(company.name); assert(company.location); assert(company.industry); assert.ok(company.emailCount > 0); // New field }); it("should return null for non-existent domain", async () => { const company = await getCompany("thisdoesnotexist12345.com"); assert.strictEqual(company, null); }); it("should include technology data", async () => { const company = await getCompany("shopify.com"); assert(Array.isArray(company.technologies)); assert(company.technologies.length > 0); }); it("should include similar companies", async () => { const company = await getCompany("salesforce.com"); assert(Array.isArray(company.competitors)); }); });`
* * *
Migration Checklist[](https://docs.tomba.io/migration/clearbit/company-api#migration-checklist)
------------------------------------------------------------------------------------------------
* [ ] Update authentication to use API Key + Secret headers
* [ ] Change base URL to `api.tomba.io/v1`
* [ ] Update field mappings in your code
* [ ] Add handling for new fields (technologies, similar\_domains, email\_count)
* [ ] Update error handling for Tomba response codes
* [ ] Test with sample domains
* [ ] Update type definitions/interfaces
* [ ] Test edge cases (invalid domains, rate limits)
* [ ] Deploy to staging environment
* [ ] Monitor API responses
* [ ] Deploy to production
* * *
Next Steps[](https://docs.tomba.io/migration/clearbit/company-api#next-steps)
------------------------------------------------------------------------------
* [Person API Migration](https://docs.tomba.io/migration/clearbit/person-api)
- Enrich person data
* [Combined API Migration](https://docs.tomba.io/migration/clearbit/combined-api)
- Get person + company data
* [Full API Documentation](https://docs.tomba.io/)
* * *
**Need help with migration?**
Contact our support team at [support@tomba.io](mailto:support@tomba.io)
for personalized migration assistance.
Last modified on December 1, 2025
[Clearbit API Replacement - Migrate to Tomba](https://docs.tomba.io/migration/clearbit/introduction)
[Clearbit Person API Replacement](https://docs.tomba.io/migration/clearbit/person-api)
JSON
JSON
Javascript
Javascript
PHP
PHP
Ruby
Ruby
Javascript
Javascript
Javascript
Javascript
Javascript
Javascript
---
# Migrate from Findymail to Tomba Email Finder | Tomba Documentation
Menu
Switch from Findymail to Tomba for better pricing, more features, and superior data enrichment.
* * *
Why Switch from Findymail to Tomba?[](https://docs.tomba.io/migration/email-finder/findymail#why-switch-from-findymail-to-tomba)
---------------------------------------------------------------------------------------------------------------------------------
| Feature | Findymail | Tomba |
| --- | --- | --- |
| **Database Size** | 250M emails | 450M+ emails |
| **Accuracy** | 90-95% | 98%+ |
| **Email Verification** | ✅ Included | ✅ FREE included |
| **Data Attributes** | 12 fields | 20+ fields |
| **Waterfall Enrichment** | ✅ | API-based alternative |
| **Author Finder** | ❌ | ✅ |
| **Phone Finder** | ⚠️ Limited | ✅ Finder & Validator |
| **Technology Detection** | ❌ | ✅ 6000+ techs |
| **Similar Companies** | ❌ | ✅ |
| **LinkedIn Finder** | ✅ | ✅ Better |
| **Chrome Extension** | ✅ | ✅ Enhanced |
| **Google Sheets** | ❌ | ✅ |
| **Excel Integration** | ❌ | ✅ Native add-in |
| **Airtable Extension** | ❌ | ✅ Native |
| **MCP/AI Integration** | ❌ | ✅ Claude, ChatGPT |
| **Pricing (10k searches)** | $199/mo | $119/mo (40% savings) |
* * *
Migration Steps[](https://docs.tomba.io/migration/email-finder/findymail#migration-steps)
------------------------------------------------------------------------------------------
### Step 1: Get Tomba Credentials[](https://docs.tomba.io/migration/email-finder/findymail#step-1-get-tomba-credentials)
1. Sign up at [app.tomba.io](https://app.tomba.io/)
2. Get your **API Key** and **Secret Key**
### Step 2: Update API Endpoints[](https://docs.tomba.io/migration/email-finder/findymail#step-2-update-api-endpoints)
**Findymail:**
Code
`POST https://api.findymail.com/v1/search/name`
**Tomba:**
Code
`GET https://api.tomba.io/v1/email-finder`
### Step 3: Update Authentication[](https://docs.tomba.io/migration/email-finder/findymail#step-3-update-authentication)
**Findymail:**
Code
``{ headers: { 'Authorization': `Bearer ${FINDYMAIL_KEY}` } }``
**Tomba:**
Code
`{ headers: { 'X-Tomba-Key': TOMBA_KEY, 'X-Tomba-Secret': TOMBA_SECRET } }`
* * *
Code Examples[](https://docs.tomba.io/migration/email-finder/findymail#code-examples)
--------------------------------------------------------------------------------------
### Node.js[](https://docs.tomba.io/migration/email-finder/findymail#nodejs)
**Before (Findymail):**
Code
``const axios = require("axios"); async function findEmail(domain, firstName, lastName) { const response = await axios.post( "https://api.findymail.com/v1/search/name", { domain: domain, first_name: firstName, last_name: lastName, }, { headers: { Authorization: `Bearer ${process.env.FINDYMAIL_KEY}` }, }, ); return response.data; }``
**After (Tomba):**
Code
``const axios = require("axios"); async function findEmail(domain, firstName, lastName) { const response = await axios.get("https://api.tomba.io/v1/email-finder", { params: { domain: domain, first_name: firstName, last_name: lastName, }, headers: { "X-Tomba-Key": process.env.TOMBA_KEY, "X-Tomba-Secret": process.env.TOMBA_SECRET, }, }); const data = response.data.data; console.log(`Email: ${data.email}`); console.log(`Verified: ${data.verification.status}`); console.log(`Score: ${data.score}`); console.log(`Phone: ${data.phone_number}`); console.log(`LinkedIn: ${data.linkedin}`); console.log(`Company Size: ${data.company.size}`); return data; }``
**Using Tomba SDK:**
Code
`const Tomba = require("tomba"); const client = new Tomba.Client() .setKey(process.env.TOMBA_KEY) .setSecret(process.env.TOMBA_SECRET); const finder = new Tomba.Finder(client); async function findEmail(domain, firstName, lastName) { const result = await finder.emailFinder({ domain: domain, first_name: firstName, last_name: lastName, }); return result.data; }`
### Python[](https://docs.tomba.io/migration/email-finder/findymail#python)
**Before (Findymail):**
Code
`import requests def find_email(domain, first_name, last_name): response = requests.post( 'https://api.findymail.com/v1/search/name', json={ 'domain': domain, 'first_name': first_name, 'last_name': last_name }, headers={'Authorization': f'Bearer {os.environ["FINDYMAIL_KEY"]}'} ) return response.json()`
**After (Tomba):**
Code
`import requests def find_email(domain, first_name, last_name): response = requests.get( 'https://api.tomba.io/v1/email-finder', params={ 'domain': domain, 'first_name': first_name, 'last_name': last_name }, headers={ 'X-Tomba-Key': os.environ['TOMBA_KEY'], 'X-Tomba-Secret': os.environ['TOMBA_SECRET'] } ) data = response.json()['data'] print(f"Email: {data['email']}") print(f"Verified: {data['verification']['status']}") print(f"Phone: {data.get('phone_number', 'N/A')}") return data`
**Using Tomba SDK:**
Code
`from tomba import Client, Finder client = Client() client.set_key(os.environ['TOMBA_KEY']) client.set_secret(os.environ['TOMBA_SECRET']) finder = Finder(client) def find_email(domain, first_name, last_name): result = finder.email_finder( domain=domain, first_name=first_name, last_name=last_name ) return result['data']`
* * *
Waterfall Enrichment Alternative[](https://docs.tomba.io/migration/email-finder/findymail#waterfall-enrichment-alternative)
----------------------------------------------------------------------------------------------------------------------------
Findymail's waterfall enrichment can be replicated with Tomba's API:
Code
`const axios = require("axios"); async function waterfallEnrichment(domain, firstName, lastName, linkedinUrl) { const headers = { "X-Tomba-Key": process.env.TOMBA_KEY, "X-Tomba-Secret": process.env.TOMBA_SECRET, }; // Try 1: Email Finder try { const emailResult = await axios.get( "https://api.tomba.io/v1/email-finder", { params: { domain, first_name: firstName, last_name: lastName }, headers, }, ); if (emailResult.data.data.email) { return enrichData(emailResult.data.data); } } catch (e) {} // Try 2: LinkedIn Finder if (linkedinUrl) { try { const linkedinResult = await axios.get( "https://api.tomba.io/v1/linkedin", { params: { url: linkedinUrl }, headers, }, ); if (linkedinResult.data.data.email) { return enrichData(linkedinResult.data.data); } } catch (e) {} } // Try 3: Domain Search (find similar contacts) try { const domainResult = await axios.get( "https://api.tomba.io/v1/domain-search", { params: { domain }, headers, }, ); // Find best match const match = findBestMatch( domainResult.data.data.emails, firstName, lastName, ); if (match) { return enrichData(match); } } catch (e) {} return null; } function enrichData(data) { return { email: data.email, verified: data.verification?.status === "valid", phone: data.phone_number, linkedin: data.linkedin, position: data.position, company: data.company, score: data.score, }; }`
* * *
Cost Comparison[](https://docs.tomba.io/migration/email-finder/findymail#cost-comparison)
------------------------------------------------------------------------------------------
### 10,000 Emails/Month[](https://docs.tomba.io/migration/email-finder/findymail#10000-emailsmonth)
**Findymail:**
* Growth Plan: $199/month (10,000 credits)
* Verification: Included
* **Total: $199/month**
**Tomba:**
* Growth Plan: $119/month (10,000 searches)
* Verification: FREE included
* **Total: $119/month**
**💰 Savings: $80/month = $960/year (40% cheaper!)**
### 50,000 Emails/Month[](https://docs.tomba.io/migration/email-finder/findymail#50000-emailsmonth)
**Findymail:**
* Scale Plan: $999/month (50,000 credits)
* **Total: $999/month**
**Tomba:**
* Enterprise Plan: $599/month (50,000 searches)
* **Total: $599/month**
**💰 Savings: $400/month = $4,800/year (40% cheaper!)**
* * *
Unique Tomba Features[](https://docs.tomba.io/migration/email-finder/findymail#unique-tomba-features)
------------------------------------------------------------------------------------------------------
### Author Finder[](https://docs.tomba.io/migration/email-finder/findymail#author-finder)
Code
``// Find email from article URL const author = await axios.get("https://api.tomba.io/v1/author-finder", { params: { url: "https://example.com/blog/article" }, headers: { "X-Tomba-Key": KEY, "X-Tomba-Secret": SECRET }, }); console.log(`Author: ${author.data.data.email}`);``
### Technology Detection[](https://docs.tomba.io/migration/email-finder/findymail#technology-detection)
Code
``// Detect tech stack for targeting const tech = await axios.get("https://api.tomba.io/v1/technology", { params: { domain: "stripe.com" }, headers: { "X-Tomba-Key": KEY, "X-Tomba-Secret": SECRET }, }); console.log(`Technologies: ${tech.data.data.technologies.length}`); // Returns: React, Node.js, AWS, etc.``
### Similar Companies[](https://docs.tomba.io/migration/email-finder/findymail#similar-companies)
Code
``// Find lookalike companies const similar = await axios.get("https://api.tomba.io/v1/similar", { params: { domain: "stripe.com" }, headers: { "X-Tomba-Key": KEY, "X-Tomba-Secret": SECRET }, }); console.log(`Similar companies: ${similar.data.data.companies.length}`);``
### Enhanced Phone Finder[](https://docs.tomba.io/migration/email-finder/findymail#enhanced-phone-finder)
Code
``// Find verified phone numbers const phone = await axios.get("https://api.tomba.io/v1/phone-finder", { params: { full_name: "John Doe", domain: "stripe.com", }, headers: { "X-Tomba-Key": KEY, "X-Tomba-Secret": SECRET }, }); console.log(`Phone: ${phone.data.data.phone_number}`);``
* * *
Bulk Operations[](https://docs.tomba.io/migration/email-finder/findymail#bulk-operations)
------------------------------------------------------------------------------------------
Code
`// Bulk email finding const axios = require("axios"); async function bulkFind(contacts) { const response = await axios.post( "https://api.tomba.io/v1/bulk/email-finder", { contacts: contacts }, { headers: { "X-Tomba-Key": process.env.TOMBA_KEY, "X-Tomba-Secret": process.env.TOMBA_SECRET, }, }, ); const taskId = response.data.task_id; // Poll for results or use webhook return taskId; } // Process thousands const contacts = [ { domain: "stripe.com", first_name: "John", last_name: "Doe" }, { domain: "shopify.com", first_name: "Jane", last_name: "Smith" }, // ... more ]; const taskId = await bulkFind(contacts);`
* * *
Migration Checklist[](https://docs.tomba.io/migration/email-finder/findymail#migration-checklist)
--------------------------------------------------------------------------------------------------
* [ ] Sign up for Tomba
* [ ] Get API credentials
* [ ] Update API endpoints
* [ ] Update authentication
* [ ] Test email finding
* [ ] Migrate waterfall logic
* [ ] Update bulk operations
* [ ] Install Chrome extension
* [ ] Setup Google Sheets/Excel
* [ ] Train team
* [ ] Cancel Findymail subscription
* * *
Support[](https://docs.tomba.io/migration/email-finder/findymail#support)
--------------------------------------------------------------------------
* [API Documentation](https://docs.tomba.io/)
* [Email Finder API](https://docs.tomba.io/api#tag/Email-Finder)
* [Bulk Operations](https://docs.tomba.io/bulks/email-finder)
* [Support Portal](https://help.tomba.io/)
Need help? [Contact us](https://app.tomba.io/contact)
for migration assistance.
* * *
FAQ[](https://docs.tomba.io/migration/email-finder/findymail#faq)
------------------------------------------------------------------
**Q: What about waterfall enrichment?** A: Replicate it using Tomba's Email Finder → LinkedIn Finder → Domain Search cascade (see code example above).
**Q: Will I save money?** A: Yes! Tomba is 40% cheaper than Findymail at all volume tiers.
**Q: Is accuracy comparable?** A: Tomba's accuracy is higher (98%+ vs 90-95%) thanks to our larger database and built-in verification.
**Q: Can I test before migrating?** A: Yes! Sign up for a free account with 25 searches to compare results.
**Q: How long does migration take?** A: Most teams complete migration in 1-2 days with our code examples and SDK support.
Last modified on April 28, 2026
[Migrate from Prospeo to Tomba Email Finder](https://docs.tomba.io/migration/email-finder/prospeo)
Javascript
Javascript
Javascript
Javascript
Javascript
Javascript
Javascript
Javascript
Javascript
Javascript
Javascript
---
# Clearbit Person API Replacement | Tomba Documentation
Menu
This guide provides step-by-step instructions for migrating from Clearbit's Person API to Tomba's `/people/find` endpoint.
* * *
API Comparison[](https://docs.tomba.io/migration/clearbit/person-api#api-comparison)
-------------------------------------------------------------------------------------
| Feature | Clearbit Person API | Tomba Person API |
| --- | --- | --- |
| **Endpoint** | `person.clearbit.com/v2/people/find` | `api.tomba.io/v1/people/find` |
| **Input** | Email | Email |
| **Authentication** | Bearer token | API Key + Secret headers |
| **Rate Limit** | 600 req/min | 300 req/min |
| **Person Data** | ✅ | ✅ Enhanced |
| **Social Profiles** | ✅ | ✅ More networks |
| **Employment** | ✅ | ✅ |
| **Email Verification** | ❌ | ✅ FREE |
| **Phone Numbers** | Limited | ✅ Validated |
| **LinkedIn Data** | Basic | ✅ Enhanced |
| **Company Data** | Basic | ✅ Full company info |
| **Free Trial** | 50 calls | 50 searches + 500 verifications |
* * *
Endpoint Migration[](https://docs.tomba.io/migration/clearbit/person-api#endpoint-migration)
---------------------------------------------------------------------------------------------
### Clearbit Person API[](https://docs.tomba.io/migration/clearbit/person-api#clearbit-person-api)
Code
`GET https://person.clearbit.com/v2/people/find?email=john@stripe.com Authorization: Bearer sk_clearbit_xxx`
### Tomba Person API[](https://docs.tomba.io/migration/clearbit/person-api#tomba-person-api)
Code
`GET https://api.tomba.io/v1/people/find?email=john@stripe.com X-Tomba-Key: your-api-key X-Tomba-Secret: your-secret-key`
* * *
Response Format Comparison[](https://docs.tomba.io/migration/clearbit/person-api#response-format-comparison)
-------------------------------------------------------------------------------------------------------------
### Clearbit Response[](https://docs.tomba.io/migration/clearbit/person-api#clearbit-response)
Code
`{ "id": "d54c54ad-40be-4305-8a34-0ab44710b90d", "name": { "fullName": "John Doe", "givenName": "John", "familyName": "Doe" }, "email": "john@stripe.com", "gender": null, "location": "San Francisco, CA, US", "timeZone": "America/Los_Angeles", "utcOffset": -8, "geo": { "city": "San Francisco", "state": "California", "stateCode": "CA", "country": "United States", "countryCode": "US", "lat": 37.7749, "lng": -122.4194 }, "bio": "Software Engineer passionate about building great products", "site": "https://johndoe.com", "avatar": "https://d1ts43dypk8bqh.cloudfront.net/v1/avatars/d54c54ad-40be-4305-8a34-0ab44710b90d", "employment": { "domain": "stripe.com", "name": "Stripe", "title": "Senior Software Engineer", "role": "engineering", "subRole": "engineering_manager", "seniority": "senior" }, "facebook": { "handle": "johndoe" }, "github": { "handle": "johndoe", "id": "123456", "avatar": "https://avatars.githubusercontent.com/u/123456", "company": "Stripe", "blog": "https://johndoe.com", "followers": 500, "following": 100 }, "twitter": { "handle": "johndoe", "id": "123456789", "bio": "Software Engineer @Stripe", "followers": 1000, "following": 300, "location": "San Francisco, CA", "site": "https://johndoe.com", "avatar": "https://pbs.twimg.com/profile_images/123456789/avatar.jpg" }, "linkedin": { "handle": "in/johndoe" }, "googleplus": { "handle": null }, "gravatar": { "handle": "johndoe", "urls": [], "avatar": "https://secure.gravatar.com/avatar/123456", "avatars": [] }, "fuzzy": false, "emailProvider": false, "indexedAt": "2024-01-15T10:30:00.000Z" }`
### Tomba Response[](https://docs.tomba.io/migration/clearbit/person-api#tomba-response)
Code
`{ "data": { "email": "john@stripe.com", "first_name": "John", "last_name": "Doe", "full_name": "John Doe", "gender": null, "phone_number": "+1-415-555-0123", "position": "Senior Software Engineer", "department": "Engineering", "seniority": "senior", "twitter": "johndoe", "linkedin": "https://www.linkedin.com/in/johndoe", "github": "johndoe", "facebook": "johndoe", "website": "https://johndoe.com", "bio": "Software Engineer passionate about building great products", "location": { "city": "San Francisco", "state": "California", "country": "United States", "country_code": "US" }, "company": { "organization": "Stripe", "domain": "stripe.com", "website": "https://stripe.com", "industry": "Financial Services", "employees": "1001-5000", "revenue": "$100M-$500M", "logo": "https://d12h6n0d1mbsct.cloudfront.net/logos/stripe-com.jpg" }, "verification": { "status": "valid", "result": "deliverable", "score": 98, "accept_all": false, "smtp_check": true, "mx_records": true, "disposable": false, "free_email": false }, "sources": [ { "uri": "https://stripe.com/about", "website_piece": "team", "extracted_on": "2024-01-15", "last_seen_on": "2024-01-15" } ] } }`
* * *
Field Mapping[](https://docs.tomba.io/migration/clearbit/person-api#field-mapping)
-----------------------------------------------------------------------------------
| Clearbit Field | Tomba Field | Notes |
| --- | --- | --- |
| `name.fullName` | `full_name` | Full name |
| `name.givenName` | `first_name` | First name |
| `name.familyName` | `last_name` | Last name |
| `email` | `email` | Email address |
| `gender` | `gender` | Gender |
| `bio` | `bio` | Biography |
| `site` | `website` | Personal website |
| `employment.title` | `position` | Job title |
| `employment.role` | `department` | Department |
| `employment.seniority` | `seniority` | Seniority level |
| `employment.name` | `company.organization` | Company name |
| `employment.domain` | `company.domain` | Company domain |
| `geo.city` | `location.city` | City |
| `geo.state` | `location.state` | State |
| `geo.country` | `location.country` | Country |
| `geo.countryCode` | `location.country_code` | Country code |
| `twitter.handle` | `twitter` | Twitter handle |
| `linkedin.handle` | `linkedin` | LinkedIn URL |
| `github.handle` | `github` | GitHub username |
| `facebook.handle` | `facebook` | Facebook username |
| N/A | `phone_number` | **New: Validated phone** |
| N/A | `verification` | **New: Email verification** |
| N/A | `company.*` | **New: Full company data** |
| N/A | `sources` | **New: Data sources** |
* * *
Code Examples[](https://docs.tomba.io/migration/clearbit/person-api#code-examples)
-----------------------------------------------------------------------------------
### Node.js / JavaScript[](https://docs.tomba.io/migration/clearbit/person-api#nodejs--javascript)
**Before (Clearbit):**
Code
``const clearbit = require("clearbit")("sk_clearbit_xxx"); async function getPerson(email) { try { const person = await clearbit.Person.find({ email }); return { name: person.name?.fullName, position: person.employment?.title, company: person.employment?.name, location: `${person.geo?.city}, ${person.geo?.countryCode}`, linkedin: person.linkedin?.handle, }; } catch (error) { console.error("Clearbit error:", error); throw error; } }``
**After (Tomba):**
Code
``const axios = require("axios"); async function getPerson(email) { try { const response = await axios.get( "https://api.tomba.io/v1/people/find", { params: { email }, headers: { "X-Tomba-Key": process.env.TOMBA_API_KEY, "X-Tomba-Secret": process.env.TOMBA_API_SECRET, }, }, ); const person = response.data.data; return { name: person.full_name, position: person.position, company: person.company?.organization, location: `${person.location?.city}, ${person.location?.country_code}`, linkedin: person.linkedin, // Bonus fields not in Clearbit phone: person.phone_number, emailValid: person.verification?.status === "valid", emailScore: person.verification?.score, companyRevenue: person.company?.revenue, companyEmployees: person.company?.employees, }; } catch (error) { console.error("Tomba error:", error); throw error; } } // Usage getPerson("john@stripe.com").then(console.log);``
### Python[](https://docs.tomba.io/migration/clearbit/person-api#python)
**Before (Clearbit):**
Code
`import clearbit clearbit.key = 'sk_clearbit_xxx' def get_person(email): try: person = clearbit.Person.find(email=email) return { 'name': person.get('name', {}).get('fullName'), 'position': person.get('employment', {}).get('title'), 'company': person.get('employment', {}).get('name'), 'location': f"{person.get('geo', {}).get('city')}, {person.get('geo', {}).get('countryCode')}", 'linkedin': person.get('linkedin', {}).get('handle') } except clearbit.errors.NotFoundError: return None`
**After (Tomba):**
Code
`import requests import os def get_person(email): try: response = requests.get( 'https://api.tomba.io/v1/people/find', params={'email': email}, headers={ 'X-Tomba-Key': os.getenv('TOMBA_API_KEY'), 'X-Tomba-Secret': os.getenv('TOMBA_API_SECRET') } ) response.raise_for_status() person = response.json()['data'] return { 'name': person.get('full_name'), 'position': person.get('position'), 'company': person.get('company', {}).get('organization'), 'location': f"{person.get('location', {}).get('city')}, {person.get('location', {}).get('country_code')}", 'linkedin': person.get('linkedin'), # Bonus fields 'phone': person.get('phone_number'), 'email_valid': person.get('verification', {}).get('status') == 'valid', 'email_score': person.get('verification', {}).get('score'), 'company_revenue': person.get('company', {}).get('revenue'), 'company_employees': person.get('company', {}).get('employees') } except requests.exceptions.HTTPError as e: if e.response.status_code == 404: return None raise # Usage person = get_person('john@stripe.com') print(person)`
### PHP[](https://docs.tomba.io/migration/clearbit/person-api#php)
**Before (Clearbit):**
Code
`find(['email' => $email]); return [ 'name' => $person->name->fullName ?? null, 'position' => $person->employment->title ?? null, 'company' => $person->employment->name ?? null, 'location' => "{$person->geo->city}, {$person->geo->countryCode}", 'linkedin' => $person->linkedin->handle ?? null ]; } catch (\Clearbit\Errors\NotFoundError $e) { return null; } }`
**After (Tomba):**
Code
`get('https://api.tomba.io/v1/people/find', [ 'query' => ['email' => $email], 'headers' => [ 'X-Tomba-Key' => getenv('TOMBA_API_KEY'), 'X-Tomba-Secret' => getenv('TOMBA_API_SECRET') ] ]); $person = json_decode($response->getBody())->data; return [ 'name' => $person->full_name ?? null, 'position' => $person->position ?? null, 'company' => $person->company->organization ?? null, 'location' => "{$person->location->city}, {$person->location->country_code}", 'linkedin' => $person->linkedin ?? null, // Bonus fields 'phone' => $person->phone_number ?? null, 'email_valid' => ($person->verification->status ?? '') === 'valid', 'email_score' => $person->verification->score ?? 0, 'company_revenue' => $person->company->revenue ?? null, 'company_employees' => $person->company->employees ?? null ]; } catch (\GuzzleHttp\Exception\ClientException $e) { if ($e->getResponse()->getStatusCode() === 404) { return null; } throw $e; } } // Usage $person = getPerson('john@stripe.com'); print_r($person);`
### Ruby[](https://docs.tomba.io/migration/clearbit/person-api#ruby)
**Before (Clearbit):**
Code
`require 'clearbit' Clearbit.key = 'sk_clearbit_xxx' def get_person(email) person = Clearbit::Enrichment::Person.find(email: email) { name: person.name&.fullName, position: person.employment&.title, company: person.employment&.name, location: "#{person.geo&.city}, #{person.geo&.countryCode}", linkedin: person.linkedin&.handle } rescue Clearbit::NotFoundError nil end`
**After (Tomba):**
Code
`require 'httparty' def get_person(email) response = HTTParty.get( 'https://api.tomba.io/v1/people/find', query: { email: email }, headers: { 'X-Tomba-Key' => ENV['TOMBA_API_KEY'], 'X-Tomba-Secret' => ENV['TOMBA_API_SECRET'] } ) return nil if response.code == 404 raise "API Error: #{response.code}" unless response.success? person = response.parsed_response['data'] { name: person['full_name'], position: person['position'], company: person.dig('company', 'organization'), location: "#{person.dig('location', 'city')}, #{person.dig('location', 'country_code')}", linkedin: person['linkedin'], # Bonus fields phone: person['phone_number'], email_valid: person.dig('verification', 'status') == 'valid', email_score: person.dig('verification', 'score'), company_revenue: person.dig('company', 'revenue'), company_employees: person.dig('company', 'employees') } end # Usage person = get_person('john@stripe.com') puts person`
* * *
Enhanced Features[](https://docs.tomba.io/migration/clearbit/person-api#enhanced-features)
-------------------------------------------------------------------------------------------
### Free Email Verification[](https://docs.tomba.io/migration/clearbit/person-api#free-email-verification)
Every person lookup includes FREE email verification:
Code
`const person = response.data.data; console.log("Email Status:", person.verification.status); // valid/invalid/unknown console.log("Deliverable:", person.verification.result); // deliverable/undeliverable console.log("Score:", person.verification.score); // 0-100 console.log("SMTP Check:", person.verification.smtp_check); // true/false console.log("Disposable:", person.verification.disposable); // false console.log("Free Email:", person.verification.free_email); // false (Gmail, etc.)`
**Value:** Clearbit charges $0.01 per verification. With Tomba, it's FREE!
### Phone Numbers[](https://docs.tomba.io/migration/clearbit/person-api#phone-numbers)
Get validated phone numbers:
Code
`const person = response.data.data; if (person.phone_number) { console.log("Phone:", person.phone_number); // +1-415-555-0123 // You can also use phone validator endpoint for more details const phoneDetails = await axios.get( "https://api.tomba.io/v1/phone-validator", { params: { phone: person.phone_number }, headers: { /* auth headers */ }, }, ); console.log("Carrier:", phoneDetails.data.data.carrier); console.log("Location:", phoneDetails.data.data.location); console.log("Type:", phoneDetails.data.data.line_type); // mobile/landline }`
### Enhanced Company Data[](https://docs.tomba.io/migration/clearbit/person-api#enhanced-company-data)
Get full company information with person data:
Code
`const person = response.data.data; console.log("Company Info:"); console.log("- Name:", person.company.organization); console.log("- Revenue:", person.company.revenue); console.log("- Employees:", person.company.employees); console.log("- Industry:", person.company.industry); console.log("- Website:", person.company.website); console.log("- Logo:", person.company.logo);`
### Data Sources[](https://docs.tomba.io/migration/clearbit/person-api#data-sources)
See where the data came from:
Code
``const person = response.data.data; console.log("Data Sources:"); person.sources.forEach((source) => { console.log(`- ${source.uri}`); console.log(` Found on: ${source.website_piece}`); console.log(` Last seen: ${source.last_seen_on}`); });``
* * *
Error Handling[](https://docs.tomba.io/migration/clearbit/person-api#error-handling)
-------------------------------------------------------------------------------------
### Clearbit Errors[](https://docs.tomba.io/migration/clearbit/person-api#clearbit-errors)
Code
`try { const person = await clearbit.Person.find({ email }); } catch (error) { if (error.type === "not_found") { // Person not found } else if (error.type === "rate_limit") { // Rate limited } else if (error.type === "invalid_request") { // Bad request } }`
### Tomba Errors[](https://docs.tomba.io/migration/clearbit/person-api#tomba-errors)
Code
`try { const response = await axios.get("https://api.tomba.io/v1/people/find", { params: { email }, headers: { "X-Tomba-Key": process.env.TOMBA_API_KEY, "X-Tomba-Secret": process.env.TOMBA_API_SECRET, }, }); } catch (error) { if (error.response?.status === 404) { // Person not found console.log("Person not found in database"); } else if (error.response?.status === 429) { // Rate limited console.log("Rate limit exceeded"); } else if (error.response?.status === 400) { // Bad request console.log("Invalid email format"); } else if (error.response?.status === 401) { // Authentication failed console.log("Invalid API credentials"); } }`
* * *
Testing[](https://docs.tomba.io/migration/clearbit/person-api#testing)
-----------------------------------------------------------------------
### Sample Test Cases[](https://docs.tomba.io/migration/clearbit/person-api#sample-test-cases)
Code
`const assert = require("assert"); describe("Person API Migration", () => { it("should return person data for valid email", async () => { const person = await getPerson("john@stripe.com"); assert(person.name); assert(person.position); assert(person.company); assert(person.emailValid !== undefined); // New field }); it("should return null for non-existent email", async () => { const person = await getPerson("notexist@example12345.com"); assert.strictEqual(person, null); }); it("should include email verification", async () => { const person = await getPerson("valid@stripe.com"); assert(person.emailValid === true); assert(person.emailScore > 0); }); it("should include phone number when available", async () => { const person = await getPerson("john@stripe.com"); // Phone may or may not be available if (person.phone) { assert(person.phone.startsWith("+")); } }); it("should include enhanced company data", async () => { const person = await getPerson("john@stripe.com"); assert(person.companyRevenue); assert(person.companyEmployees); }); });`
* * *
Migration Checklist[](https://docs.tomba.io/migration/clearbit/person-api#migration-checklist)
-----------------------------------------------------------------------------------------------
* [ ] Update authentication to use API Key + Secret headers
* [ ] Change base URL to `api.tomba.io/v1`
* [ ] Update field mappings in your code
* [ ] Add handling for new fields (verification, phone\_number, company.\*)
* [ ] Update error handling for Tomba response codes
* [ ] Test with sample emails
* [ ] Update type definitions/interfaces
* [ ] Test edge cases (invalid emails, rate limits)
* [ ] Deploy to staging environment
* [ ] Monitor API responses
* [ ] Deploy to production
* * *
Next Steps[](https://docs.tomba.io/migration/clearbit/person-api#next-steps)
-----------------------------------------------------------------------------
* [Company API Migration](https://docs.tomba.io/migration/clearbit/company-api)
- Enrich company data
* [Combined API Migration](https://docs.tomba.io/migration/clearbit/combined-api)
- Get person + company data
* [Full API Documentation](https://docs.tomba.io/)
* * *
**Need help with migration?**
Contact our support team at [support@tomba.io](mailto:support@tomba.io)
for personalized migration assistance.
Last modified on November 16, 2025
[Clearbit Company API Replacement](https://docs.tomba.io/migration/clearbit/company-api)
[Clearbit Combined API Replacement](https://docs.tomba.io/migration/clearbit/combined-api)
JSON
JSON
Javascript
Javascript
PHP
PHP
Ruby
Ruby
Javascript
Javascript
Javascript
Javascript
Javascript
Javascript
Javascript
---
# Tomba Local MCP LLM Integration | Tomba Documentation
Menu
LLM Integration Guide[](https://docs.tomba.io/llm/local-mcp/integration#llm-integration-guide)
-----------------------------------------------------------------------------------------------
This guide shows how to integrate the Tomba MCP Server with popular Large Language Models and AI applications. The server works with any MCP-compatible client through standardized JSON-RPC communication.
Supported LLM Applications[](https://docs.tomba.io/llm/local-mcp/integration#supported-llm-applications)
---------------------------------------------------------------------------------------------------------
### Primary Support[](https://docs.tomba.io/llm/local-mcp/integration#primary-support)
* **Claude Desktop** - Native MCP support
* **Claude API** - Via MCP SDK integration
* **Custom LLM Applications** - Using MCP SDK
* **Anthropic Workbench** - Direct integration
### Community Integrations[](https://docs.tomba.io/llm/local-mcp/integration#community-integrations)
* **OpenAI GPT** - Via MCP bridge implementations
* **Local LLMs** - Through MCP-compatible frameworks
* **AI Agents** - LangChain, CrewAI, AutoGPT integrations
Integration Architecture[](https://docs.tomba.io/llm/local-mcp/integration#integration-architecture)
-----------------------------------------------------------------------------------------------------
Code
`graph TB A[LLM Application] --> B[MCP Client SDK] B --> C[JSON-RPC over stdio] C --> D[Tomba MCP Server] D --> E[Tomba.io API] subgraph "Your Application" A B end subgraph "MCP Server" D F[Tool Registry] G[Type Validation] H[Error Handling] end subgraph "External API" E end`
Client Configuration Files[](https://docs.tomba.io/llm/local-mcp/integration#client-configuration-files)
---------------------------------------------------------------------------------------------------------
### Claude Desktop Configuration[](https://docs.tomba.io/llm/local-mcp/integration#claude-desktop-configuration)
**File Location**:
* **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
* **Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
**Configuration**:
Code
`{ "mcpServers": { "tomba": { "command": "npx", "args": ["-y", "tomba-mcp-server"], "env": { "TOMBA_API_KEY": "your_api_key_here", "TOMBA_SECRET_KEY": "your_secret_key_here" } } } }`
### Claude Desktop Integration[](https://docs.tomba.io/llm/local-mcp/integration#claude-desktop-integration)
How to Install Tomba MCP in Claude Desktop:
1. **Open Claude Desktop Settings**
Click on **Settings** in Claude Desktop application.
2. **Browse Extensions**
Click to browse the **Extensions** section.
3. **Go to Desktop Extensions**
Click on the **Desktop extensions** tab.
4. **Search for Tomba**
Search for "Tomba" in the extensions search bar.
5. **Install and Configure**
Install the Tomba extension and configure it with your API key and API secret from your [Tomba dashboard](https://app.tomba.io/api)
.
### Claude API Integration[](https://docs.tomba.io/llm/local-mcp/integration#claude-api-integration)
**Installation**:
TerminalCode
`npm install @modelcontextprotocol/sdk`
**Client Code**:
Code
`import { Client } from "@modelcontextprotocol/sdk/client/index.js"; import { StdioClientTransport } from "@modelcontextprotocol/sdk/client/stdio.js"; const client = new Client( { name: "tomba-client", version: "1.0.0", }, { capabilities: { tools: {}, }, }, ); const transport = new StdioClientTransport({ command: "node", args: ["./dist/index.js"], env: { TOMBA_API_KEY: process.env.TOMBA_API_KEY, TOMBA_SECRET_KEY: process.env.TOMBA_SECRET_KEY, }, }); await client.connect(transport); // Use the tools const result = await client.callTool({ name: "domain_search", arguments: { domain: "github.com", limit: 10, }, });`
Configuration Templates[](https://docs.tomba.io/llm/local-mcp/integration#configuration-templates)
---------------------------------------------------------------------------------------------------
### Basic Configuration[](https://docs.tomba.io/llm/local-mcp/integration#basic-configuration)
Create `mcp-config.json`:
Code
`{ "servers": { "tomba": { "command": "npx", "args": ["-y", "tomba-mcp-server"], "environment": { "TOMBA_API_KEY": "${TOMBA_API_KEY}", "TOMBA_SECRET_KEY": "${TOMBA_SECRET_KEY}" } } } }`
### Development Configuration[](https://docs.tomba.io/llm/local-mcp/integration#development-configuration)
Create `mcp-dev-config.json`:
Code
`{ "servers": { "tomba-dev": { "command": "npm", "args": ["run", "dev"], "cwd": "./tomba-mcp-server", "environment": { "TOMBA_API_KEY": "test_key_123", "TOMBA_SECRET_KEY": "test_secret_456", "NODE_ENV": "development", "DEBUG": "tomba:*" } } } }`
### Production Configuration[](https://docs.tomba.io/llm/local-mcp/integration#production-configuration)
Create `mcp-prod-config.json`:
Code
`{ "servers": { "tomba-prod": { "command": "node", "args": ["./tomba-mcp-server/dist/index.js"], "environment": { "TOMBA_API_KEY": "${TOMBA_API_KEY}", "TOMBA_SECRET_KEY": "${TOMBA_SECRET_KEY}", "NODE_ENV": "production" }, "restart": true, "timeout": 30000 } } }`
Usage Examples by LLM[](https://docs.tomba.io/llm/local-mcp/integration#usage-examples-by-llm)
-----------------------------------------------------------------------------------------------
### Claude Desktop Usage[](https://docs.tomba.io/llm/local-mcp/integration#claude-desktop-usage)
Once configured, you can use natural language:
**Email Discovery**:
Code
`"Find all email addresses for github.com and show me the top 10 results"`
**Contact Verification**:
Code
`"Verify if the email satya.nadella@microsoft.com is deliverable and show me the confidence score"`
**Lead Generation**:
Code
`"Search for the email of John Doe at Apple Inc and enrich it with social profiles"`
### Claude API Integration[](https://docs.tomba.io/llm/local-mcp/integration#claude-api-integration-1)
Code
`import json import subprocess from typing import Dict, Any class TombaMCPClient: def __init__(self, api_key: str, secret_key: str): self.env = { 'TOMBA_API_KEY': api_key, 'TOMBA_SECRET_KEY': secret_key } def call_tool(self, tool_name: str, arguments: Dict[str, Any]) -> Dict: request = { "jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": { "name": tool_name, "arguments": arguments } } process = subprocess.Popen( ['node', './dist/index.js'], stdin=subprocess.PIPE, stdout=subprocess.PIPE, env=self.env, text=True ) stdout, _ = process.communicate(json.dumps(request)) return json.loads(stdout) def find_domain_emails(self, domain: str, limit: int = 10): return self.call_tool('domain_search', { 'domain': domain, 'limit': limit }) def verify_email(self, email: str): return self.call_tool('email_verifier', { 'email': email }) # Usage client = TombaMCPClient('your_api_key', 'your_secret_key') emails = client.find_domain_emails('github.com', 5) print(json.dumps(emails, indent=2))`
### Custom LLM Integration[](https://docs.tomba.io/llm/local-mcp/integration#custom-llm-integration)
Code
`// For custom LLM applications class TombaIntegration { constructor(mcpServerPath, apiKey, secretKey) { this.serverPath = mcpServerPath; this.env = { TOMBA_API_KEY: apiKey, TOMBA_SECRET_KEY: secretKey, }; } async initializeConnection() { const { spawn } = require("child_process"); this.serverProcess = spawn("node", [this.serverPath], { env: this.env, stdio: ["pipe", "pipe", "pipe"], }); // Initialize MCP protocol await this.sendRequest({ jsonrpc: "2.0", id: 1, method: "initialize", params: { protocolVersion: "2024-11-05", capabilities: {}, clientInfo: { name: "custom-llm-client", version: "1.0.0", }, }, }); } async sendRequest(request) { return new Promise((resolve) => { this.serverProcess.stdin.write(JSON.stringify(request) + "\n"); this.serverProcess.stdout.once("data", (data) => { resolve(JSON.parse(data.toString())); }); }); } async searchDomain(domain, limit = 10) { return this.sendRequest({ jsonrpc: "2.0", id: Date.now(), method: "tools/call", params: { name: "domain_search", arguments: { domain, limit }, }, }); } } // Usage with your LLM const tomba = new TombaIntegration("./dist/index.js", "api_key", "secret_key"); await tomba.initializeConnection(); // In your LLM tool handling code if (toolCall.name === "search_emails") { const result = await tomba.searchDomain(toolCall.arguments.domain); return result.content[0].text; }`
Framework Integrations[](https://docs.tomba.io/llm/local-mcp/integration#framework-integrations)
-------------------------------------------------------------------------------------------------
### LangChain Integration[](https://docs.tomba.io/llm/local-mcp/integration#langchain-integration)
Code
`from langchain.tools import BaseTool from langchain.pydantic_v1 import BaseModel, Field import subprocess import json class DomainSearchInput(BaseModel): domain: str = Field(description="Domain name to search") limit: int = Field(default=10, description="Maximum results") class TombaDomainSearchTool(BaseTool): name = "domain_search" description = "Search for email addresses in a domain" args_schema = DomainSearchInput def _run(self, domain: str, limit: int = 10) -> str: request = { "jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": { "name": "domain_search", "arguments": {"domain": domain, "limit": limit} } } process = subprocess.Popen( ['node', './tomba-mcp-server/dist/index.js'], stdin=subprocess.PIPE, stdout=subprocess.PIPE, env={'TOMBA_API_KEY': 'your_key', 'TOMBA_SECRET_KEY': 'your_secret'}, text=True ) stdout, _ = process.communicate(json.dumps(request)) result = json.loads(stdout) return result['content'][0]['text'] # Usage in LangChain from langchain.agents import initialize_agent, AgentType from langchain.llms import OpenAI llm = OpenAI() tools = [TombaDomainSearchTool()] agent = initialize_agent( tools, llm, agent=AgentType.ZERO_SHOT_REACT_DESCRIPTION ) result = agent.run("Find email addresses for github.com")`
### CrewAI Integration[](https://docs.tomba.io/llm/local-mcp/integration#crewai-integration)
Code
`from crewai import Agent, Task, Crew from crewai_tools import tool import subprocess import json @tool("Domain Email Search") def search_domain_emails(domain: str) -> str: """Search for email addresses in a domain using Tomba.io""" request = { "jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": { "name": "domain_search", "arguments": {"domain": domain, "limit": 10} } } process = subprocess.run( ['node', './tomba-mcp-server/dist/index.js'], input=json.dumps(request), capture_output=True, text=True, env={'TOMBA_API_KEY': 'your_key', 'TOMBA_SECRET_KEY': 'your_secret'} ) result = json.loads(process.stdout) return result['content'][0]['text'] # Create agents researcher = Agent( role='Email Researcher', goal='Find contact information for target companies', tools=[search_domain_emails], backstory="Expert at finding business contacts" ) # Create tasks research_task = Task( description="Find email addresses for github.com and microsoft.com", agent=researcher ) # Create crew crew = Crew( agents=[researcher], tasks=[research_task] ) result = crew.kickoff()`
Template Files[](https://docs.tomba.io/llm/local-mcp/integration#template-files)
---------------------------------------------------------------------------------
### Complete Claude Desktop Config[](https://docs.tomba.io/llm/local-mcp/integration#complete-claude-desktop-config)
Save as `claude_desktop_config.json`:
Code
`{ "mcpServers": { "tomba": { "command": "node", "args": ["/absolute/path/to/tomba-mcp-server/dist/index.js"], "env": { "TOMBA_API_KEY": "ta_xxxxxxxxxx", "TOMBA_SECRET_KEY": "ts_xxxxxxxxxx" } } }, "globalShortcuts": { "toggleClaudeDesktop": "Cmd+Shift+C" }, "appearance": { "theme": "auto" } }`
### Docker Compose Configuration[](https://docs.tomba.io/llm/local-mcp/integration#docker-compose-configuration)
Save as `docker-compose.yml`:
Code
`version: "3.8" services: tomba-mcp-server: build: . environment: - TOMBA_API_KEY=${TOMBA_API_KEY} - TOMBA_SECRET_KEY=${TOMBA_SECRET_KEY} volumes: - ./dist:/app/dist:ro stdin_open: true tty: true`
### Systemd Service File[](https://docs.tomba.io/llm/local-mcp/integration#systemd-service-file)
Save as `/etc/systemd/system/tomba-mcp.service`:
Code
`[Unit] Description=Tomba MCP Server After=network.target [Service] Type=simple User=mcpuser WorkingDirectory=/opt/tomba-mcp-server ExecStart=/usr/bin/node dist/index.js Environment=TOMBA_API_KEY=your_api_key Environment=TOMBA_SECRET_KEY=your_secret_key Restart=always RestartSec=5 [Install] WantedBy=multi-user.target`
Security Configuration[](https://docs.tomba.io/llm/local-mcp/integration#security-configuration)
-------------------------------------------------------------------------------------------------
### Environment Variables[](https://docs.tomba.io/llm/local-mcp/integration#environment-variables)
**Secure .env setup**:
TerminalCode
`# Create secure .env file umask 077 echo "TOMBA_API_KEY=your_key" > .env echo "TOMBA_SECRET_KEY=your_secret" >> .env chmod 600 .env`
### API Key Management[](https://docs.tomba.io/llm/local-mcp/integration#api-key-management)
**Using environment variables**:
TerminalCode
`export TOMBA_API_KEY="ta_your_api_key" export TOMBA_SECRET_KEY="ts_your_secret_key"`
**Using keychain (macOS)**:
TerminalCode
`security add-generic-password -a "tomba-mcp" -s "api-key" -w "your_api_key" security add-generic-password -a "tomba-mcp" -s "secret-key" -w "your_secret"`
**Reading from keychain**:
TerminalCode
`export TOMBA_API_KEY=$(security find-generic-password -a "tomba-mcp" -s "api-key" -w) export TOMBA_SECRET_KEY=$(security find-generic-password -a "tomba-mcp" -s "secret-key" -w)`
Monitoring & Logging[](https://docs.tomba.io/llm/local-mcp/integration#monitoring--logging)
--------------------------------------------------------------------------------------------
### Log Configuration[](https://docs.tomba.io/llm/local-mcp/integration#log-configuration)
Code
`{ "logging": { "level": "info", "format": "json", "outputs": [ { "type": "file", "path": "/var/log/tomba-mcp.log", "rotation": "daily" }, { "type": "console", "format": "pretty" } ] } }`
### Health Check Endpoint[](https://docs.tomba.io/llm/local-mcp/integration#health-check-endpoint)
Code
`// Add to your client application async function healthCheck() { try { const result = await client.listTools(); return result.tools.length > 0; } catch (error) { console.error("Health check failed:", error); return false; } }`
Error Handling[](https://docs.tomba.io/llm/local-mcp/integration#error-handling)
---------------------------------------------------------------------------------
### Retry Logic[](https://docs.tomba.io/llm/local-mcp/integration#retry-logic)
Code
`async function callToolWithRetry(toolName, arguments, maxRetries = 3) { for (let attempt = 1; attempt <= maxRetries; attempt++) { try { return await client.callTool({ name: toolName, arguments }); } catch (error) { if (attempt === maxRetries) throw error; const delay = Math.pow(2, attempt) * 1000; // Exponential backoff await new Promise((resolve) => setTimeout(resolve, delay)); } } }`
### Rate Limit Handling[](https://docs.tomba.io/llm/local-mcp/integration#rate-limit-handling)
Code
``async function handleRateLimit(error) { if (error.code === 429) { const retryAfter = error.headers?.["retry-after"] || 60; console.log(`Rate limited. Waiting ${retryAfter} seconds...`); await new Promise((resolve) => setTimeout(resolve, retryAfter * 1000)); return true; // Indicate retry should be attempted } return false; }``
Testing LLM Integration[](https://docs.tomba.io/llm/local-mcp/integration#testing-llm-integration)
---------------------------------------------------------------------------------------------------
### Integration Test Script[](https://docs.tomba.io/llm/local-mcp/integration#integration-test-script)
Code
`// test-llm-integration.js const { spawn } = require("child_process"); async function testLLMIntegration() { console.log("🧪 Testing LLM Integration..."); // Start MCP server const serverProcess = spawn("node", ["dist/index.js"], { env: { TOMBA_API_KEY: process.env.TOMBA_API_KEY, TOMBA_SECRET_KEY: process.env.TOMBA_SECRET_KEY, }, stdio: ["pipe", "pipe", "pipe"], }); // Test tool listing const listRequest = { jsonrpc: "2.0", id: 1, method: "tools/list", }; serverProcess.stdin.write(JSON.stringify(listRequest) + "\n"); return new Promise((resolve) => { serverProcess.stdout.on("data", (data) => { const response = JSON.parse(data.toString()); console.log("Tools available:", response.result?.tools?.length); serverProcess.kill(); resolve(response); }); }); } testLLMIntegration();`
Deployment[](https://docs.tomba.io/llm/local-mcp/integration#deployment)
-------------------------------------------------------------------------
### Production Deployment[](https://docs.tomba.io/llm/local-mcp/integration#production-deployment)
1. **Build the server**:
TerminalCode
`npm run build`
2. **Configure environment**:
TerminalCode
`export TOMBA_API_KEY="production_key" export TOMBA_SECRET_KEY="production_secret" export NODE_ENV="production"`
3. **Start with process manager**:
TerminalCode
`pm2 start dist/index.js --name tomba-mcp-server`
### Scaling Considerations[](https://docs.tomba.io/llm/local-mcp/integration#scaling-considerations)
* **Multiple Instances**: Run multiple server instances for load distribution
* **Load Balancing**: Use nginx or similar for request distribution
* **Monitoring**: Implement health checks and performance monitoring
* **Logging**: Centralized logging for debugging and analysis
* * *
Your Tomba MCP Server is now ready for LLM integration! Choose the configuration that matches your setup and start leveraging powerful email intelligence in your AI applications.
Last modified on February 11, 2026
[Tomba Local MCP Tools](https://docs.tomba.io/llm/local-mcp/tools)
[Remote MCP Server - Introduction](https://docs.tomba.io/llm/remote-mcp/introduction)
JSON
Javascript
JSON
JSON
JSON
Javascript
JSON
YAML
JSON
Javascript
Javascript
Javascript
Javascript
---
# Migrate from NeverBounce to Tomba | Tomba Documentation
Menu
This guide will help you seamlessly transition from NeverBounce to Tomba's email verification service, offering better accuracy, more data attributes, and competitive pricing.
* * *
Why Choose Tomba Over NeverBounce?[](https://docs.tomba.io/migration/email-verifier/neverbounce#why-choose-tomba-over-neverbounce)
-----------------------------------------------------------------------------------------------------------------------------------
| Feature | NeverBounce | Tomba |
| --- | --- | --- |
| **Accuracy** | 95-98% | 99%+ |
| **Pricing** | $0.008 per email | More competitive rates |
| **Catchall Detection** | Basic | Advanced with confidence scoring |
| **Speed** | Fast | Ultra-fast with optimized infrastructure |
| **Bulk Verification** | Yes | Yes, with better batch processing |
| **API Access** | REST API | REST API + MCP integration |
| **Data Attributes** | Basic verification data | Rich attributes including SMTP provider, MX records, risk scoring |
| **Real-time Verification** | Yes | Yes, with 3-month smart caching |
| **Webmail Detection** | Limited | Advanced with provider identification |
* * *
Key Advantages of Tomba[](https://docs.tomba.io/migration/email-verifier/neverbounce#key-advantages-of-tomba)
--------------------------------------------------------------------------------------------------------------
### 1\. Superior Accuracy[](https://docs.tomba.io/migration/email-verifier/neverbounce#1-superior-accuracy)
Tomba achieves 99%+ accuracy through:
* Multi-layered verification process
* Real-time SMTP checks
* Advanced pattern recognition
* Machine learning algorithms
### 2\. Better Pricing[](https://docs.tomba.io/migration/email-verifier/neverbounce#2-better-pricing)
* More cost-effective per verification
* No hidden fees
* Flexible credit-based system
* Credits roll over monthly
### 3\. Advanced Catchall Detection[](https://docs.tomba.io/migration/email-verifier/neverbounce#3-advanced-catchall-detection)
* Confidence scoring for catch-all domains
* Risk assessment for accept-all addresses
* Better decision-making data
### 4\. Faster Processing[](https://docs.tomba.io/migration/email-verifier/neverbounce#4-faster-processing)
* Optimized infrastructure for speed
* Parallel processing for bulk operations
* Smart caching for instant results
### 5\. Richer Data Attributes[](https://docs.tomba.io/migration/email-verifier/neverbounce#5-richer-data-attributes)
Tomba returns comprehensive verification data including 15+ attributes:
* `status`: valid, invalid, accept\_all, webmail, disposable, unknown
* `result`: deliverable, undeliverable, risky
* `score`: Confidence score (0-100)
* `smtp_provider`: Email service provider identification (e.g., "Google Workspace")
* `mx`: Complete MX records array
* `mx_check`: MX record validation
* `smtp_server`: SMTP server availability
* `smtp_check`: SMTP validation status
* `accept_all`: Catch-all domain detection
* `disposable`: Temporary email detection
* `webmail`: Public email provider detection
* `block`: Blacklist status
* `gibberish`: Random pattern detection
* `greylisted`: Greylisting detection
* `regex`: Email format validation
* `whois`: Domain registration details (registrar, creation date, referral URL)
* `sources`: Array of sources where email was found (URI, website, dates, availability)
**Example comprehensive response:**
Code
`{ "data": { "email": { "email": "dayna.winter@shopify.com", "result": "deliverable", "status": "valid", "score": 99, "smtp_provider": "Google Workspace", "mx": { "records": [ "aspmx.l.google.com", "alt1.aspmx.l.google.com", "alt2.aspmx.l.google.com", "alt4.aspmx.l.google.com", "alt3.aspmx.l.google.com" ] }, "mx_check": true, "smtp_server": true, "smtp_check": true, "accept_all": true, "greylisted": false, "block": false, "gibberish": false, "disposable": false, "webmail": false, "regex": true, "whois": { "registrar_name": "markmonitor inc.", "referral_url": "http://www.markmonitor.com", "created_date": "2005-03-11T06:18:03+01:00" } }, "sources": [ { "uri": "https://www.shopify.com/blog/black-friday-cyber-monday-shopify-apps", "website_url": "www.shopify.com", "extracted_on": "2022-11-07T13:16:42+01:00", "last_seen_on": "2022-11-07T13:16:42+01:00", "still_on_page": true } ] } }`
* * *
Migration Steps[](https://docs.tomba.io/migration/email-verifier/neverbounce#migration-steps)
----------------------------------------------------------------------------------------------
### Step 1: Get Your Tomba API Credentials[](https://docs.tomba.io/migration/email-verifier/neverbounce#step-1-get-your-tomba-api-credentials)
1. Sign up at [app.tomba.io](https://app.tomba.io/)
2. Navigate to **API** → **API Keys**
3. Copy your **API Key** and **Secret Key**
### Step 2: Update API Endpoints[](https://docs.tomba.io/migration/email-verifier/neverbounce#step-2-update-api-endpoints)
**NeverBounce endpoint:**
Code
`POST https://api.neverbounce.com/v4/single/check`
**Tomba endpoint:**
Code
`GET https://api.tomba.io/v1/email-verifier?email={email}`
### Step 3: Update Authentication[](https://docs.tomba.io/migration/email-verifier/neverbounce#step-3-update-authentication)
**NeverBounce authentication:**
Code
`{ "key": "your_neverbounce_key", "email": "test@example.com" }`
**Tomba authentication:**
Code
`// Headers { "X-Tomba-Key": "your_api_key", "X-Tomba-Secret": "your_secret_key" }`
### Step 4: Update Response Mapping[](https://docs.tomba.io/migration/email-verifier/neverbounce#step-4-update-response-mapping)
**NeverBounce response:**
Code
`{ "status": "success", "result": "valid", "flags": ["has_dns", "has_known_bounces"], "suggested_correction": "", "execution_time": 208 }`
**Tomba response:**
Code
`{ "data": { "email": "test@example.com", "status": "valid", "result": "deliverable", "score": 100, "regex": true, "mx_records": true, "smtp_server": true, "smtp_check": true, "smtp_provider": "Google Workspace", "accept_all": false, "block": false, "disposable": false, "webmail": false } }`
* * *
Code Migration Examples[](https://docs.tomba.io/migration/email-verifier/neverbounce#code-migration-examples)
--------------------------------------------------------------------------------------------------------------
### Node.js[](https://docs.tomba.io/migration/email-verifier/neverbounce#nodejs)
**Before (NeverBounce):**
Code
`const axios = require("axios"); async function verifyEmail(email) { const response = await axios.post( "https://api.neverbounce.com/v4/single/check", { key: process.env.NEVERBOUNCE_KEY, email: email, }, ); return response.data.result; }`
**After (Tomba):**
Code
``const axios = require("axios"); async function verifyEmail(email) { const response = await axios.get(`https://api.tomba.io/v1/email-verifier`, { params: { email: email }, headers: { "X-Tomba-Key": process.env.TOMBA_KEY, "X-Tomba-Secret": process.env.TOMBA_SECRET, }, }); return response.data.data; }``
### Python[](https://docs.tomba.io/migration/email-verifier/neverbounce#python)
**Before (NeverBounce):**
Code
`import requests def verify_email(email): response = requests.post( 'https://api.neverbounce.com/v4/single/check', json={ 'key': os.environ['NEVERBOUNCE_KEY'], 'email': email } ) return response.json()['result']`
**After (Tomba):**
Code
`import requests def verify_email(email): response = requests.get( 'https://api.tomba.io/v1/email-verifier', params={'email': email}, headers={ 'X-Tomba-Key': os.environ['TOMBA_KEY'], 'X-Tomba-Secret': os.environ['TOMBA_SECRET'] } ) return response.json()['data']`
### PHP[](https://docs.tomba.io/migration/email-verifier/neverbounce#php)
**Before (NeverBounce):**
Code
` $_ENV['NEVERBOUNCE_KEY'], 'email' => $email ]; $ch = curl_init('https://api.neverbounce.com/v4/single/check'); curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data)); curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); $response = curl_exec($ch); curl_close($ch); return json_decode($response)->result; }`
**After (Tomba):**
Code
`data; }`
* * *
Status Mapping[](https://docs.tomba.io/migration/email-verifier/neverbounce#status-mapping)
--------------------------------------------------------------------------------------------
| NeverBounce Status | Tomba Status | Tomba Result |
| --- | --- | --- |
| `valid` | `valid` | `deliverable` |
| `invalid` | `invalid` | `undeliverable` |
| `disposable` | `disposable` | `undeliverable` |
| `catchall` | `accept_all` | `risky` |
| `unknown` | `unknown` | `risky` |
* * *
Bulk Verification Migration[](https://docs.tomba.io/migration/email-verifier/neverbounce#bulk-verification-migration)
----------------------------------------------------------------------------------------------------------------------
**NeverBounce bulk process:**
1. Upload CSV file
2. Wait for processing
3. Download results
**Tomba bulk process:**
1. Use bulk verification API endpoint
2. Real-time or batch processing
Code
`// Tomba Bulk Verification const bulkVerify = async (emails) => { const response = await axios.post( "https://api.tomba.io/v1/bulk/email-verifier", { emails: emails }, { headers: { "X-Tomba-Key": process.env.TOMBA_KEY, "X-Tomba-Secret": process.env.TOMBA_SECRET, }, }, ); return response.data; };`
* * *
Testing Your Migration[](https://docs.tomba.io/migration/email-verifier/neverbounce#testing-your-migration)
------------------------------------------------------------------------------------------------------------
1. **Run parallel tests**: Verify the same emails with both services
2. **Compare results**: Check accuracy and data completeness
3. **Performance testing**: Measure response times
4. **Cost analysis**: Calculate actual costs per verification
5. **Gradual rollout**: Start with a small percentage of traffic
* * *
Support and Resources[](https://docs.tomba.io/migration/email-verifier/neverbounce#support-and-resources)
----------------------------------------------------------------------------------------------------------
* [Tomba API Documentation](https://docs.tomba.io/)
* [Email Verifier Attributes](https://docs.tomba.io/attributes/verifier)
* [Bulk Verification Guide](https://docs.tomba.io/bulks/email-verifier)
* [Support Portal](https://help.tomba.io/)
Need help with migration? Contact our support team for personalized assistance.
* * *
FAQ[](https://docs.tomba.io/migration/email-verifier/neverbounce#faq)
----------------------------------------------------------------------
**Q: Will I lose any features by switching?** A: No, Tomba provides all NeverBounce features plus additional data attributes and insights.
**Q: How long does migration take?** A: Most migrations can be completed in under an hour with our straightforward API.
**Q: Can I test before fully migrating?** A: Yes! Sign up for a free account with 25 verifications to test the service.
**Q: What about my existing credits?** A: Plan your transition timing to use remaining NeverBounce credits before switching.
**Q: Do you offer migration support?** A: Yes, our team can help with code review and migration assistance for enterprise customers.
Last modified on November 16, 2025
[Migrate to Tomba Email Verifier](https://docs.tomba.io/migration/email-verifier/introduction)
[Migrate from MillionVerifier to Tomba](https://docs.tomba.io/migration/email-verifier/millionverifier)
JSON
Javascript
Javascript
JSON
JSON
Javascript
Javascript
PHP
PHP
Javascript
---
# Editor Setup | Tomba Documentation
Menu
Use code editors, LLMs (large language models), and MCP (Model Context Protocol) servers to generate API calls and examples for the Tomba platform.
Pick Your Tool[](https://docs.tomba.io/llm/editor/setup#pick-your-tool)
------------------------------------------------------------------------
Set up your editor and model so they can generate accurate Tomba API code from your prompt.
The `docs.tomba.io/llms.txt` file is a compact, text version of Tomba API docs to help AI generate accurate Tomba API code based on your prompt.
Code
`Use https://docs.tomba.io/llms.txt as the primary reference. Generate a Node.js example that verifies an email with headers X-Tomba-Key and X-Tomba-Secret. Return complete, runnable code with error handling.`
[\
\
VSCode\
\
Setup VSCode and GitHub Copilot with Tomba API documentation](https://docs.tomba.io/llm/editor/vscode)
[\
\
Cursor\
\
Setup Cursor AI with Tomba API integration](https://docs.tomba.io/llm/editor/cursor)
[\
\
Zed\
\
Setup Zed editor with AI assistance for Tomba API](https://docs.tomba.io/llm/editor/zed)
[\
\
Windsurf\
\
Setup Windsurf IDE with Tomba API capabilities](https://docs.tomba.io/llm/editor/windsurf)
[\
\
Claude Desktop\
\
Setup Claude Desktop with Tomba API documentation](https://docs.tomba.io/llm/editor/claude-desktop)
[\
\
Claude Code\
\
Setup Claude Code extension for VS Code](https://docs.tomba.io/llm/editor/claude-code)
[\
\
ChatGPT\
\
Use ChatGPT with Tomba API documentation](https://docs.tomba.io/llm/editor/chatgpt)
[\
\
Gemini\
\
Setup Google Gemini with Tomba API](https://docs.tomba.io/llm/editor/gemini)
[\
\
Grok\
\
Setup xAI Grok with Tomba API integration](https://docs.tomba.io/llm/editor/grok)
[\
\
Cline - VSCode\
\
Setup Cline extension for VS Code with Tomba API](https://docs.tomba.io/llm/editor/cline)
Last modified on April 28, 2026
[Setting Up Apify MCP Integration](https://docs.tomba.io/llm/apify/integration)
[VSCode Setup](https://docs.tomba.io/llm/editor/vscode)
---
# Error Handling | Tomba Documentation
Menu
When an API call fails, the API returns one of the following status codes:
* `401`: Invalid API key
* `429`: Rate limit exceeded
* `400`: Other error
* `404`: Invalid request
Code
`{ "errors": { "type": "unknown_route", "message": "Invalid request, please make sure you follow the documentation for proper syntax", "code": 404 } }`
Error Codes[](https://docs.tomba.io/error-handling#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. |
Example: Inspect Error Responses[](https://docs.tomba.io/error-handling#example-inspect-error-responses)
---------------------------------------------------------------------------------------------------------
Use `-i` to inspect both status code and headers:
TerminalCode
`curl -i -X GET "https://api.tomba.io/v1/domain-search?domain=" \ -H "X-Tomba-Key: your_api_key" \ -H "X-Tomba-Secret: your_secret_key"`
Handle API errors in JavaScript:
Code
`const res = await fetch("https://api.tomba.io/v1/domain-search?domain=", { headers: { "X-Tomba-Key": "your_api_key", "X-Tomba-Secret": "your_secret_key", }, }); if (!res.ok) { const err = await res.json(); console.error(res.status, err.errors?.message); }`
Last modified on April 28, 2026
[API Key and Authentication](https://docs.tomba.io/authentication)
[Usage Limits and Quotas](https://docs.tomba.io/usage-and-quotas)
JSON
Javascript
---
# Rust Client Library | Tomba Documentation
Menu
Installation[](https://docs.tomba.io/libraries/rust-email-finder#installation)
-------------------------------------------------------------------------------
Add this to your package's `Cargo.toml` file:
TOMLCode
`[dependencies] tomba = "0.1"`
Usage[](https://docs.tomba.io/libraries/rust-email-finder#usage)
-----------------------------------------------------------------
### Domain Search[](https://docs.tomba.io/libraries/rust-email-finder#domain-search)
Get email addresses found on the internet.
Code
`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[](https://docs.tomba.io/libraries/rust-email-finder#email-finder)
Find the verified email address of any professional.
Code
`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[](https://docs.tomba.io/libraries/rust-email-finder#email-verifier)
Verify the validity of any professional email address with the most complete email checker.
Code
`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)`
Last modified on April 28, 2026
[R Client Library](https://docs.tomba.io/libraries/r-email-finder)
[Ruby Client Library](https://docs.tomba.io/libraries/ruby-email-finder)
Rust
Rust
Rust
---
# Email Enrichment Bulk | Tomba Documentation
Menu
Overview[](https://docs.tomba.io/bulks/email-enrichment#overview)
------------------------------------------------------------------
[Bulk Email Enrichment](https://tomba.io/bulks/email-enrichment)
transforms basic email addresses into comprehensive contact profiles. Enhance your existing email lists with detailed personal and professional information about each contact.
### Key Features[](https://docs.tomba.io/bulks/email-enrichment#key-features)
* **Contact Profiling**: Add detailed information to existing email addresses
* **Professional Data**: Gather job titles, company information, and career details
* **Social Profiles**: Discover associated social media profiles
* **Bulk Processing**: Enrich up to 10,000 emails simultaneously
* **Data Accuracy**: High-quality, verified contact information
* **Export Options**: Multiple format options for enriched data
### How Email Enrichment Bulk Works[](https://docs.tomba.io/bulks/email-enrichment#how-email-enrichment-bulk-works)
1. **Upload Email List**: Provide a list of email addresses to enrich
2. **Select Enrichment Fields**: Choose what additional data to gather
3. **Process Enrichment**: Launch the bulk enrichment operation
4. **Review Enhanced Profiles**: Examine the enriched contact data
5. **Export Results**: Download comprehensive contact profiles
### Limitations[](https://docs.tomba.io/bulks/email-enrichment#limitations)
* Each Bulk is limited to 10,000 email addresses
* Additional rows will be skipped
* Some special or unexpected characters may be deleted in the file
* Invalid email addresses won't be imported
* Duplicate email addresses won't be imported
Go SDK Integration[](https://docs.tomba.io/bulks/email-enrichment#go-sdk-integration)
--------------------------------------------------------------------------------------
### Installation[](https://docs.tomba.io/bulks/email-enrichment#installation)
TerminalCode
`go get github.com/tomba-io/go`
### Basic Setup[](https://docs.tomba.io/bulks/email-enrichment#basic-setup)
Code
`package main import ( "fmt" "log" "github.com/tomba-io/go/tomba" "github.com/tomba-io/go/tomba/models" ) func main() { // Initialize Tomba client client := tomba.NewTomba("your-api-key", "your-secret-key") // Your enrichment code here }`
### Creating an Enrichment Bulk Operation[](https://docs.tomba.io/bulks/email-enrichment#creating-an-enrichment-bulk-operation)
Code
`// Create enrichment bulk with email list params := &models.BulkCreateParams{ Name: "Customer Email Enrichment - Q1 2024", List: "john.doe@example.com\njane.smith@company.com\nuser@startup.io", Sources: true, // Include data sources Verify: false, // Skip email verification Notifie: true, // Send completion notification } // Create the bulk operation response, err := client.CreateBulk(models.BulkTypeEnrich, params) if err != nil { log.Fatal("Failed to create enrichment bulk:", err) } fmt.Printf("Created enrichment bulk with ID: %d\n", *response.Data.ID)`
### Creating Enrichment Bulk with CSV File[](https://docs.tomba.io/bulks/email-enrichment#creating-enrichment-bulk-with-csv-file)
Code
`// Create enrichment bulk from CSV file params := &models.BulkCreateParams{ Name: "Email List Enrichment - Marketing Database", Delimiter: ",", Column: 1, // Email column (1-based index) Sources: true, Verify: false, } // Upload file and create bulk response, err := client.CreateBulkWithFile( models.BulkTypeEnrich, params, "/path/to/email-list.csv", ) if err != nil { log.Fatal("Failed to create bulk with file:", err) } bulkID := *response.Data.ID fmt.Printf("Created bulk operation: %d\n", bulkID)`
### Launching and Monitoring Enrichment[](https://docs.tomba.io/bulks/email-enrichment#launching-and-monitoring-enrichment)
Code
`// Launch the enrichment process launchResponse, err := client.LaunchBulk(models.BulkTypeEnrich, bulkID) if err != nil { log.Fatal("Failed to launch bulk:", err) } fmt.Println("Enrichment process started!") // Monitor progress for { progress, err := client.GetBulkProgress(models.BulkTypeEnrich, bulkID) if err != nil { log.Printf("Error checking progress: %v", err) break } fmt.Printf("Progress: %d%% (%d/%d processed)\n", progress.Progress, progress.Processed, progress.ProcessedEmail, ) if progress.Status { fmt.Println("Enrichment completed!") break } // Wait 30 seconds before checking again time.Sleep(30 * time.Second) }`
### Retrieving and Exporting Results[](https://docs.tomba.io/bulks/email-enrichment#retrieving-and-exporting-results)
Code
`// Get bulk details bulk, err := client.GetBulk(models.BulkTypeEnrich, bulkID) if err != nil { log.Fatal("Failed to get bulk details:", err) } fmt.Printf("Bulk Status: %v\n", bulk.Data[0].Status) fmt.Printf("Total Processed: %d\n", bulk.Data[0].Processed) // Download enriched results err = client.SaveBulkResults( models.BulkTypeEnrich, bulkID, "enriched-contacts.csv", "full", // Download type: "full", "valid", "not_found" ) if err != nil { log.Fatal("Failed to download results:", err) } fmt.Println("Results saved to enriched-contacts.csv")`
### Managing Enrichment Bulks[](https://docs.tomba.io/bulks/email-enrichment#managing-enrichment-bulks)
Code
`// List all enrichment bulks params := &models.BulkGetParams{ Page: 1, Limit: 20, Direction: "desc", Filter: "all", // "all", "archived" } bulks, err := client.GetAllEnrichBulks(params) if err != nil { log.Fatal("Failed to get bulks:", err) } fmt.Printf("Found %d enrichment bulks\n", len(bulks.Data)) // Rename a bulk renameParams := &models.BulkRenameParams{ Name: "Updated Enrichment Name", } _, err = client.RenameBulk(models.BulkTypeEnrich, bulkID, renameParams) if err != nil { log.Fatal("Failed to rename bulk:", err) } // Archive completed bulk _, err = client.ArchiveBulk(models.BulkTypeEnrich, bulkID) if err != nil { log.Fatal("Failed to archive bulk:", err) }`
### Advanced Example: Complete Enrichment Workflow[](https://docs.tomba.io/bulks/email-enrichment#advanced-example-complete-enrichment-workflow)
Code
`func performEmailEnrichment(client *tomba.Tomba, csvFilePath string) error { // Step 1: Create bulk operation params := &models.BulkCreateParams{ Name: fmt.Sprintf("Email Enrichment - %s", time.Now().Format("2006-01-02")), Delimiter: ",", Column: 1, Sources: true, Verify: false, Notifie: true, } response, err := client.CreateBulkWithFile(models.BulkTypeEnrich, params, csvFilePath) if err != nil { return fmt.Errorf("failed to create bulk: %w", err) } bulkID := *response.Data.ID log.Printf("Created enrichment bulk: %d", bulkID) // Step 2: Launch processing _, err = client.LaunchBulk(models.BulkTypeEnrich, bulkID) if err != nil { return fmt.Errorf("failed to launch bulk: %w", err) } // Step 3: Monitor progress with timeout timeout := time.After(30 * time.Minute) ticker := time.NewTicker(30 * time.Second) defer ticker.Stop() for { select { case <-timeout: return fmt.Errorf("enrichment timed out after 30 minutes") case <-ticker.C: progress, err := client.GetBulkProgress(models.BulkTypeEnrich, bulkID) if err != nil { log.Printf("Error checking progress: %v", err) continue } log.Printf("Enrichment progress: %d%%", progress.Progress) if progress.Status { // Step 4: Download results outputPath := fmt.Sprintf("enriched-%d.csv", bulkID) err = client.SaveBulkResults(models.BulkTypeEnrich, bulkID, outputPath, "full") if err != nil { return fmt.Errorf("failed to save results: %w", err) } log.Printf("Enrichment completed! Results saved to: %s", outputPath) return nil } } } }`
Best Practices[](https://docs.tomba.io/bulks/email-enrichment#best-practices)
------------------------------------------------------------------------------
* **Valid Email Input**: Ensure all input emails are properly formatted
* **Data Privacy**: Comply with privacy regulations when enriching contact data
* **Regular Updates**: Refresh enriched data as contacts change roles
* **Segmentation**: Organize enriched contacts by relevant criteria
* **Quality Control**: Validate enriched data before using for outreach
* **Rate Limiting**: Monitor your API usage to avoid hitting limits
* **Error Handling**: Implement robust error handling for production applications
* **Progress Monitoring**: Use progress tracking for long-running enrichment operations
Last modified on September 24, 2025
[Domain Search Bulk](https://docs.tomba.io/bulks/domain-search)
[Email Finder Bulk](https://docs.tomba.io/bulks/email-finder)
Go
Go
Go
Go
Go
Go
Go
---
# Integrate Tomba Finder with Maltego | Tomba Documentation
Menu
A comprehensive Maltego integration for Tomba.io using the official Python SDK, providing 11 specialized transforms for email discovery, verification, and enrichment.
Features[](https://docs.tomba.io/integrations/maltego#features)
----------------------------------------------------------------
### Core Email Discovery[](https://docs.tomba.io/integrations/maltego#core-email-discovery)
* **Domain Search**: Find all emails associated with a domain
### Email Analysis & Verification[](https://docs.tomba.io/integrations/maltego#email-analysis--verification)
* **Email Verifier**: Verify email deliverability and validity
* **Email Enrichment**: Enrich emails with professional/personal data
### Content & Social Intelligence[](https://docs.tomba.io/integrations/maltego#content--social-intelligence)
* **Author Finder**: Extract author emails from article URLs
* **LinkedIn Finder**: Find emails from LinkedIn profiles
### Utility Transforms[](https://docs.tomba.io/integrations/maltego#utility-transforms)
* **Account Info**: Check API usage and account status
* **Phone Finder**: Discover phone numbers associated with emails/domains
* **Phone Validator**: Validate phone numbers for correctness
* **Similar Domains**: Find domains related to a given domain
* **Technology Checker**: Identify technologies used by a website
Prerequisites[](https://docs.tomba.io/integrations/maltego#prerequisites)
--------------------------------------------------------------------------
* Python 3.8 or later
* Maltego CE/Classic/XL
* Tomba.io API account ([Sign up here](https://app.tomba.io/auth/register)
)
Installation[](https://docs.tomba.io/integrations/maltego#installation)
------------------------------------------------------------------------
Clone this repo locally.
TerminalCode
`git clone https://github.com/tomba-io/tomba-maltego.git cd tomba-maltego # Install dependencies pip install -r requirements.txt`
**Configure API credentials**:
TerminalCode
`cp settings.py.template settings.py # Edit settings.py with your Tomba.io API keys`
Open Maltego and using Import Config, import the `tomba_transforms.mtz` file from the repository
API Configuration[](https://docs.tomba.io/integrations/maltego#api-configuration)
----------------------------------------------------------------------------------
Get your API credentials from [Tomba.io API Dashboard](https://app.tomba.io/api)
:
Code
`# In settings.py TOMBA_API_KEY = "ta_xxxxxxxxxxxxxxxxxxxx" # Your API Key TOMBA_SECRET_KEY = "ts_xxxxxxxxxxxxxxxxxxxx" # Your Secret Key`
Transform Reference[](https://docs.tomba.io/integrations/maltego#transform-reference)
--------------------------------------------------------------------------------------
| Transform | Input | Output | Description |
| --- | --- | --- | --- |
| Domain Search | Website | Emails, People, Company | Find all emails for domain |
| Email Verifier | Email | Verified Email | Check email deliverability |
| Email Enrichment | Email | Enhanced Email, Person | Enrich with additional data |
| Author Finder | URL | Author Emails, People | Find article authors |
| LinkedIn Finder | LinkedIn URL | Email, Person | Find email from profile |
| Company Enrichment | Domain | Enhanced Company | Get company details |
| Phone Finder | Email, Domain | Phone Numbers | Discover associated phones |
| Phone Validator | Phone Number | Validated Phone | Validate phone number |
| Similar Domains | Domain | Related Domains | Find similar domains |
| Technology Checker | Domain | Technologies | Identify tech stack |
| Account Info | None | Account Details | Check API usage |
Usage Examples[](https://docs.tomba.io/integrations/maltego#usage-examples)
----------------------------------------------------------------------------
### Basic Domain Search[](https://docs.tomba.io/integrations/maltego#basic-domain-search)
1. Add Website entity: `example.com`
2. Run **Domain Search \[Tomba\]**
3. Explore discovered emails and people
### Email Verification[](https://docs.tomba.io/integrations/maltego#email-verification)
1. Add Email entity: `user@domain.com`
2. Run **Email Verifier \[Tomba\]**
3. Check verification status and deliverability
Configuration Options[](https://docs.tomba.io/integrations/maltego#configuration-options)
------------------------------------------------------------------------------------------
### Common Issues[](https://docs.tomba.io/integrations/maltego#common-issues)
* "Please configure API credentials"\*\*
* Add API keys in Transform Hub → Server Settings
* Verify credentials in Tomba.io dashboard
**"Rate limit exceeded"**
* Wait before making more requests
* Upgrade Tomba.io plan for higher limits
**"No results found"**
* Try different domains/emails
* Check if data exists publicly
* Verify domain has discoverable emails
Security & Privacy[](https://docs.tomba.io/integrations/maltego#security--privacy)
-----------------------------------------------------------------------------------
* API keys are never logged or exposed
* All requests use HTTPS
* Input validation prevents injection attacks
* Respects rate limits and terms of service
* GDPR and privacy-compliant data handling
Support[](https://docs.tomba.io/integrations/maltego#support)
--------------------------------------------------------------
* **Issues**: Create an issue on GitHub
* **Support**: [Tomba.io Support](https://help.tomba.io/en/)
* **Maltego Help**: [Maltego Documentation](https://docs.maltego.com/)
Acknowledgments[](https://docs.tomba.io/integrations/maltego#acknowledgments)
------------------------------------------------------------------------------
* [Maltego](https://maltego.com/)
for the Maltego platform
* [maltego-trx](https://github.com/MaltegoTech/maltego-trx)
maltego-trx library
Last modified on September 26, 2025
[Integrate Tomba Finder with MyBB](https://docs.tomba.io/integrations/mybb)
[Integrate Tomba Finder with LiteCart](https://docs.tomba.io/integrations/litecart)
---
# Migrate to Tomba Email Verifier | Tomba Documentation
Menu
Switch to Tomba's advanced email verification service and experience better accuracy, richer data attributes, and superior value.
* * *
Why Choose Tomba?[](https://docs.tomba.io/migration/email-verifier/introduction#why-choose-tomba)
--------------------------------------------------------------------------------------------------
### **Superior Accuracy**[](https://docs.tomba.io/migration/email-verifier/introduction#superior-accuracy)
Tomba consistently achieves **99%+ accuracy** through advanced SMTP validation, multi-source verification, and machine learning algorithms.
### **Better Pricing**[](https://docs.tomba.io/migration/email-verifier/introduction#better-pricing)
Competitive rates with flexible plans, credit rollover, and no hidden fees. Save 15-25% compared to competitors.
### **Advanced Catchall Detection**[](https://docs.tomba.io/migration/email-verifier/introduction#advanced-catchall-detection)
Sophisticated algorithms with confidence scoring help you make better decisions about catch-all domains.
### ⚡ **Lightning Fast**[](https://docs.tomba.io/migration/email-verifier/introduction#-lightning-fast)
Ultra-fast verification with smart 3-month caching system. Cached results are instant and free.
### **Rich Data Attributes**[](https://docs.tomba.io/migration/email-verifier/introduction#rich-data-attributes)
Get **15+ comprehensive attributes** including:
* SMTP provider identification
* MX record details
* Confidence scoring (0-100)
* Greylisting detection
* Gibberish pattern analysis
* Risk assessment
### **Better Integration**[](https://docs.tomba.io/migration/email-verifier/introduction#better-integration)
* REST API with comprehensive documentation
* Official SDKs for 10+ languages
* Model Context Protocol (MCP) support
* 50+ native integrations
* Google Sheets & Excel add-ons
* Chrome extension
* * *
Migration Guides[](https://docs.tomba.io/migration/email-verifier/introduction#migration-guides)
-------------------------------------------------------------------------------------------------
Choose your current provider to get started:
### [NeverBounce →](https://docs.tomba.io/migration/email-verifier/neverbounce)
[](https://docs.tomba.io/migration/email-verifier/introduction#neverbounce-)
Popular choice with good accuracy. Migrate to Tomba for better data attributes and competitive pricing.
### [MillionVerifier →](https://docs.tomba.io/migration/email-verifier/millionverifier)
[](https://docs.tomba.io/migration/email-verifier/introduction#millionverifier-)
Affordable bulk verification. Switch to Tomba for higher accuracy and richer insights.
### [Bounceban →](https://docs.tomba.io/migration/email-verifier/bounceban)
[](https://docs.tomba.io/migration/email-verifier/introduction#bounceban-)
Simple API-based verification. Upgrade to Tomba for advanced features and better developer experience.
### [Bouncer →](https://docs.tomba.io/migration/email-verifier/bouncer)
[](https://docs.tomba.io/migration/email-verifier/introduction#bouncer-)
European-focused verification. Join Tomba for global coverage and comprehensive data.
### [Kickbox →](https://docs.tomba.io/migration/email-verifier/kickbox)
[](https://docs.tomba.io/migration/email-verifier/introduction#kickbox-)
Enterprise-grade verification. Move to Tomba for better pricing and more attributes.
### [Hunter.io →](https://docs.tomba.io/migration/email-verifier/hunter)
[](https://docs.tomba.io/migration/email-verifier/introduction#hunterio-)
Email finder with verification. Get Tomba's specialized verification with deeper insights.
* * *
Feature Comparison[](https://docs.tomba.io/migration/email-verifier/introduction#feature-comparison)
-----------------------------------------------------------------------------------------------------
| Feature | Competitors | Tomba |
| --- | --- | --- |
| **Accuracy** | 95-98% | **99%+** |
| **Data Attributes** | 6-10 attributes | **15+ attributes** |
| **SMTP Provider Detection** | ❌ Most don't have it | ✅ **Detailed provider info** |
| **Smart Caching** | ❌ Limited or none | ✅ **3-month automatic caching** |
| **Greylisting Detection** | ❌ Rare | ✅ **Built-in** |
| **Confidence Scoring** | ⚠️ Basic | ✅ **Advanced 0-100 scoring** |
| **MX Record Details** | ⚠️ Limited | ✅ **Full record list** |
| **API Documentation** | ⚠️ Varies | ✅ **Comprehensive + OpenAPI** |
| **Official SDKs** | ⚠️ Few languages | ✅ **10+ languages** |
| **MCP Integration** | ❌ Not available | ✅ **Full MCP support** |
| **Bulk Processing** | ✅ Most have it | ✅ **Advanced API** |
| **Free Trial** | ⚠️ Varies | ✅ **25 free verifications** |
* * *
What You Get with Tomba[](https://docs.tomba.io/migration/email-verifier/introduction#what-you-get-with-tomba)
---------------------------------------------------------------------------------------------------------------
### Comprehensive Verification Data[](https://docs.tomba.io/migration/email-verifier/introduction#comprehensive-verification-data)
Code
`{ "data": { "email": "contact@example.com", "status": "valid", "result": "deliverable", "score": 100, "regex": true, "mx_records": ["mail.example.com"], "mx_check": true, "smtp_server": true, "smtp_check": true, "smtp_provider": "Google Workspace", "accept_all": false, "block": false, "gibberish": false, "disposable": false, "webmail": false, "greylisted": false } }`
### Smart Caching System[](https://docs.tomba.io/migration/email-verifier/introduction#smart-caching-system)
Tomba automatically caches verification results for **3 months**:
* **Save credits**: No charge for cached results
* **Instant results**: Cached verifications return immediately
* **Always fresh**: Verification dates tracked automatically
* **Automatic management**: No configuration needed
### Advanced Detection[](https://docs.tomba.io/migration/email-verifier/introduction#advanced-detection)
* **Catch-all domains**: Sophisticated detection with risk scoring
* **Disposable emails**: Comprehensive database of temporary services
* **Webmail providers**: Identify Gmail, Outlook, Yahoo, etc.
* **Role addresses**: Detect generic addresses (info@, support@, etc.)
* **Gibberish patterns**: Identify randomly generated addresses
* **SMTP provider**: Know exactly which email service is used
* * *
Migration Process[](https://docs.tomba.io/migration/email-verifier/introduction#migration-process)
---------------------------------------------------------------------------------------------------
### 1\. **Sign Up & Get Credentials**[](https://docs.tomba.io/migration/email-verifier/introduction#1-sign-up--get-credentials)
Create your free Tomba account and get your API keys.
### 2\. **Choose Your Guide**[](https://docs.tomba.io/migration/email-verifier/introduction#2-choose-your-guide)
Select your current provider from the list above for specific migration instructions.
### 3\. **Update Your Code**[](https://docs.tomba.io/migration/email-verifier/introduction#3-update-your-code)
Follow the code examples to update API calls and response handling.
### 4\. **Test in Parallel**[](https://docs.tomba.io/migration/email-verifier/introduction#4-test-in-parallel)
Run both services simultaneously to verify accuracy and performance.
### 5\. **Complete Migration**[](https://docs.tomba.io/migration/email-verifier/introduction#5-complete-migration)
Switch over completely and cancel your old subscription.
### 6\. **Optimize**[](https://docs.tomba.io/migration/email-verifier/introduction#6-optimize)
Take advantage of Tomba's advanced features and integrations.
* * *
Quick Start Example[](https://docs.tomba.io/migration/email-verifier/introduction#quick-start-example)
-------------------------------------------------------------------------------------------------------
Code
``import { TombaClient, Verifier } from "tomba"; // Init Tomba let client = new TombaClient(); let verifier = new Verifier(client); client .setKey("ta_xxxx") // Your Key .setSecret("ts_xxxx"); // Your Secret async function verifyEmail(email) { try { const result = await verifier.emailVerifier(email); console.log(`Email: ${result.email}`); console.log(`Status: ${result.status}`); console.log(`Result: ${result.result}`); console.log(`Score: ${result.score}`); console.log(`Provider: ${result.smtp_provider}`); return result; } catch (error) { console.error("Verification error:", error); } } verifyEmail("test@example.com");``
Code
`# Python from tomba import Client, Verifier client = Client('YOUR_API_KEY', 'YOUR_SECRET') verifier = Verifier(client) def verify_email(email): try: result = verifier.email_verifier(email) print(f"Email: {result['email']}") print(f"Status: {result['status']}") print(f"Result: {result['result']}") print(f"Score: {result['score']}") print(f"Provider: {result['smtp_provider']}") return result except Exception as error: print(f"Verification error: {error}") verify_email('test@example.com')`
* * *
Support & Resources[](https://docs.tomba.io/migration/email-verifier/introduction#support--resources)
------------------------------------------------------------------------------------------------------
### Documentation[](https://docs.tomba.io/migration/email-verifier/introduction#documentation)
* [API Reference](https://docs.tomba.io/api)
* [Email Verifier Attributes](https://docs.tomba.io/attributes/verifier)
* [Bulk Verification](https://docs.tomba.io/bulks/email-verifier)
* [SDKs & Libraries](https://docs.tomba.io/libraries)
### Help & Support[](https://docs.tomba.io/migration/email-verifier/introduction#help--support)
* [Support Portal](https://help.tomba.io/)
* [API Status](https://status.tomba.io/)
* Email: [support@tomba.io](mailto:support@tomba.io)
* Migration assistance available for enterprise customers
### Try It Free[](https://docs.tomba.io/migration/email-verifier/introduction#try-it-free)
Start with **25 free verifications** - no credit card required!
[Sign up now →](https://app.tomba.io/auth/register)
* * *
FAQ[](https://docs.tomba.io/migration/email-verifier/introduction#faq)
-----------------------------------------------------------------------
**Q: How long does migration typically take?**
A: Most migrations are completed in 1-2 hours, including testing.
**Q: Will I experience any downtime?**
A: No! You can run both services in parallel during migration.
**Q: Can I test before fully migrating?**
A: Yes! Use our free tier (25 verifications) to test the service thoroughly.
**Q: Do you offer migration support?**
A: Yes, especially for enterprise customers. Contact our support team.
**Q: What happens to my existing data?**
A: You can export your data from your current provider and re-verify with Tomba at discounted bulk rates.
**Q: Is the API compatible with my current setup?**
A: Tomba's RESTful API follows standard conventions and includes SDKs for easy integration.
**Q: How much will I save?**
A: Most customers save 15-25% on costs while getting better accuracy and more data.
* * *
Ready to Migrate?[](https://docs.tomba.io/migration/email-verifier/introduction#ready-to-migrate)
--------------------------------------------------------------------------------------------------
Choose your current provider above and follow the step-by-step migration guide. Our team is here to help if you need assistance!
[Get Started →](https://app.tomba.io/auth/register)
Last modified on February 11, 2026
[Clearbit Combined API Replacement](https://docs.tomba.io/migration/clearbit/combined-api)
[Migrate from NeverBounce to Tomba](https://docs.tomba.io/migration/email-verifier/neverbounce)
JSON
Javascript
---
# R Client Library | Tomba Documentation
Menu
Installation[](https://docs.tomba.io/libraries/r-email-finder#installation)
----------------------------------------------------------------------------
To install
TerminalCode
`install.packages("tomba")`
or via devtools [devtools](https://devtools.r-lib.org/)
:
TerminalCode
`devtools::install_github("tomba-io/r")`
Usage[](https://docs.tomba.io/libraries/r-email-finder#usage)
--------------------------------------------------------------
### Domain Search[](https://docs.tomba.io/libraries/r-email-finder#domain-search)
Get email addresses found on the internet.
Code
`client <- Tomba(key="ta_xxxx",secret="ts_xxxx") data <- domain_search(client, domain="tomba.io")`
### Email Finder[](https://docs.tomba.io/libraries/r-email-finder#email-finder)
Find the verified email address of any professional.
Code
`client <- Tomba(key="ta_xxxx",secret="ts_xxxx") data <- email_finder(client, domain="tomba.io",fname="FNAME",lname="LNAME")`
### Email Verifier[](https://docs.tomba.io/libraries/r-email-finder#email-verifier)
Verify the validity of any professional email address with the most complete email checker.
Code
`client <- Tomba(key="ta_xxxx",secret="ts_xxxx") data <- email_verifier(client, email="m@wordpress.org")`
Examples[](https://docs.tomba.io/libraries/r-email-finder#examples)
--------------------------------------------------------------------
### Get Account Information[](https://docs.tomba.io/libraries/r-email-finder#get-account-information)
Code
`client <- Tomba(key="ta_xxxx",secret="ts_xxxx") data <- account(client) data`
### Email Count[](https://docs.tomba.io/libraries/r-email-finder#email-count)
Code
`client <- Tomba(key="ta_xxxx",secret="ts_xxxx") data <- count(client, domain="tomba.io") data`
### Finder Services[](https://docs.tomba.io/libraries/r-email-finder#finder-services)
#### Author Finder[](https://docs.tomba.io/libraries/r-email-finder#author-finder)
Code
`client <- Tomba(key="ta_xxxx",secret="ts_xxxx") result <- author_finder(client,url="https://clearbit.com/blog/company-name-to-domain-api")`
#### LinkedIn Finder[](https://docs.tomba.io/libraries/r-email-finder#linkedin-finder)
Code
`client <- Tomba(key="ta_xxxx",secret="ts_xxxx") result <- linkedin_finder(client,url="https://www.linkedin.com/in/alex-maccaw-ab592978")`
#### Phone Finder[](https://docs.tomba.io/libraries/r-email-finder#phone-finder)
Code
`client <- Tomba(key="ta_xxxx",secret="ts_xxxx") result <- phone_finder(client,email="******@zapier.com")`
### Email Sources[](https://docs.tomba.io/libraries/r-email-finder#email-sources)
Code
`client <- Tomba(key="ta_xxxx",secret="ts_xxxx") data <- email_sources(client, email="b.mohamed@tomba.io") data`
### Domain and Company Status[](https://docs.tomba.io/libraries/r-email-finder#domain-and-company-status)
#### Domain Status[](https://docs.tomba.io/libraries/r-email-finder#domain-status)
Code
`client <- Tomba(key="ta_xxxx",secret="ts_xxxx") data <- status(client, domain="gmail.com") data`
### Activity Logs[](https://docs.tomba.io/libraries/r-email-finder#activity-logs)
Code
`client <- Tomba(key="ta_xxxx",secret="ts_xxxx") data <- logs(client) data`
### Usage Statistics[](https://docs.tomba.io/libraries/r-email-finder#usage-statistics)
Code
`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.
Last modified on April 28, 2026
[Python Client Library](https://docs.tomba.io/libraries/python-email-finder)
[Rust Client Library](https://docs.tomba.io/libraries/rust-email-finder)
---
# Company Enrichment Bulk | Tomba Documentation
Menu
Overview[](https://docs.tomba.io/bulks/company-enrichment#overview)
--------------------------------------------------------------------
[Bulks Company Enrichment](https://tomba.io/bulks/company-enrichment)
provides comprehensive business intelligence for thousands of companies simultaneously. Gather detailed company information, contact data, and organizational insights to enhance your prospect research and targeting efforts.
### Key Features[](https://docs.tomba.io/bulks/company-enrichment#key-features)
* **Company Intelligence**: Gather detailed information about target companies
* **Contact Discovery**: Find key personnel and their contact information
* **Data Enrichment**: Enhance existing company records with additional details
* **Bulk Processing**: Process up to 15,000 companies in one operation
* **Comprehensive Profiles**: Access company size, industry, location, and more
* **Integration Ready**: Export enriched data for CRM integration
### How Company Enrichment Bulk Works[](https://docs.tomba.io/bulks/company-enrichment#how-company-enrichment-bulk-works)
1. **Provide Company List**: Input company domains or names
2. **Select Data Fields**: Choose what information to enrich (contacts, company details, etc.)
3. **Process Enrichment**: Launch the bulk enrichment operation
4. **Review Enhanced Data**: Examine the enriched company profiles
5. **Export Results**: Download comprehensive company intelligence
### Limitations[](https://docs.tomba.io/bulks/company-enrichment#limitations)
* Each Bulk is limited to 15,000 domains
* Additional rows will be skipped
* Some special or unexpected characters may be deleted in the file
* Invalid websites won't be imported
* Duplicate URLs won't be imported
* For better results, we use the domain name instead of the company name
Go SDK Integration[](https://docs.tomba.io/bulks/company-enrichment#go-sdk-integration)
----------------------------------------------------------------------------------------
### Installation[](https://docs.tomba.io/bulks/company-enrichment#installation)
TerminalCode
`go get github.com/tomba-io/go`
### Basic Company Enrichment[](https://docs.tomba.io/bulks/company-enrichment#basic-company-enrichment)
Code
`package main import ( "fmt" "log" "strings" "time" "github.com/tomba-io/go/tomba" "github.com/tomba-io/go/tomba/models" ) func main() { // Initialize Tomba client client := tomba.NewClient("YOUR_TOMBA_KEY", "YOUR_TOMBA_SECRET") // Create Company Enrichment Bulk params := &models.BulkCreateParams{ Name: "Enterprise Prospects Q1 2024", List: "stripe.com\nshopify.com\nzoom.us\nslack.com\ndropbox.com\nnotion.so", Sources: true, // Include data sources Verify: true, // Verify found emails } // Create the bulk operation response, err := client.CreateBulk(models.BulkTypeCompany, params) if err != nil { log.Fatal("Error creating company enrichment bulk:", err) } bulkID := *response.Data.ID fmt.Printf("Company Enrichment Bulk created with ID: %d\n", bulkID) // Launch the bulk operation launchResp, err := client.LaunchBulk(models.BulkTypeCompany, bulkID) if err != nil { log.Fatal("Error launching bulk:", err) } fmt.Printf("Bulk launched: %s\n", launchResp.Data.Message) // Monitor progress fmt.Println("Monitoring enrichment progress...") for { progress, err := client.GetBulkProgress(models.BulkTypeCompany, bulkID) if err != nil { log.Printf("Error getting progress: %v", err) break } fmt.Printf("Progress: %d%% (%d companies processed)\n", progress.Progress, progress.Processed) if progress.Progress >= 100 { fmt.Println("Company enrichment completed!") break } time.Sleep(10 * time.Second) } // Download enriched results err = client.SaveBulkResults(models.BulkTypeCompany, bulkID, "./enriched_companies.csv", "full") if err != nil { log.Printf("Error downloading results: %v", err) } else { fmt.Println("Enriched company data saved to ./enriched_companies.csv") } }`
### Advanced Company Enrichment with File Upload[](https://docs.tomba.io/bulks/company-enrichment#advanced-company-enrichment-with-file-upload)
Code
`func enrichFromCSV(client *tomba.Tomba, filePath string) error { // For large lists, you might want to use CSV upload params := &models.BulkCreateParams{ Name: "CSV Company Enrichment", Sources: true, Verify: true, Delimiter: ",", Column: 1, // Domain column in CSV } // Create with file upload response, err := client.CreateBulkWithFile(models.BulkTypeCompany, params, filePath) if err != nil { return fmt.Errorf("failed to create bulk with file: %w", err) } bulkID := *response.Data.ID fmt.Printf("Company enrichment bulk created from CSV with ID: %d\n", bulkID) // Launch and monitor _, err = client.LaunchBulk(models.BulkTypeCompany, bulkID) if err != nil { return fmt.Errorf("failed to launch bulk: %w", err) } return monitorAndDownload(client, models.BulkTypeCompany, bulkID, "./csv_enriched_results.csv") } func monitorAndDownload(client *tomba.Tomba, bulkType models.BulkType, bulkID int64, outputPath string) error { // Monitor with timeout timeout := time.After(45 * time.Minute) ticker := time.NewTicker(30 * time.Second) defer ticker.Stop() for { select { case <-timeout: return fmt.Errorf("enrichment operation timed out after 45 minutes") case <-ticker.C: progress, err := client.GetBulkProgress(bulkType, bulkID) if err != nil { log.Printf("Error checking progress: %v", err) continue } fmt.Printf("Enrichment Progress: %d%% (%d processed)\n", progress.Progress, progress.Processed) if progress.Progress >= 100 { // Download results err = client.SaveBulkResults(bulkType, bulkID, outputPath, "full") if err != nil { return fmt.Errorf("failed to download results: %w", err) } fmt.Printf("Results downloaded to: %s\n", outputPath) return nil } } } }`
### Batch Processing for Large Lists[](https://docs.tomba.io/bulks/company-enrichment#batch-processing-for-large-lists)
Code
`func batchEnrichCompanies(client *tomba.Tomba, domains []string, batchSize int) error { if len(domains) == 0 { return fmt.Errorf("no domains provided") } // Split into batches to stay within limits for i := 0; i < len(domains); i += batchSize { end := i + batchSize if end > len(domains) { end = len(domains) } if end-i > 15000 { end = i + 15000 // Respect API limit } batch := domains[i:end] batchNum := (i / batchSize) + 1 fmt.Printf("Processing batch %d (%d domains)...\n", batchNum, len(batch)) params := &models.BulkCreateParams{ Name: fmt.Sprintf("Company Batch %d - %s", batchNum, time.Now().Format("2006-01-02")), List: strings.Join(batch, "\n"), Sources: true, Verify: true, } response, err := client.CreateBulk(models.BulkTypeCompany, params) if err != nil { log.Printf("Error creating batch %d: %v", batchNum, err) continue } bulkID := *response.Data.ID // Launch batch _, err = client.LaunchBulk(models.BulkTypeCompany, bulkID) if err != nil { log.Printf("Error launching batch %d: %v", batchNum, err) continue } fmt.Printf("Batch %d launched with ID: %d\n", batchNum, bulkID) // Small delay between batches time.Sleep(5 * time.Second) } return nil }`
### Company Enrichment Management[](https://docs.tomba.io/bulks/company-enrichment#company-enrichment-management)
Code
`func manageCompanyBulks(client *tomba.Tomba) { // Get all company enrichment bulks allBulks, err := client.GetAllCompanyBulks(&models.BulkGetParams{ Page: 1, Limit: 20, Direction: "desc", Filter: "all", }) if err != nil { log.Printf("Error getting company bulks: %v", err) return } fmt.Printf("Total company enrichment bulks: %d\n", allBulks.Meta.Total) // Process each bulk for _, bulk := range allBulks.Data { fmt.Printf("Bulk: %s (ID: %d)\n", bulk.Name, bulk.BulkID) fmt.Printf(" Progress: %d%%, Status: %t, Expired: %t\n", bulk.Progress, bulk.Status, bulk.Expired) if bulk.TotalEmails != nil { fmt.Printf(" Total Emails Found: %d\n", *bulk.TotalEmails) } // Download completed and unused bulks if bulk.Progress >= 100 && !bulk.Used && !bulk.Expired { filename := fmt.Sprintf("./company_enrichment_%d.csv", bulk.BulkID) err := client.SaveBulkResults( models.BulkTypeCompany, bulk.BulkID, filename, "full", ) if err == nil { fmt.Printf(" ✓ Downloaded results to %s\n", filename) } else { fmt.Printf(" ✗ Failed to download: %v\n", err) } } } // Clean up old bulks cleanupOldBulks(client, allBulks.Data) } func cleanupOldBulks(client *tomba.Tomba, bulks []models.BulkItem) { cutoffDate := time.Now().AddDate(0, -3, 0) // 3 months ago for _, bulk := range bulks { // Archive bulks older than 3 months if bulk.CreatedAt.Before(cutoffDate) && bulk.Progress >= 100 { _, err := client.ArchiveBulk(models.BulkTypeCompany, bulk.BulkID) if err == nil { fmt.Printf("Archived old bulk: %s (ID: %d)\n", bulk.Name, bulk.BulkID) } } } }`
### Input Format Examples[](https://docs.tomba.io/bulks/company-enrichment#input-format-examples)
**Text List (recommended):**
Code
`stripe.com shopify.com zoom.us slack.com dropbox.com notion.so figma.com`
**CSV File:**
Code
`Domain,Company stripe.com,Stripe Inc shopify.com,Shopify zoom.us,Zoom Video Communications slack.com,Slack Technologies`
Best Practices[](https://docs.tomba.io/bulks/company-enrichment#best-practices)
--------------------------------------------------------------------------------
* **Clean Domain Lists**: Ensure domains are properly formatted without protocols (http/https)
* **Use Domain Names**: Prefer domain names over company names for better accuracy
* **Enable Sources**: Include source information for data validation
* **Verify Emails**: Enable email verification for higher-quality contact data
* **Regular Updates**: Refresh company data periodically as organizations change
* **Data Validation**: Cross-check enriched data with multiple sources
* **Strategic Segmentation**: Organize enriched companies by relevant criteria (size, industry, location)
* **Batch Processing**: For very large lists, process in manageable batches
* **Monitor Progress**: Check progress regularly for large operations
* **Archive Completed**: Archive old bulks to keep dashboard organized
### Common Use Cases[](https://docs.tomba.io/bulks/company-enrichment#common-use-cases)
* **Lead Qualification**: Enrich prospect lists with detailed company information
* **Market Research**: Gather intelligence on target markets and competitors
* **Sales Preparation**: Enhance CRM data before sales outreach
* **Partnership Identification**: Find potential partners and strategic relationships
* **Competitive Analysis**: Understand competitive landscape and positioning
* **Account-Based Marketing**: Develop detailed target account profiles
Last modified on April 27, 2026
[Author Finder Bulk](https://docs.tomba.io/bulks/author-finder)
[Domain Search Bulk](https://docs.tomba.io/bulks/domain-search)
Go
Go
Go
Go
---
# Perl Client Library | Tomba Documentation
Menu
Installation[](https://docs.tomba.io/libraries/perl-email-finder#installation)
-------------------------------------------------------------------------------
install from source (not necessary for use in your application), download the source and run the following commands:
TerminalCode
`perl Makefile.PL make make test make install`
Usage[](https://docs.tomba.io/libraries/perl-email-finder#usage)
-----------------------------------------------------------------
### Domain Search[](https://docs.tomba.io/libraries/perl-email-finder#domain-search)
Get email addresses found on the internet.
Code
`use Tomba::Finder; $tomba = Tomba::Finder->new("ta_xxxxx", "ts_xxxxx"); $result = $tomba->DomainSearch('wordpress.org') print $result;`
### Email Finder[](https://docs.tomba.io/libraries/perl-email-finder#email-finder)
Find the verified email address of any professional.
Code
`use Tomba::Finder; $tomba = Tomba::Finder->new("ta_xxxxx", "ts_xxxxx"); $result = $tomba->emailFinder('stripe.com', 'fname', 'lname') print $result;`
### Email Verifier[](https://docs.tomba.io/libraries/perl-email-finder#email-verifier)
Verify the validity of any professional email address with the most complete email checker.
Code
`use Tomba::Finder; $tomba = Tomba::Finder->new("ta_xxxxx", "ts_xxxxx"); $result = $tomba->EmailVerifier('m@wordpress.org') print $result;`
Examples[](https://docs.tomba.io/libraries/perl-email-finder#examples)
-----------------------------------------------------------------------
### Get Account Information[](https://docs.tomba.io/libraries/perl-email-finder#get-account-information)
Code
`use Tomba::Finder; $tomba = Tomba::Finder->new("ta_xxxxx", "ts_xxxxx"); $result = $tomba->Account(); print $result;`
### Email Count[](https://docs.tomba.io/libraries/perl-email-finder#email-count)
Code
`use Tomba::Finder; $tomba = Tomba::Finder->new("ta_xxxxx", "ts_xxxxx"); $result = $tomba->Count('tomba.io'); print $result;`
### Finder Services[](https://docs.tomba.io/libraries/perl-email-finder#finder-services)
#### Author Finder[](https://docs.tomba.io/libraries/perl-email-finder#author-finder)
Code
`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[](https://docs.tomba.io/libraries/perl-email-finder#linkedin-finder)
Code
`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[](https://docs.tomba.io/libraries/perl-email-finder#email-enrichment)
Code
`use Tomba::Finder; $tomba = Tomba::Finder->new("ta_xxxxx", "ts_xxxxx"); $result = $tomba->Enrichment('b.mohamed@tomba.io'); print $result;`
### Email Sources[](https://docs.tomba.io/libraries/perl-email-finder#email-sources)
Code
`use Tomba::Finder; $tomba = Tomba::Finder->new("ta_xxxxx", "ts_xxxxx"); $result = $tomba->EmailSources('b.mohamed@tomba.io'); print $result;`
### Domain and Company Status[](https://docs.tomba.io/libraries/perl-email-finder#domain-and-company-status)
#### Auto Complete[](https://docs.tomba.io/libraries/perl-email-finder#auto-complete)
Code
`use Tomba::Finder; $tomba = Tomba::Finder->new("ta_xxxxx", "ts_xxxxx"); $result = $tomba->Autocomplete('google'); print $result;`
#### Domain Status[](https://docs.tomba.io/libraries/perl-email-finder#domain-status)
Code
`use Tomba::Finder; $tomba = Tomba::Finder->new("ta_xxxxx", "ts_xxxxx"); $result = $tomba->Status('gmail.com'); print $result;`
### Activity Logs[](https://docs.tomba.io/libraries/perl-email-finder#activity-logs)
Code
`use Tomba::Finder; $tomba = Tomba::Finder->new("ta_xxxxx", "ts_xxxxx"); $result = $tomba->Logs(); print $result;`
### Usage Statistics[](https://docs.tomba.io/libraries/perl-email-finder#usage-statistics)
Code
`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.
Last modified on April 28, 2026
[Lua Client Library](https://docs.tomba.io/libraries/lua-email-finder)
[PHP Client Library](https://docs.tomba.io/libraries/php-email-finder)
---
# Integrate Tomba Finder with n8n | Tomba Documentation
Menu
Installation[](https://docs.tomba.io/integrations/n8n#installation)
--------------------------------------------------------------------
Tomba is a verified n8n node, which means it's been reviewed and approved by n8n for security and quality.
### Install from n8n Integrations (Recommended)[](https://docs.tomba.io/integrations/n8n#install-from-n8n-integrations-recommended)
The easiest way to install Tomba is directly from the [n8n Tomba integration page](https://n8n.io/integrations/tomba/)
:
1. **Sign in to n8n**
[Sign in to n8n](https://app.n8n.cloud/register)
, open the editor, and click **+** in the top right to open the Nodes panel.
2. **Search for Tomba**
Type "Tomba" in the search field to find the node.
3. **Add to Workflow**
Click on the Tomba node to add it to your workflow.
Learn more about [using verified nodes in n8n](https://docs.n8n.io/integrations/community-nodes/installation/verified-install/)
.
### Install via Community Nodes[](https://docs.tomba.io/integrations/n8n#install-via-community-nodes)
Follow the [installation guide](https://docs.n8n.io/integrations/community-nodes/installation/)
in the n8n community nodes documentation.
### Installation Steps:[](https://docs.tomba.io/integrations/n8n#installation-steps)
1. Go to **Settings**
2. Click on **"Community Nodes"**
3. Enter `n8n-nodes-tomba` into the text box
4. Click on **"I understand the risk..."**
5. Click on **"Install"**
Alternatively, you can it via npm in your n8n installation: install
TerminalCode
`npm install n8n-nodes-tomba`
Operations[](https://docs.tomba.io/integrations/n8n#operations)
----------------------------------------------------------------
The Tomba node supports the following operations:
### [Author Finder](https://docs.tomba.io/api/finder#author-finder)
[](https://docs.tomba.io/integrations/n8n#author-finder)
Generate or retrieve the most likely email address from a blog post URL
### [Autocomplete](https://docs.tomba.io/api/domain-suggestions#get-domain-suggestions)
[](https://docs.tomba.io/integrations/n8n#autocomplete)
Find company names and retrieve logo and domain information
### [Domain Search](https://docs.tomba.io/api/finder#domain-search)
[](https://docs.tomba.io/integrations/n8n#domain-search)
Get every email address found on the internet using a given domain name, with sources
### [Domain Status](https://docs.tomba.io/api/~endpoints#domain-status)
[](https://docs.tomba.io/integrations/n8n#domain-status)
Find domain status if is webmail or disposable
### [Email Count](https://docs.tomba.io/api/finder#email-count)
[](https://docs.tomba.io/integrations/n8n#email-count)
Find total email addresses we have for one domain
### [Email Enrichment](https://docs.tomba.io/api/finder#email-enrichment)
[](https://docs.tomba.io/integrations/n8n#email-enrichment)
Look up person and company data based on an email
### [Email Finder](https://docs.tomba.io/api/finder#email-finder)
[](https://docs.tomba.io/integrations/n8n#email-finder)
Generate or retrieve the most likely email address from a domain name, a first name and a last name
### [Email Format](https://docs.tomba.io/api/finder#email-format)
[](https://docs.tomba.io/integrations/n8n#email-format)
Retrieve the email format patterns used by a specific domain
### [Email Sources](https://docs.tomba.io/api/~endpoints#email-sources)
[](https://docs.tomba.io/integrations/n8n#email-sources)
Find email address source somewhere on the web
### [Email Verifier](https://docs.tomba.io/api/verifier#email-verifier)
[](https://docs.tomba.io/integrations/n8n#email-verifier)
Verify the deliverability of an email address
### [LinkedIn Finder](https://docs.tomba.io/api/finder#linkedin-finder)
[](https://docs.tomba.io/integrations/n8n#linkedin-finder)
Generate or retrieve the most likely email address from a LinkedIn URL
### [Location](https://docs.tomba.io/api/finder#location)
[](https://docs.tomba.io/integrations/n8n#location)
Get employees location based on the domain name
### [Phone Finder](https://docs.tomba.io/api/phone#phone-finder)
[](https://docs.tomba.io/integrations/n8n#phone-finder)
Search for phone numbers based on an email, domain, or LinkedIn URL
### [Phone Validator](https://docs.tomba.io/api/phone#phone-validator)
[](https://docs.tomba.io/integrations/n8n#phone-validator)
Validate a phone number and retrieve its associated information
### [Similar](https://docs.tomba.io/api/~endpoints#similar)
[](https://docs.tomba.io/integrations/n8n#similar)
Retrieve similar domains based on a specific domain
### [Technology](https://docs.tomba.io/api/~endpoints#technology)
[](https://docs.tomba.io/integrations/n8n#technology)
Retrieve the technologies used by a specific domain and improve description
Credentials[](https://docs.tomba.io/integrations/n8n#credentials)
------------------------------------------------------------------
To use this node, you need to configure your Tomba API credentials:
1. Sign up for a [Tomba.io account](https://tomba.io/register)
2. Get your API key from the [Tomba dashboard](https://app.tomba.io/api)
3. In n8n, create new credentials for "Tomba API"
4. Enter your API key and secret key
### Required Credential Fields:[](https://docs.tomba.io/integrations/n8n#required-credential-fields)
* **API Key**: Your Tomba API key
* **API Secret**: Your Tomba API secret
Compatibility[](https://docs.tomba.io/integrations/n8n#compatibility)
----------------------------------------------------------------------
This node is compatible with n8n version **1.113.3** and above.
Usage[](https://docs.tomba.io/integrations/n8n#usage)
------------------------------------------------------
### Basic Examples[](https://docs.tomba.io/integrations/n8n#basic-examples)
#### Example 1: Email Verification[](https://docs.tomba.io/integrations/n8n#example-1-email-verification)
This workflow verifies the deliverability of an email address using Tomba:
1. **Start Node**: Triggers the workflow
2. **Tomba Node**:
* Operation: `Email Verifier`
* Email: `example@domain.com`
#### Example 2: Domain Email Search[](https://docs.tomba.io/integrations/n8n#example-2-domain-email-search)
Find all email addresses for a domain:
1. **Start Node**: Triggers the workflow
2. **Tomba Node**:
* Operation: `Domain Search`
* Domain: `company.com`
### Workflow Examples[](https://docs.tomba.io/integrations/n8n#workflow-examples)
#### Lead Generation Workflow[](https://docs.tomba.io/integrations/n8n#lead-generation-workflow)
Code
`[Webhook] → [Tomba Domain Search] → [Filter Valid Emails] → [CRM Integration]`
#### Email Validation Pipeline[](https://docs.tomba.io/integrations/n8n#email-validation-pipeline)
Code
`[CSV Import] → [Tomba Email Verifier] → [Sort Results] → [Export Valid Emails]`
#### Company Research Automation[](https://docs.tomba.io/integrations/n8n#company-research-automation)
Code
`[Company List] → [Tomba Company Finder] → [Email Search] → [Contact Database]`
Contributing[](https://docs.tomba.io/integrations/n8n#contributing)
--------------------------------------------------------------------
Contributions are welcome! Please feel free to submit a Pull Request.
### How to Contribute[](https://docs.tomba.io/integrations/n8n#how-to-contribute)
1. Fork the repository
2. Create your feature branch (`git checkout -b feature/amazing-feature`)
3. Commit your changes (`git commit -m 'Add some amazing feature'`)
4. Push to the branch (`git push origin feature/amazing-feature`)
5. Open a Pull Request
### Development Guidelines[](https://docs.tomba.io/integrations/n8n#development-guidelines)
* Follow the existing code style
* Add tests for new features
* Update documentation as needed
* Ensure all tests pass before submitting
Version History[](https://docs.tomba.io/integrations/n8n#version-history)
--------------------------------------------------------------------------
Refer to the [releases page](https://github.com/tomba-io/n8n-nodes-tomba/releases)
for detailed version history and changelog.
* * *
Support[](https://docs.tomba.io/integrations/n8n#support)
----------------------------------------------------------
For support with this community node:
1. Check the [Issues](https://github.com/tomba-io/n8n-nodes-tomba/issues)
page
2. Create a new issue if your problem isn't already reported
3. For Tomba API-related issues, contact [Tomba Support](https://app.tomba.io/contact)
Last modified on February 11, 2026
[Pipedream Integration](https://docs.tomba.io/integrations/pipedream)
[Integrate Tomba Finder with Steampipe](https://docs.tomba.io/integrations/steampipe)
---
# Blivz Integration | Tomba Documentation
Menu
Overview[](https://docs.tomba.io/integrations/blivz#overview)
--------------------------------------------------------------
Blivz is a GTM data and prospecting platform built around spreadsheet-style lists. Its **column enrichment system** lets you add new columns powered by external APIs and Tomba ships as a native integration with three actions: **Find Email**, **Domain Search**, and **Verify Email**.
Enrich any Blivz GTM list with professional email addresses, verification status, and contact data directly inside the table, without leaving the platform.
Prerequisites[](https://docs.tomba.io/integrations/blivz#prerequisites)
------------------------------------------------------------------------
| Requirement | Details |
| --- | --- |
| **Blivz account** | Sign up at [lists.blivz.com](https://lists.blivz.com/sign-up)