Clearbit Person Actor

An Apify Actor that enriches personal and professional information using the Tomba Person Enrichment API. It's designed for lead generation, recruitment, and business intelligence by processing email addresses.

Overview

This actor takes email addresses as input and returns detailed person profiles by querying the Tomba API. It handles authentication, rate limiting (150 requests/minute), and error logging automatically. The output is saved to an Apify dataset.

Key Features

• Person Enrichment: Fetches detailed data from email addresses.
• Comprehensive Data: Returns personal details, employment info, location, and contact data.
• Professional Intelligence: Includes job title, company, department, and seniority level.
• Social Profiles: Provides links to LinkedIn, Twitter, and Facebook profiles.
• Email Verification: Returns real-time email validation and deliverability status.
• Bulk Processing: Efficiently handles arrays of email addresses.

How to Use

Prerequisites

You need a Tomba account. Sign up at Tomba.io to get your API credentials.

Input Configuration

Configure the actor run with the following input parameters.

Required:
* tombaApiKey (string): Your Tomba API key (starts with ta_).
* tombaApiSecret (string): Your Tomba secret key (starts with ts_).
* emails (array): An array of email strings to enrich.

Optional:
* maxResults (number): Maximum number of results to return. Default is 50.

Example Input:

{
  "tombaApiKey": "ta_xxxxxxxxxxxxxxxxxxxx",
  "tombaApiSecret": "ts_xxxxxxxxxxxxxxxxxxxx",
  "emails": ["john@example.com", "jane@company.com"],
  "maxResults": 100
}

Best Practices:
* Use clean, valid email addresses for better match rates.
* The actor manages the 150 requests/minute limit internally.
* For optimal performance, process batches of 10-50 emails at a time.

Input/Output

Process Flow

1. Authenticates with the Tomba API using your provided keys.
2. Processes and validates the list of email addresses.
3. Enriches data for each email, respecting rate limits.
4. Saves the results to the Apify dataset.

Output Data

For each successfully enriched email, the output includes a structured profile.

Example Output Structure:

{
  "name": {
    "fullName": "John Doe",
    "givenName": "John",
    "familyName": "Doe"
  },
  "email": "john@example.com",
  "location": "US",
  "employment": {
    "domain": "example.com",
    "name": "Example Inc",
    "title": "Senior Software Engineer"
  },
  "social": {
    "linkedin": "linkedin.com/in/johndoe",
    "twitter": "twitter.com/johndoe"
  }
}

Data Points Included:
* Personal: Full name, gender, location, and geo details (city, state, country).
* Professional: Company name, domain, job title, department, seniority, and employment timeline.
* Contact: Email verification status and phone number availability.
* Social: URLs for LinkedIn, Twitter, and Facebook profiles.
* Metadata: Data source and processing status.