phone number lookup
Pricing
Pay per event
phone number lookup
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
Actor stats
0
Bookmarked
3
Total users
1
Monthly active users
7 days ago
Last modified
Categories
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
| Field | Type | Description | Default |
|---|---|---|---|
phoneNumbers | Array | List of phone numbers to process. | [] |
phoneNumber | String | Single phone number to process (legacy support). | null |
countryCode | String | ISO 3166-1 alpha-2 country code (e.g., 'US') for parsing local numbers. | US |
useCache | Boolean | Cache results for 24 hours. | true |
provider | String | Provider 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
- Clone the repository.
- Install dependencies:
$npm install
- Run tests:
$npm test
- Run the Actor locally:
$apify run
