# Clearbit Person (`tomba-io/clearbit-person`) Actor

Enriches person information using the Tomba Person Enrichment API

- **URL**: https://apify.com/tomba-io/clearbit-person.md
- **Developed by:** [Tomba io](https://apify.com/tomba-io) (community)
- **Categories:** Lead generation, SEO tools, Open source
- **Stats:** 20 total users, 0 monthly users, 100.0% runs succeeded, 2 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.01 / 1,000 results

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).

# README

## Tomba Clearbit-Person Actor

[![Actor](https://img.shields.io/badge/Apify-Actor-blue)](https://apify.com/actors)
[![Tomba API](https://img.shields.io/badge/Tomba-API-green)](https://tomba.io)
[![Rate Limit](https://img.shields.io/badge/Rate%20Limit-150%2Fmin-orange)](https://tomba.io/api)

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](https://app.tomba.io/api) to get your API credentials

#### Getting Your API Keys

1. Visit [Tomba API Dashboard](https://app.tomba.io/api)
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

```json
{
    "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

```json
{
    "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

- [Tomba API Docs](https://docs.tomba.io/introduction) - Complete API reference
- [Authentication Guide](https://app.tomba.io/api) - Get your API keys
- [Pricing & Limits](https://tomba.io/pricing) - Understand rate limits and costs
- [Person Enrichment API](https://docs.tomba.io/api/enrichment#person-api) - Specific endpoint 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](https://tomba.io/logo.png)

# Actor input Schema

## `tombaApiKey` (type: `string`):

Your Tomba API key (ta\_xxxx). Get it from https://app.tomba.io/api

## `tombaApiSecret` (type: `string`):

Your Tomba secret key (ts\_xxxx). Get it from https://app.tomba.io/api

## `emails` (type: `array`):

Array of email addresses to enrich with person information.

## `maxResults` (type: `integer`):

Maximum number of people to enrich. Default is 50.

## Actor input object example

```json
{
  "tombaApiKey": "ta_xxxxxxxxxxxxxxxxxxxx",
  "tombaApiSecret": "ts_xxxxxxxxxxxxxxxxxxxx",
  "emails": [
    "john@example.com",
    "jane@company.com",
    "contact@business.org"
  ],
  "maxResults": 50
}
```

# Actor output Schema

## `results` (type: `string`):

Detailed person profiles with professional data and social media information

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "tombaApiKey": "ta_xxxxxxxxxxxxxxxxxxxx",
    "tombaApiSecret": "ts_xxxxxxxxxxxxxxxxxxxx",
    "emails": [
        "john@stripe.com",
        "contact@tomba.io"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("tomba-io/clearbit-person").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "tombaApiKey": "ta_xxxxxxxxxxxxxxxxxxxx",
    "tombaApiSecret": "ts_xxxxxxxxxxxxxxxxxxxx",
    "emails": [
        "john@stripe.com",
        "contact@tomba.io",
    ],
}

# Run the Actor and wait for it to finish
run = client.actor("tomba-io/clearbit-person").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "tombaApiKey": "ta_xxxxxxxxxxxxxxxxxxxx",
  "tombaApiSecret": "ts_xxxxxxxxxxxxxxxxxxxx",
  "emails": [
    "john@stripe.com",
    "contact@tomba.io"
  ]
}' |
apify call tomba-io/clearbit-person --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,tomba-io/clearbit-person"
        }
    }
}

```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/IwbNAw9DWYFZ0hDpe/builds/Q6dWdik77nFhKRD4t/openapi.json