Skip to content

tomba-io/clearbit-person

Repository files navigation

Tomba Clearbit-Person Actor

Actor Tomba API Rate Limit

A powerful Apify Actor that enriches person information using the Tomba Person Enrichment API. Perfect for sales teams, marketers, and researchers who need comprehensive person data for lead generation, recruitment, and business intelligence based on email addresses.

Key Features

  • Person Enrichment: Get detailed person information from email addresses
  • Comprehensive Data: Personal details, employment information, location, and contact data
  • Professional Intelligence: Job titles, company information, department, and seniority levels
  • Social Profiles: LinkedIn, Twitter, and Facebook profile information
  • Email Verification: Real-time email validation and deliverability status
  • Rate Limited: Respects Tomba's 150 requests per minute limit
  • Bulk Processing: Process multiple email addresses efficiently
  • Error Handling: Robust error handling with detailed logging

How it works

The Actor leverages Tomba's powerful Person Enrichment API to gather comprehensive personal and professional information:

Process Flow

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

What You Get

For each email address, you'll receive:

  • Personal Details: Full name, location, gender, and profile information
  • Employment Data: Company name, job title, department, and seniority level
  • Contact Information: Email verification status and phone availability
  • Social Presence: LinkedIn, Twitter, and Facebook profile links
  • Professional Context: Company domain, role level, and employment timeline
  • 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": ["john@example.com", "jane@company.com", "contact@business.org"],
    "maxResults": 100
}

Best Practices

  • Email Selection: Use clean, valid email addresses for better results
  • 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 enrichment data for each email address:

Example Output

{
    "name": {
        "fullName": "John Doe",
        "givenName": "John",
        "familyName": "Doe"
    },
    "email": "john@example.com",
    "location": "US",
    "gender": "male",
    "geo": {
        "city": "San Francisco",
        "state": "California",
        "country": "United States",
        "countryCode": "US"
    },
    "employment": {
        "domain": "example.com",
        "name": "Example Inc",
        "title": "Senior Software Engineer",
        "role": "executive",
        "department": "engineering",
        "seniority": "senior"
    },
    "linkedin": {
        "handle": "https://www.linkedin.com/in/johndoe"
    },
    "twitter": {
        "handle": "https://twitter.com/johndoe"
    },
    "verification": {
        "date": "2025-10-20T00:00:00+02:00",
        "status": "valid"
    },
    "phone": true,
    "avatar": "https://example.com/avatar.jpg",
    "bio": "Senior Software Engineer with 10+ years experience",
    "website": "https://johndoe.com",
    "indexedAt": "2025-10-20T12:00:00+02:00",
    "source": "tomba_person_enrichment"
}

Data Structure Overview

The output contains comprehensive person information organized into logical sections:

Personal Information

  • Identity: Full name, first name, last name
  • Demographics: Gender, location, geographic details
  • Contact: Email verification status, phone availability
  • Digital Presence: Profile picture, personal website, bio

Professional Information

  • Employment: Company name, domain, job title, department
  • Career Level: Role type, seniority level, professional status
  • Industry Context: Company information and professional background

Social Profiles

  • LinkedIn: Professional profile URL and information
  • Twitter: Social media presence and handles
  • Facebook: Social network profiles when available

Data Quality & Metadata

  • Verification: Email validation status and verification dates
  • Source Tracking: Data source identification and processing status
  • Freshness: Index dates and data currency information

Key Benefits

  • Email-Based Enrichment: Perfect for person research based on email addresses
  • Comprehensive Coverage: 20+ data points per person enrichment
  • Real-time Verification: Email validation and deliverability checks
  • Professional Context: Employment details and career information
  • Social Intelligence: Social media profiles and digital presence

Use Cases

  • Lead Generation: Enrich prospect profiles with detailed personal and professional information
  • Recruitment: Research candidates and gather comprehensive background information
  • Sales Intelligence: Get detailed person data for better targeting and personalization
  • Market Research: Analyze professional profiles and industry connections
  • Data Enrichment: Enhance existing contact databases with fresh person information
  • Networking: Research contacts and build professional relationship context
  • Customer Research: Understand customer profiles and professional backgrounds

Resources & Documentation

API Documentation

FAQ

General Questions

Q: What is person enrichment? A: Person enrichment takes an email address and returns detailed information about the individual, including personal details, professional information, social profiles, and contact data.

Q: What kind of information can I get about people? A: You get personal details (name, location, demographics), professional info (job title, company, experience), social media profiles, and additional contact information.

Q: How accurate is the person data? A: Tomba maintains high-quality person data with regular updates. Accuracy is typically 85-95% for professional email addresses with public profiles.

Technical Questions

Q: Can I enrich any email address? A: Person enrichment works best with professional/business email addresses. Personal email domains (gmail.com, yahoo.com) may return limited information.

Q: How many emails can I enrich at once? A: You can process up to 1000 emails per run. For optimal performance, process 50-200 emails per batch.

Q: What if an email doesn't have public information? A: Some individuals have minimal public presence or privacy-focused profiles. Results will contain whatever publicly available information exists.

Business Applications

Q: How can this help with sales personalization? A: Detailed person profiles enable highly personalized outreach, better conversation starters, and more relevant value propositions based on role and background.

Q: Is this useful for recruitment? A: Yes! Understand candidate backgrounds, skills, experience levels, and professional interests to tailor recruitment approaches and assess fit.

Q: Can I use this for customer success? A: Absolutely! Understanding customer contacts' roles, backgrounds, and preferences helps provide more personalized service and support.

Keywords

Clearbit person, person enrichment, people data, individual profiles, contact enrichment, lead enrichment, personal data, professional profiles, contact intelligence, people intelligence, person API, contact data, individual enrichment, prospect enrichment

Support

If you need any help, have questions, or encounter any issues while using Tomba.io, please don't hesitate to reach out to our support team. You can contact us via:

  • Email: support@tomba.io
  • Live chat: Available on the Tomba.io website during business hours

Contributing

We welcome contributions to improve this actor. Please feel free to submit issues, feature requests, or pull requests to help make this tool even better for the community.

About Tomba

Founded in 2020, Tomba prides itself on being the most reliable, accurate, and in-depth source of email address data available anywhere. We process terabytes of data to produce our Email finder API.

Tomba Logo

About

Apify Actor that enriches person information using the Tomba Person Enrichment API

Topics

Resources

Stars

Watchers

Forks