Phone Validator Actor

This Apify Actor validates phone numbers and retrieves associated information using the Tomba Phone Validator API. It's designed for data cleaning, contact verification, and phone number enrichment.

Overview

The actor takes a list of phone numbers, validates them via the Tomba API, and returns detailed information for each, including carrier, line type, and location. It handles bulk processing with built-in rate limiting (150 requests per minute).

Key Features

• Validation & Enrichment: Validates phone numbers from any country and returns carrier, line type, and location data.
• Format Support: Outputs numbers in multiple standard formats (E.164, national, international, RFC3966).
• Bulk Processing: Efficiently processes hundreds of numbers with automatic rate limit management.
• Robust Handling: Includes comprehensive error reporting and optional country code hints for accurate validation.

How to Use

Prerequisites

You need a Tomba account. Get your API credentials from the Tomba API Dashboard.
* API Key: Starts with ta_
* Secret Key: Starts with ts_

Input Configuration

Provide input as a JSON object. Required parameters are tombaApiKey and tombaApiSecret. The core data is the phoneNumbers array.

Basic Example:

{
  "tombaApiKey": "ta_xxxxxxxxxxxxxxxxxxxx",
  "tombaApiSecret": "ts_xxxxxxxxxxxxxxxxxxxx",
  "phoneNumbers": [
    { "phoneNumber": "+1 (555) 123-4567" },
    { "phoneNumber": "07911 123456", "countryCode": "GB" }
  ],
  "maxResults": 50
}

Each item in phoneNumbers must be an object with a phoneNumber property. The countryCode (e.g., "US", "GB") is optional but recommended for numbers without a leading + to ensure accurate validation.

Input/Output

Input: An array of phone number objects. The actor authenticates with your Tomba keys and processes each number through the Tomba Validator API.

Output: For each validated number, the actor returns a detailed object including:
* phoneNumber: The original input.
* valid: Boolean indicating if the number is valid.
* carrier: Phone carrier information.
* lineType: e.g., mobile, landline, VoIP.
* location: Geographic data (country, region, timezone).
* format: The number in national and international formats.

Results are saved to the Apify dataset for your run.