phone number lookup avatar
phone number lookup
Under maintenance

Pricing

from $0.10 / 1,000 results

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

from $0.10 / 1,000 results

Rating

0.0

(0)

Developer

christopher athans crow

christopher athans crow

Maintained by Community

Actor stats

0

Bookmarked

19

Total users

9

Monthly active users

a month 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