# Clearbit API Replacement - Migrate to Tomba

Following Clearbit's shutdown announcement, this guide will help you seamlessly transition to Tomba as your Clearbit alternative for company enrichment, person enrichment, and combined data lookups.

---

## Why Choose Tomba as Your Clearbit Replacement?

| Feature                    | Clearbit         | Tomba                            |
| -------------------------- | ---------------- | -------------------------------- |
| **Service Status**         | ⚠️ Shutting down | ✅ Active & growing              |
| **Database Size**          | ~200M contacts   | 450M+ emails                     |
| **Company Enrichment**     | ✅               | ✅ Enhanced with tech stack      |
| **Person Enrichment**      | ✅               | ✅ Plus phone & LinkedIn         |
| **Combined API**           | ✅               | ✅ Person + Company in one call  |
| **Email Verification**     | No               | FREE with every search           |
| **Phone Finder**           | Limited          | Phone Finder & Phone Validator   |
| **Technology Detection**   | Basic            | 6000+ technologies tracked       |
| **Similar Companies**      | No               | Find lookalike companies         |
| **Author Finder**          | No               | Extract contacts from articles   |
| **LinkedIn Integration**   | Basic            | Direct profile to email          |
| **Domain Search**          | No               | Find all contacts at a company   |
| **API Rate Limits**        | 600 req/min      | 300 req/min                      |
| **Data Freshness**         | Monthly          | Real-time + quarterly updates    |
| **Excel Integration**      | ❌               | ✅ Native add-in                 |
| **Airtable Extension**     | ❌               | ✅ Native extension              |
| **MCP/AI Integration**     | ❌               | ✅ Claude, ChatGPT, Cursor, etc. |
| **Pricing (10k requests)** | $999/month       | ~$119/month (88% savings)        |

---

## Migration Overview

Tomba provides direct replacements for all three Clearbit APIs:

### API Mapping

| Clearbit API                        | Tomba Replacement | Description                      |
| ----------------------------------- | ----------------- | -------------------------------- |
| **Company API** (`/companies/find`) | `/companies/find` | Lookup company data by domain    |
| **Person API** (`/people/find`)     | `/people/find`    | Enrich person data by email      |
| **Combined API** (`/combined/find`) | `/combined/find`  | Get person + company in one call |

### Quick Comparison

```bash
# Clearbit Company API
GET https://company.clearbit.com/v2/companies/find?domain=tomba.io

# Tomba Company API (drop-in replacement)
GET https://api.tomba.io/v1/companies/find?domain=tomba.io
```

---

## Migration Guides

Choose your migration path based on which Clearbit APIs you're currently using:

### 1. [Company API Migration](/migration/clearbit/company-api)

Replace Clearbit's Company API with Tomba's enhanced company enrichment.

**What you get:**

- Company name, description, industry
- Location, employee count, revenue
- Social profiles (LinkedIn, Twitter, Facebook)
- Logo and brand assets
- **Plus:** Technology stack (6000+ techs)
- **Plus:** Similar companies finder

### 2. [Person API Migration](/migration/clearbit/person-api)

Replace Clearbit's Person API with Tomba's comprehensive person enrichment.

**What you get:**

- Full name, position, department
- Company affiliation
- Social profiles (LinkedIn, Twitter, GitHub)
- Location and timezone
- **Plus:** Phone numbers with validation
- **Plus:** Email verification (FREE)
- **Plus:** LinkedIn profile extraction

### 3. [Combined API Migration](/migration/clearbit/combined-api)

Replace Clearbit's Combined API to get both person and company data in a single call.

**What you get:**

- Everything from Person API
- Everything from Company API
- Reduced API calls (1 instead of 2)
- Lower latency
- **Plus:** All Tomba enhancements

---

## Key Differences from Clearbit

### ✅ What's Better in Tomba

1. **Free Email Verification**: Every email is verified automatically
2. **Phone Data**: Access to phone numbers with carrier info
3. **Technology Stack**: Detect 6000+ technologies used by companies
4. **LinkedIn Integration**: Extract emails directly from LinkedIn profiles
5. **Domain Search**: Find all contacts at a company (not available in Clearbit)
6. **Similar Companies**: Expand your TAM with lookalike finder
7. **Author Finder**: Extract contacts from blog posts and articles
8. **Cost**: 70-88% cheaper than Clearbit
9. **AI Integration**: Native MCP support for Claude, ChatGPT, etc.

### ⚠️ Migration Considerations

1. **Rate Limits**: Tomba offers 300 req/min (vs Clearbit's 600)
    - **Solution**: Use bulk operations for high-volume needs
2. **Response Format**: Similar but with additional fields
    - **Solution**: Update type definitions to include new fields
3. **Some Field Names Differ**: Minor mapping required
    - **Solution**: We provide complete field mapping in each guide

---

## Migration Steps

### Step 1: Get Your Tomba API Keys

1. Sign up at [app.tomba.io/auth/register](https://app.tomba.io/auth/register)
2. Navigate to [API Keys](https://app.tomba.io/api)
3. Copy your API Key and Secret

### Step 2: Update Authentication

**Clearbit:**

```javascript
headers: {
  'Authorization': 'Bearer sk_clearbit_xxx'
}
```

**Tomba:**

```javascript
headers: {
  'X-Tomba-Key': 'your-api-key',
  'X-Tomba-Secret': 'your-secret-key'
}
```

### Step 3: Update Endpoints

Replace base URLs:

```javascript
// Old
const CLEARBIT_BASE = "https://company.clearbit.com/v2";

// New
const TOMBA_BASE = "https://api.tomba.io/v1";
```

### Step 4: Test in Parallel (Recommended)

Run both APIs in parallel during transition:

```javascript
// Dual-mode for safe migration
const results = await Promise.allSettled([
    getClearbitData(email),
    getTombaData(email),
]);

// Use Tomba if available, fallback to Clearbit
const data =
    results[1].status === "fulfilled" ? results[1].value : results[0].value;
```

### Step 5: Update Type Definitions

Tomba provides enhanced data - update your types:

```typescript
// Enhanced company type with Tomba fields
interface Company {
    // Clearbit fields (maintained)
    name: string;
    domain: string;
    description: string;

    // New Tomba fields
    technologies?: Technology[];
    similar_domains?: string[];
    email_count?: number;
    phone_number?: string;
}
```

### Step 6: Migrate Completely

Once validated, remove Clearbit code and use Tomba exclusively.

---

## Cost Comparison Calculator

Calculate your savings:

| Usage Level  | Clearbit Cost/mo | Tomba Cost/mo | Annual Savings |
| ------------ | ---------------- | ------------- | -------------- |
| 1,000 calls  | $99              | $12           | $1,044         |
| 5,000 calls  | $499             | $59           | $5,280         |
| 10,000 calls | $999             | $119          | $10,560        |
| 25,000 calls | $2,499           | $273          | $26,712        |
| 50,000 calls | $4,999           | $490          | $54,108        |

**Average savings: 80-88%**

---

## Enhanced Features Only in Tomba

### Technology Stack Detection

```bash
# Discover what technologies a company uses
GET https://api.tomba.io/v1/technology?domain=stripe.com

# Response includes: Payment gateways, Analytics, CRM, Marketing tools, etc.
```

### Domain Search (Not Available in Clearbit)

```bash
# Find all contacts at a company
GET https://api.tomba.io/v1/domain-search?domain=stripe.com&limit=50

# Returns: All employees with verified emails
```

### Similar Companies Finder

```bash
# Find companies similar to your target
GET https://api.tomba.io/v1/similar?domain=salesforce.com

# Returns: Competitors and similar companies
```

### Author Finder (Content Marketing Gold)

```bash
# Extract author contact from article URL
GET https://api.tomba.io/v1/author-finder?url=https://stripe.com/blog/api-versioning

# Returns: Author email, name, social profiles
```

### LinkedIn to Email

```bash
# Convert LinkedIn profile to email
GET https://api.tomba.io/v1/linkedin-finder?url=https://linkedin.com/in/username

# Returns: Email + full profile data
```

---

## Integration Examples

### Node.js Migration

```javascript
// Before (Clearbit)
const clearbit = require("clearbit")("sk_clearbit_xxx");
const company = await clearbit.Company.find({ domain: "stripe.com" });

// After (Tomba)
const axios = require("axios");
const response = await axios.get("https://api.tomba.io/v1/companies/find", {
    params: { domain: "stripe.com" },
    headers: {
        "X-Tomba-Key": "your-key",
        "X-Tomba-Secret": "your-secret",
    },
});
const company = response.data.data;
```

### Python Migration

```python
# Before (Clearbit)
import clearbit
clearbit.key = 'sk_clearbit_xxx'
company = clearbit.Company.find(domain='stripe.com')

# After (Tomba)
import requests
response = requests.get(
    'https://api.tomba.io/v1/companies/find',
    params={'domain': 'stripe.com'},
    headers={
        'X-Tomba-Key': 'your-key',
        'X-Tomba-Secret': 'your-secret'
    }
)
company = response.json()['data']
```

### PHP Migration

```php
// Before (Clearbit)
$clearbit = new Clearbit\Clearbit('sk_clearbit_xxx');
$company = $clearbit->company->find(['domain' => 'stripe.com']);

// After (Tomba)
$client = new GuzzleHttp\Client();
$response = $client->get('https://api.tomba.io/v1/companies/find', [
    'query' => ['domain' => 'stripe.com'],
    'headers' => [
        'X-Tomba-Key' => 'your-key',
        'X-Tomba-Secret' => 'your-secret'
    ]
]);
$company = json_decode($response->getBody())->data;
```

---

## Migration Checklist

- [ ] Sign up for Tomba account
- [ ] Generate API keys
- [ ] Review API mapping for your use case
- [ ] Update authentication headers
- [ ] Update base URLs and endpoints
- [ ] Test Company API replacement
- [ ] Test Person API replacement
- [ ] Test Combined API replacement
- [ ] Update type definitions/interfaces
- [ ] Implement parallel testing (optional)
- [ ] Update error handling
- [ ] Test edge cases
- [ ] Deploy to staging
- [ ] Monitor for issues
- [ ] Deploy to production
- [ ] Remove Clearbit dependencies
- [ ] Cancel Clearbit subscription

---

## Support & Resources

### Documentation

- [Company API Guide](/migration/clearbit/company-api)
- [Person API Guide](/migration/clearbit/person-api)
- [Combined API Guide](/migration/clearbit/combined-api)
- [Full API Documentation](https://docs.tomba.io)

### Tools & Integrations

- [Chrome Extension](https://chrome.google.com/webstore/detail/tomba-email-finder/icmjegjggphchjckknoooajmklibccjb)
- [Google Sheets Add-on](https://workspace.google.com/marketplace/app/tomba_email_extractor_email_finder_plus/915979967841)
- [Microsoft Excel Add-in](https://appsource.microsoft.com/en-us/product/office/WA200003632)
- [Airtable Extension](https://airtable.com/marketplace/blkzHq5ZaqM1hWS13/find-verify-emails-tomba)
- [MCP Server for AI](https://github.com/tomba-io/tomba-mcp-server)

### Get Help

- **Email**: [support@tomba.io](mailto:support@tomba.io)
- **Documentation**: [docs.tomba.io](https://docs.tomba.io)
- **API Status**: [status.tomba.io](https://status.tomba.io)
- **Community**: Join our Discord

---

## Frequently Asked Questions

### How long does migration take?

Most teams complete migration in 1-2 days. The API structure is similar to Clearbit, so changes are minimal.

### Will I lose any data during migration?

No. Tomba often provides MORE data than Clearbit, including phone numbers, technology stack, and email verification.

### What about my existing Clearbit integrations?

Tomba provides drop-in replacements for all three Clearbit APIs. Update the base URL and authentication, and you're done.

### Can I run both APIs in parallel?

Yes! We recommend running both during migration to ensure data quality and minimize risk.

### What's the refund policy?

We offer a 30-day money-back guarantee. If Tomba doesn't meet your needs, get a full refund.

### Do you offer migration support?

Yes! Our team can help with migration planning, code review, and implementation support. Contact [support@tomba.io](mailto:support@tomba.io).

### How accurate is Tomba compared to Clearbit?

Tomba maintains 98%+ accuracy with our 450M+ email database and automatic verification. Most users report equal or better data quality.

### What about GDPR compliance?

Tomba is fully GDPR compliant with data processing agreements available. We only provide publicly available business contact information.

---

**Ready to migrate from Clearbit?**

Get started with a free Tomba account - includes 50 free searches and 500 free verifications!

[Start Migration →](https://app.tomba.io/auth/register)