Tomba Clearbit-Combined Actor

A powerful Apify Actor that enriches person and company information using the Tomba Enrichment API. Perfect for sales teams, marketers, and researchers who need comprehensive person and company data for lead generation, market research, and business intelligence.

Key Features

• Person & Company Enrichment: Get detailed person and company information from email addresses
• Comprehensive Data: Organization details, location, social links, and contact info
• Industry Classification: Company industries and business categories
• Technology Stack: Technologies and tools used by companies
• Contact Information: Phone numbers and email addresses
• Rate Limited: Respects Tomba's 150 requests per minute limit
• Bulk Processing: Process multiple emails efficiently
• Error Handling: Robust error handling with detailed logging

How it works

The Actor leverages Tomba's powerful Company Enrichment API to gather comprehensive business information:

Process Flow

1. Authentication: Connects to Tomba API using your credentials
2. Email Processing: Accepts array of emails to enrich
3. Data Validation: Processes and validates company information
4. Rate Limiting: Automatically handles 150 requests/minute limit
5. Data Storage: Saves results to Apify dataset

What You Get

For each email, you'll receive:

• Company Details: Name, description, founding year, size
• Location Info: Country, city, state, address, postal code
• Contact Data: Phone numbers and email addresses
• Social Presence: Twitter, Facebook, LinkedIn profiles
• Business Intel: Industries, revenue, technologies used
• Source Tracking: Data source and processing status

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)
emails	array	Array of emails to enrich

Optional Parameters

Parameter	Type	Default	Description
maxResults	number	50	Maximum number of results to return

Example Input

{
    "tombaApiKey": "ta_xxxxxxxxxxxxxxxxxxxx",
    "tombaApiSecret": "ts_xxxxxxxxxxxxxxxxxxxx",
    "emails": ["user1@example.com", "user2@example.com", "user3@example.com"],
    "maxResults": 100
}

Best Practices

• Email Selection: Use clean email addresses
• Rate Limits: The Actor automatically handles Tomba's 150 requests/minute limit
• Batch Size: Process 10-50 emails at a time for optimal performance

Output Data Structure

The Actor returns comprehensive person and company enrichment data for each email:

Example Output

{
    "person": {
        "name": {
            "fullName": "xxx xxx",
            "givenName": "xxx",
            "familyName": "xx"
        },
        "email": "****@ipinfo.io",
        "location": "US",
        "gender": "male",
        "geo": {
            "city": null,
            "state": null,
            "country": "United States",
            "countryCode": "US"
        },
        "employment": {
            "domain": "ipinfo.io",
            "name": "IPInfo",
            "title": "founder",
            "role": "executive"
        },
        "linkedin": {
            "handle": "https://www.linkedin.com/in/****"
        },
        "twitter": {
            "handle": "https://twitter.com/**"
        },
        "verification": {
            "date": "2025-08-13T00:00:00+02:00",
            "status": "valid"
        },
        "phone": true
    },
    "company": {
        "name": "IPInfo",
        "legalName": "IPInfo",
        "domain": "ipinfo.io",
        "site": {
            "phoneNumbers": null,
            "emailAddresses": ["****@ipinfo.io", "**@ipinfo.io", "**@ipinfo.io"]
        },
        "category": {
            "sicCode": "73",
            "sic4Codes": ["7371", "7373", "7379"],
            "naicsCode": "51"
        },
        "tags": ["ip data", "ip address api", "cybersecurity", "saas"],
        "description": "with ipinfo, you can pinpoint your users' locations, customize their experiences, prevent fraud, ensure compliance, and so much more.",
        "foundedYear": "2013",
        "location": "US",
        "geo": {
            "streetAddress": "5616 49th ave sw",
            "city": "washington",
            "state": "washington",
            "postalCode": "1120",
            "country": "United States",
            "countryCode": "US"
        },
        "linkedin": {
            "handle": "ipinfo"
        },
        "twitter": {
            "handle": "ipinfoio"
        },
        "facebook": {
            "handle": "ipinfo.io/"
        },
        "whois": {
            "registrar_name": "101domain grs limited",
            "created_date": "2013-04-23T19:30:12+02:00",
            "referral_url": "http://101domain.com"
        },
        "emailProvider": "Google Workspace",
        "type": "privately held",
        "metrics": {
            "trafficRank": "1454",
            "employees": "1-10",
            "annualRevenue": "$1M-$10M",
            "estimatedAnnualRevenue": "$1M-$10M"
        },
        "tech": ["webpack", "Next.js", "React", "Google Cloud"],
        "techCategories": ["JavaScript Libraries", "Web Frameworks", "JavaScript Frameworks", "CDN"]
    },
    "domain": "**@ipinfo.io",
    "source": "tomba_enrichment"
}

Data Structure Overview

The output contains three main sections:

👤 Person Information

• Personal Details: Full name, location, gender, geographic data
• Professional Info: Employment details, job title, company, role level
• Contact & Social: Email verification, phone availability, LinkedIn/Twitter profiles
• Data Quality: Verification status and indexing timestamps

🏢 Company Information

• Business Basics: Company name, legal name, domain, description
• Company Classification: SIC codes, NAICS codes, business categories
• Location & Contact: Full address, phone numbers, email addresses
• Business Intelligence: Founded year, company size, revenue estimates
• Digital Presence: Social media handles, domain registration info
• Technology Stack: Technologies used and their categories
• Email Infrastructure: Email provider and system details

📊 Metadata

• Source Tracking: Data source identifier and processing information
• Quality Indicators: Verification dates, data freshness, and reliability scores

Key Benefits

• Dual Enrichment: Get both person and company data in one API call
• Comprehensive Coverage: 50+ data points per enrichment
• Real-time Verification: Email validation and deliverability checks
• Rich Context: Employment relationships, social profiles, and business intel
• Structured Data: Consistent JSON format for easy integration

Use Cases

• Lead Generation: Enrich prospect companies with detailed business information
• Market Research: Analyze company profiles and industry trends
• Sales Intelligence: Get comprehensive company data for better targeting
• Competitive Analysis: Research competitors and market positioning
• Data Enrichment: Enhance existing company databases with fresh information

Resources & Documentation

API Documentation

• Tomba API Docs - Complete API reference
• Authentication Guide - Get your API keys
• Pricing & Limits - Understand rate limits and costs