phone number lookup avatar
phone number lookup
Under maintenance

Pricing

Pay per event

Go to Apify Store
phone number lookup

phone number lookup

Under maintenance

A powerful Apify Actor to validate, format, and retrieve detailed information about phone numbers. It supports a free offline mode using `google-libphonenumber` and integrates with premium providers like Twilio, Numverify, and Telesign for advanced carrier and reputation data.

Pricing

Pay per event

Rating

0.0

(0)

Developer

christopher athans crow

christopher athans crow

Maintained by Community

Actor stats

0

Bookmarked

3

Total users

1

Monthly active users

7 days ago

Last modified

Share

Phone Number Lookup Actor

A powerful Apify Actor to validate, format, and retrieve detailed information about phone numbers. It supports a free offline mode using google-libphonenumber and integrates with premium providers like Twilio, Numverify, and Telesign for advanced carrier and reputation data.

Features

  • Validation: Check if a phone number is valid and possible.
  • Formatting: Convert numbers to E.164, National, and International formats.
  • Geographic Data: Get the country, region, and location associated with the number.
  • Bulk Processing: Process thousands of numbers in a single run.
  • Caching: Built-in 24-hour caching to save on API costs for repeated lookups.
  • Multi-Provider:
    • Google Libphonenumber (Default, Free, Offline): Basic validation and formatting.
    • Twilio: Advanced carrier info and fraud risk.
    • Numverify: Global carrier and location data.
    • Telesign: Identity and risk scoring.

Input Parameters

FieldTypeDescriptionDefault
phoneNumbersArrayList of phone numbers to process.[]
phoneNumberStringSingle phone number to process (legacy support).null
countryCodeStringISO 3166-1 alpha-2 country code (e.g., 'US') for parsing local numbers.US
useCacheBooleanCache results for 24 hours.true
providerStringProvider to use: google-libphonenumber, twilio, numverify, telesign.google-libphonenumber

Provider Configuration

If you select a premium provider, you must provide the corresponding API credentials in the input:

  • Twilio: twilioAccountSid, twilioAuthToken
  • Numverify: numverifyApiKey
  • Telesign: telesignCustomerId, telesignApiKey

Output Example

The Actor pushes results to the default dataset. Each item looks like this:

{
"input": {
"phoneNumber": "+16502530000",
"countryCode": "US",
"provider": "google-libphonenumber"
},
"unified": {
"valid": true,
"formatted": {
"e164": "+16502530000",
"national": "(650) 253-0000",
"international": "+1 650-253-0000",
"rfc3966": "tel:+1-650-253-0000"
},
"countryCode": "US",
"type": "FIXED_LINE_OR_MOBILE",
"location": null,
"carrier": "Not Available (Offline Provider)",
"reputation": "Not Available (Offline Provider)"
},
"fromCache": false
}

Local Development

  1. Clone the repository.
  2. Install dependencies:
    $npm install
  3. Run tests:
    $npm test
  4. Run the Actor locally:
    $apify run