Clearbit Replacement

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	500M+ 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

Code
 
# 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

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

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

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
2. Navigate to API Keys
3. Copy your API Key and Secret

Step 2: Update Authentication

Clearbit:

Code
 
headers: {
  'Authorization': 'Bearer sk_clearbit_xxx'
}

Tomba:

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

Step 3: Update Endpoints

Replace base URLs:

Code
 
// 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:

Code
 
// 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:

Code
 
// 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

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

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

Domain Search (Not Available in Clearbit)

Code
 
# 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

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

# Returns: Competitors and similar companies

Author Finder (Content Marketing Gold)

Code
 
# 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

Code
 
# 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

Code
 
// 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

Code
 
# 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

Code
 
// 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
• Person API Guide
• Combined API Guide
• Full API Documentation

Tools & Integrations

• Chrome Extension
• Google Sheets Add-on
• Microsoft Excel Add-in
• Airtable Extension
• MCP Server for AI

Get Help

• Email: support@tomba.io
• Documentation: docs.tomba.io
• API Status: 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.

How accurate is Tomba compared to Clearbit?

Tomba maintains 98%+ accuracy with our 500M+ 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 →