Tomba Domain Search Actor

A powerful Apify Actor that uses the Tomba Domain Search API to find email addresses associated with company domains. Perfect for sales teams, marketers, and researchers who need to discover contact information and build targeted email lists for lead generation and outreach campaigns.

Key Features

• Domain-Wide Email Discovery: Find all email addresses associated with any company domain
• Advanced Filtering: Filter by department, country, seniority, and job roles
• Comprehensive Contact Data: Personal details, job titles, verification status, and LinkedIn profiles
• Company Intelligence: Business information, location, revenue, and social media profiles
• Flexible Results: Choose between 10, 20, or 50 results per domain with pagination support
• Email Verification: Real-time email validation and deliverability status
• Rate Limited: Respects Tomba's 15 requests per second limit with built-in delays
• Source Tracking: Detailed information about where emails were discovered
• Error Handling: Robust error handling with detailed logging

How it works

The Actor leverages Tomba's powerful Domain Search API to discover email addresses and gather comprehensive contact information:

Process Flow

1. Authentication: Connects to Tomba API using your credentials
2. Domain Processing: Searches each domain for email addresses with specified filters
3. Data Enrichment: Gathers personal details, job information, and verification status
4. Company Intelligence: Collects business information and social profiles
5. Rate Management: Automatically handles 15 requests/second limit with delays
6. Data Storage: Saves results to Apify dataset with multiple view formats

What You Get

For each domain, you'll receive:

• Email Discovery: Complete list of email addresses with personal and professional details
• Contact Information: Names, job titles, departments, seniority levels, and LinkedIn profiles
• Email Verification: Validation status, confidence scores, and verification dates
• Company Profiles: Business details, location, revenue, employee count, and social media
• Source Intelligence: Where emails were found, discovery dates, and current availability
• Industry Insights: Company classification, founding information, and business type

Quick Start

Prerequisites

1. Tomba Account: Sign up at Tomba.io to get your API credentials

Getting Your API Keys

1. Visit Tomba API Dashboard
2. Copy your API Key (starts with ta_)
3. Copy your Secret Key (starts with ts_)

Input Configuration

Required Parameters

Parameter	Type	Description
tombaApiKey	string	Your Tomba API key (ta_xxxx)
tombaApiSecret	string	Your Tomba secret key (ts_xxxx)
domains	array	Array of domains to search

Optional Parameters

Parameter	Type	Default	Description
emailFindingMode	string	"domain"	Search mode (currently only "domain" is supported)
maxEmailsPerDomain	number	10	Maximum emails to find per domain (1-100)
includeCompanyInfo	boolean	true	Include company information when available
outputFormat	string	"detailed"	Data format - detailed or simple
page	number	1	Page number for pagination
limit	string	"10"	Max emails per domain ("10", "20", or "50")
department	string	-	Filter by department (see available options below)
country	string	-	Two-letter country code filter (e.g., "US", "UK")

Department Filter Options

Available department filters: engineering, sales, finance, hr, it, marketing, operations, management, executive, legal, support, communication, software, security, pr, warehouse, diversity, administrative, facilities, accounting

Example Input

{
    "tombaApiKey": "ta_xxxxxxxxxxxxxxxxxxxx",
    "tombaApiSecret": "ts_xxxxxxxxxxxxxxxxxxxx",
    "domains": ["stripe.com", "google.com", "tomba.io"],
    "emailFindingMode": "domain",
    "maxEmailsPerDomain": 20,
    "includeCompanyInfo": true,
    "outputFormat": "detailed",
    "page": 1,
    "limit": "20",
    "department": "engineering",
    "country": "US"
}

Best Practices

• Domain Selection: Use clean domain names without protocols (http/https)
• Rate Limits: The Actor automatically handles Tomba's 15 requests/second limit
• Batch Size: Process 5-20 domains at a time for optimal performance
• Department Filtering: Use specific departments to target relevant contacts
• Pagination: Use page parameter for large result sets

Output Data Structure

The Actor provides comprehensive email discovery and company intelligence data in three organized views:

Example Output - Overview View

Complete domain search results with company information and discovered emails:

{
    "domain": "stripe.com",
    "organization.website_url": "stripe.com",
    "organization.organization": "Stripe",
    "organization.location.country": "US",
    "organization.location.city": "San Francisco",
    "organization.location.state": "California",
    "organization.industries": "Information Technology and Services",
    "organization.founded": "2010",
    "organization.company_size": "5K-10K",
    "organization.company_type": "privately held",
    "organization.revenue": "$100M-$250M",
    "organization.phone_number": "+1 415 298 5539",
    "organization.description": "stripe is a payment processing platform enabling businesses to accept payments and manage online transactions.",
    "organization.social_links.linkedin_url": "https://www.linkedin.com/company/stripe",
    "organization.social_links.twitter_url": "https://twitter.com/stripe",
    "emails": [
        {
            "email": "jane@stripe.com",
            "first_name": "Jane",
            "last_name": "Natoli",
            "position": "Financial Crimes Analyst",
            "department": "finance",
            "verification": {
                "status": "valid",
                "date": "2025-09-13T00:00:00+02:00"
            }
        }
    ],
    "meta.total": 20,
    "meta.params": {}
}

Data Structure Overview

The output contains three main data categories organized for different use cases:

Email Discovery Results

• Contact Details: Email addresses, names, job titles, and departments
• Professional Info: Position, seniority level, and LinkedIn profiles
• Verification Data: Email validity status, confidence scores, and verification dates
• Source Intelligence: Where emails were discovered and current availability

Company Intelligence

• Business Basics: Company name, description, industry, and founding information
• Location Data: Complete address, city, state, country, and postal codes
• Business Metrics: Employee count, revenue estimates, and company type
• Digital Presence: Social media profiles and domain registration details

Search Metadata

• Result Counts: Total emails found and pagination information
• Search Parameters: Applied filters and search configuration
• Processing Status: Success rates and error information

Key Data Fields

Email Information:

• email: Email address
• first_name, last_name, full_name: Personal names
• position: Job title and role
• department: Organizational department
• seniority: Job level (senior, junior, executive, etc.)
• type: Email type (personal, generic, etc.)
• country: Person's location
• linkedin: LinkedIn profile URL
• score: Confidence score (0-100)
• verification.status: Email validity (valid, invalid, risky, etc.)
• verification.date: Last verification timestamp

Company Information:

• organization.organization: Company name
• organization.description: Business description
• organization.industries: Industry classification
• organization.founded: Year established
• organization.company_size: Employee count range
• organization.revenue: Revenue estimates
• organization.location.*: Complete address details
• organization.social_links.*: Social media profiles
• organization.whois.*: Domain registration data

Source Tracking:

• sources: Array of discovery sources
• uri: Specific webpage URLs where emails were found
• extracted_on: Discovery date
• last_seen_on: Last verification date
• still_on_page: Current availability status

Key Benefits

• Comprehensive Email Discovery: Find verified contact information with detailed professional context
• Company Intelligence: Get complete business profiles alongside contact data
• Quality Assurance: Email verification and confidence scoring for better targeting
• Source Transparency: Know exactly where contact information was discovered
• Flexible Filtering: Target specific departments, locations, and seniority levels

Use Cases

• Lead Generation: Discover verified contact emails for potential customers and prospects
• Sales Outreach: Build targeted email lists for specific companies and departments
• Recruitment: Find contact information for potential candidates in specific roles
• Market Research: Analyze email patterns and organizational structures across competitors
• Data Enrichment: Enhance existing contact databases with fresh, verified information
• Competitive Intelligence: Research team structures and key personnel at target companies
• Partnership Development: Find decision-makers and relevant contacts for business partnerships

API Rate Limits & Performance

Domain Search Rate Limits

• 15 requests per second - Tomba API allows up to 15 domain search requests per second
• Built-in Rate Management: Actor includes 1-second delays between domain requests
• Efficient Processing: Automatic rate limiting ensures stable operation without errors
• High-Volume Support: Designed for processing multiple domains within API constraints

Performance Optimization

The Actor automatically handles performance optimization through:

• Smart Rate Limiting: 1-second delays between domain searches prevent API overload
• Error Recovery: Robust handling of network timeouts and API errors
• Batch Processing: Efficient processing of multiple domains in sequence
• Memory Management: Optimized data handling for large result sets

Resources & Documentation

API Documentation

• Tomba API Docs - Complete API reference and guides
• Authentication Guide - Get your API keys and setup
• Pricing & Limits - Understand rate limits and costs
• Domain Search API - Specific endpoint documentation