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: json { "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: bash npm install 3. Run tests: bash npm test 4. Run the Actor locally: bash apify run