Tomba Phone Finder Actor

A powerful Apify Actor that discovers phone numbers using the Tomba Phone Finder API. Perfect for sales teams, recruiters, and researchers who need to find phone numbers associated with email addresses, domains, or LinkedIn profiles.

Key Features

• Phone Discovery: Find phone numbers using email addresses, domains, or LinkedIn profiles
• Multiple Search Methods: Support for email, domain, and LinkedIn-based searches
• Phone Validation: Get validation status for discovered phone numbers
• Carrier Information: Identify phone carriers and line types
• International Support: Handle phone numbers from multiple countries
• Rate Limited: Respects Tomba's 150 requests per minute limit
• Bulk Processing: Process multiple search queries efficiently
• Detailed Formatting: Get phone numbers in both national and international formats

How it works

The Actor leverages Tomba's powerful Phone Finder API to discover phone numbers:

What You Get

For each discovered phone number, you'll receive:

• Phone Number: The actual phone number discovered
• Validation: Whether the number is valid
• Formatting: National and international formats
• Carrier Info: Phone carrier and line type
• Location: Country and country code
• Source Tracking: Which search query led to this discovery

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) | | searches | array | [] | Array of search queries |

Optional Parameters

Parameter	Type	Default	Description
maxResults	number	50	Maximum number of results to return

Search Query Structure

Each search query can contain one or more of:

{
    "email": "john@example.com", // Find phone for this email
    "domain": "example.com", // Find phones for this domain
    "linkedin": "https://linkedin.com/in/johndoe" // Find phone for LinkedIn profile
}

Example Input

{
    "tombaApiKey": "ta_xxxxxxxxxxxxxxxxxxxx",
    "tombaApiSecret": "ts_xxxxxxxxxxxxxxxxxxxx",
    "searches": [
        {
            "email": "john@example.com"
        },
        {
            "domain": "shopify.com"
        },
        {
            "linkedin": "https://linkedin.com/in/johndoe"
        }
    ],
    "maxResults": 100
}

Best Practices

• Search Variety: Use different search methods (email, domain, LinkedIn) for better coverage
• Rate Limits: The Actor automatically handles Tomba's 150 requests/minute limit
• Batch Size: Process 10-50 queries at a time for optimal performance
• A short guide on how to build web scrapers using code templates: