Phone Finder Actor

An Apify Actor that finds and validates phone numbers using the Tomba API. It's designed for lead generation, allowing you to search by email address, domain, or LinkedIn profile URL.

Key Features

• Multi-Source Search: Find phone numbers using an email, a domain, or a LinkedIn profile URL.
• Data Enrichment: Returns validation status, carrier information, line type (e.g., mobile), and location.
• Formatted Output: Provides phone numbers in local, international (E.164), and RFC 3966 formats.
• Bulk Processing: Handles an array of search queries in a single run.
• Rate Limit Handling: Automatically respects the Tomba API limit of 150 requests per minute.

How to Use

Prerequisites

You need a Tomba account. Get your API Key (starts with ta_) and Secret Key (starts with ts_) from the Tomba API Dashboard.

Input Configuration

Configure the Actor with the following input parameters.

Required:
* tombaApiKey (string): Your Tomba API Key.
* tombaApiSecret (string): Your Tomba Secret Key.
* searches (array): A list of search query objects.

Optional:
* maxResults (number): Limits the total results returned. Default is 50.

Search Query Structure

Each object in the searches array can use one or more of these fields:

{
  "email": "name@company.com",
  "domain": "company.com",
  "linkedin": "https://linkedin.com/in/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
}

Output

The Actor returns an array of objects, one for each successfully discovered phone number.

Example Output

{
  "email": "john@example.com",
  "valid": true,
  "local_format": "(555) 123-4567",
  "intl_format": "+1 555 123 4567",
  "e164_format": "+15551234567",
  "country_code": "US",
  "line_type": "mobile",
  "carrier": "Verizon Wireless",
  "source": {
    "search_type": "email",
    "search_value": "john@example.com"
  }
}

Output Fields

• Contact Info: email, domain, linkedin (whichever was used for the search).
• Validation & Formatting: valid, local_format, intl_format, e164_format.
• Carrier & Location: country_code, line_type, carrier.
• Source Tracking: source object detailing the original search query.