Pricing

Pay per usage

Superclean Phone Numbers

Format, parse, and clean phone numbers in bulk. Normalize to E.164, International, or National format. Validates numbers, detects type (mobile/landline/toll-free), handles vanity numbers like 1-800-FLOWERS, and extracts extensions. For CRM exports and lead data cleanup.

Pricing

Pay per usage

Rating

0.0

(0)

Developer

Superlative

Actor stats

Bookmarked

Total users

Monthly active users

10 days ago

Last modified

Phone Number Validator — Format, Country & Line Type

junipr/phone-number-validator

Validate, parse, normalize, and format phone numbers in bulk with country, type, E.164, national format, and validity status.

junipr

Bulk Phone Number Validator — E.164, Carrier & Line Type

haketa/bulk-phone-validator

Validate and format thousands of phone numbers at once: validity, E.164 / international / national format, line type (mobile, landline, VoIP, toll-free), country, carrier, timezone and area. Fast, offline, keyless phone-list cleaning for CRM, SMS and leads.

Haketa

Phone Number Validator

automation-lab/phone-number-validator

Validate and format phone numbers using Google libphonenumber. Returns validity, type (mobile, fixed-line, VoIP), country, E.164 format, national format, and carrier info. Process up to 10,000 numbers per run. Ideal for CRM cleanup and lead enrichment.

Stas Persiianenko

5.0

Phone Number Validation - Normalize & Check Numbers

benthepythondev/phone-number-validation

Validate, normalize and enrich phone numbers: E.164, international/national format, country code, region, location, carrier, timezone and number type.

Ben

Phone Number Validator & Formatter

bgfc97/phone-number-validator

Validate and format international phone numbers in bulk (offline, libphonenumber). Detect country, line type (mobile/landline), E.164, national and international formats. Lead-gen and data cleaning. No key, no proxy.

Bruno

Bulk Phone Number Validator - Line Type, Carrier & E.164 Format

flash_scraper/phone-number-validator

Validate, format & classify phone numbers in bulk with Google's libphonenumber. Per number: valid/invalid, E.164 + national + international formats, country, calling code, line type (mobile/landline/VoIP/toll-free) & carrier. Clean lists before you dial. No API key, no proxies, no network.

Flash Scrape

Phone Number Formatter

avqelle/phone-number-formatter

Validate and format phone numbers from any country into E.164, international, and national formats. Detects country, region, and line type (mobile, landline, VoIP) using Google's libphonenumber. Supports 250+ countries.

Avqelle Labs

Phone Number Validation API

maximedupre/phone-number-validation

Check phone numbers against their numbering plan and format valid numbers. Get E.164, national, and international forms, plus country, line type, location, and likely time zones.

Maxime Dupré

Phone Number Validator API - E.164, Line Type & Risk Flags

george.the.developer/phone-number-validator

Validate and normalize phone numbers. Returns E.164, national/international format, country, calling code, line type, tel URI, and risk flags. Invalid rows are free.

George Kioko

Phone Number Validator - Bulk International Phone Validation

santamaria-automations/phone-validator

Validate and format phone numbers in bulk. Detect country, number type (mobile/landline/VoIP), carrier, timezone, and geographic region. Powered by Google's libphonenumber — the industry standard used by major platforms. Perfect for CRM cleanup, lead validation, and SMS campaigns.

NanoScrape

{ "name": "superclean-phone-numbers", "version": "0.1.0", "type": "module", "description": "Clean messy phone numbers from lead exports. Normalize formats, validate numbers, detect type.", "main": "src/main.js", "scripts": { "start": "node src/main.js", "test": "node --test" }, "author": "Superlative", "license": "ISC", "dependencies": { "apify": "^3.3.2", "libphonenumber-js": "^1.10.0" } }

{ "actorOutputSchemaVersion": 1, "title": "Superclean Phone Numbers Output", "description": "Cleaned phone numbers with validation status, type detection, and multiple format options.", "properties": { "allResults": { "type": "string", "title": "All Results", "description": "All cleaned phone numbers with original values, formatted output, and metadata", "template": "{{links.apiDefaultDatasetUrl}}/items" } } }

{ "openapi": "3.0.3", "info": { "title": "Superclean Phone Numbers — Standby API", "description": "Instant phone number cleaning and validation via HTTP GET. Format to E.164/international/national, detect type, handle vanity numbers. Returns the same fields as batch mode.", "version": "0.2.0" }, "paths": { "/": { "get": { "summary": "Clean a phone number", "description": "Clean, validate, and format a single phone number. Detects type (mobile/landline/toll-free), handles vanity numbers, extracts extensions.", "operationId": "cleanPhoneNumber", "parameters": [ { "name": "input", "in": "query", "description": "Phone number to clean (e.g. `(555) 123-4567`).", "required": true, "schema": { "type": "string", "example": "(555) 123-4567" } }, { "name": "defaultCountry", "in": "query", "description": "2-letter ISO country code for numbers without a country prefix.", "required": false, "schema": { "type": "string", "default": "US", "example": "US" } }, { "name": "outputFormat", "in": "query", "description": "Output format for the cleaned number.", "required": false, "schema": { "type": "string", "enum": ["e164", "international", "national"], "default": "e164" } } ], "responses": { "200": { "description": "Cleaned phone number result with validation and type detection.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CleanedPhoneNumber" }, "examples": { "usNumber": { "summary": "US phone number", "value": { "id": 1, "input": "(555) 123-4567", "output": "+15551234567", "e164": "+15551234567", "isValid": true, "type": "fixed_line_or_mobile", "countryCode": "US", "extension": null } }, "ukNumber": { "summary": "UK phone number", "value": { "id": 1, "input": "020 7946 0958", "output": "+442079460958", "e164": "+442079460958", "isValid": true, "type": "fixed_line", "countryCode": "GB", "extension": null } } } } } }, "400": { "description": "Invalid request — missing input, invalid country code, or invalid output format.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "error": "Provide an 'input' query parameter with the phone number to clean." } } } }, "405": { "description": "Method not allowed — only GET is supported.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "error": "Method not allowed. Use GET." } } } } } } } }, "components": { "schemas": { "CleanedPhoneNumber": { "type": "object", "required": ["id", "input", "output", "isValid"], "properties": { "id": { "type": "integer", "description": "Row number (always 1 for single-item Standby requests)." }, "input": { "type": "string", "description": "Original phone number before cleaning." }, "output": { "type": "string", "nullable": true, "description": "Formatted phone number in the requested output format." }, "e164": { "type": "string", "nullable": true, "description": "Phone number in E.164 format." }, "isValid": { "type": "boolean", "description": "Whether the phone number is valid." }, "type": { "type": "string", "nullable": true, "description": "Phone number type (mobile, fixed_line, toll_free, voip, etc.)." }, "countryCode": { "type": "string", "nullable": true, "description": "ISO 3166-1 alpha-2 country code." }, "extension": { "type": "string", "nullable": true, "description": "Phone extension if detected." } } }, "Error": { "type": "object", "required": ["error"], "properties": { "error": { "type": "string", "description": "Human-readable error message." } } } } } }

{ "title": "Superclean Phone Numbers", "description": "Paste your phone numbers below and click Start. Results will appear in the Output tab.", "type": "object", "schemaVersion": 1, "properties": { "items": { "title": "Phone Numbers", "type": "array", "description": "List of phone numbers to clean", "editor": "stringList", "minItems": 1, "prefill": ["(555) 123-4567"] }, "defaultCountry": { "title": "Default Country", "type": "string", "description": "Country to assume for numbers without a country code", "editor": "select", "default": "US", "prefill": "US", "enum": ["US","CA","GB","AU","DE","FR","IT","ES","NL","JP","BR","MX","IN","AC","AD","AE","AF","AG","AI","AL","AM","AO","AR","AS","AT","AW","AX","AZ","BA","BB","BD","BE","BF","BG","BH","BI","BJ","BL","BM","BN","BO","BQ","BS","BT","BW","BY","BZ","CC","CD","CF","CG","CH","CI","CK","CL","CM","CN","CO","CR","CU","CV","CW","CX","CY","CZ","DJ","DK","DM","DO","DZ","EC","EE","EG","EH","ER","ET","FI","FJ","FK","FM","FO","GA","GD","GE","GF","GG","GH","GI","GL","GM","GN","GP","GQ","GR","GT","GU","GW","GY","HK","HN","HR","HT","HU","ID","IE","IL","IM","IO","IQ","IR","IS","JE","JM","JO","KE","KG","KH","KI","KM","KN","KP","KR","KW","KY","KZ","LA","LB","LC","LI","LK","LR","LS","LT","LU","LV","LY","MA","MC","MD","ME","MF","MG","MH","MK","ML","MM","MN","MO","MP","MQ","MR","MS","MT","MU","MV","MW","MY","MZ","NA","NC","NE","NF","NG","NI","NO","NP","NR","NU","NZ","OM","PA","PE","PF","PG","PH","PK","PL","PM","PR","PS","PT","PW","PY","QA","RE","RO","RS","RU","RW","SA","SB","SC","SD","SE","SG","SH","SI","SJ","SK","SL","SM","SN","SO","SR","SS","ST","SV","SX","SY","SZ","TA","TC","TD","TG","TH","TJ","TK","TL","TM","TN","TO","TR","TT","TV","TW","TZ","UA","UG","UY","UZ","VA","VC","VE","VG","VI","VN","VU","WF","WS","XK","YE","YT","ZA","ZM","ZW"], "enumTitles": ["United States (+1)","Canada (+1)","United Kingdom (+44)","Australia (+61)","Germany (+49)","France (+33)","Italy (+39)","Spain (+34)","Netherlands (+31)","Japan (+81)","Brazil (+55)","Mexico (+52)","India (+91)","AC (+247)","AD (+376)","United Arab Emirates (+971)","AF (+93)","AG (+1)","AI (+1)","AL (+355)","AM (+374)","AO (+244)","Argentina (+54)","AS (+1)","Austria (+43)","AW (+297)","AX (+358)","AZ (+994)","BA (+387)","BB (+1)","Bangladesh (+880)","Belgium (+32)","BF (+226)","BG (+359)","BH (+973)","BI (+257)","BJ (+229)","BL (+590)","BM (+1)","BN (+673)","BO (+591)","BQ (+599)","BS (+1)","BT (+975)","BW (+267)","BY (+375)","BZ (+501)","CC (+61)","CD (+243)","CF (+236)","CG (+242)","Switzerland (+41)","CI (+225)","CK (+682)","Chile (+56)","CM (+237)","China (+86)","Colombia (+57)","CR (+506)","CU (+53)","CV (+238)","CW (+599)","CX (+61)","CY (+357)","Czech Republic (+420)","DJ (+253)","Denmark (+45)","DM (+1)","DO (+1)","DZ (+213)","Ecuador (+593)","EE (+372)","Egypt (+20)","EH (+212)","ER (+291)","ET (+251)","Finland (+358)","FJ (+679)","FK (+500)","FM (+691)","FO (+298)","GA (+241)","GD (+1)","GE (+995)","GF (+594)","GG (+44)","GH (+233)","GI (+350)","GL (+299)","GM (+220)","GN (+224)","GP (+590)","GQ (+240)","Greece (+30)","GT (+502)","GU (+1)","GW (+245)","GY (+592)","Hong Kong (+852)","HN (+504)","HR (+385)","HT (+509)","Hungary (+36)","Indonesia (+62)","Ireland (+353)","Israel (+972)","IM (+44)","IO (+246)","IQ (+964)","IR (+98)","IS (+354)","JE (+44)","JM (+1)","JO (+962)","Kenya (+254)","KG (+996)","KH (+855)","KI (+686)","KM (+269)","KN (+1)","KP (+850)","South Korea (+82)","KW (+965)","KY (+1)","KZ (+7)","LA (+856)","LB (+961)","LC (+1)","LI (+423)","LK (+94)","LR (+231)","LS (+266)","LT (+370)","LU (+352)","LV (+371)","LY (+218)","Morocco (+212)","MC (+377)","MD (+373)","ME (+382)","MF (+590)","MG (+261)","MH (+692)","MK (+389)","ML (+223)","MM (+95)","MN (+976)","MO (+853)","MP (+1)","MQ (+596)","MR (+222)","MS (+1)","MT (+356)","MU (+230)","MV (+960)","MW (+265)","Malaysia (+60)","MZ (+258)","NA (+264)","NC (+687)","NE (+227)","NF (+672)","Nigeria (+234)","NI (+505)","Norway (+47)","NP (+977)","NR (+674)","NU (+683)","New Zealand (+64)","OM (+968)","PA (+507)","Peru (+51)","PF (+689)","PG (+675)","Philippines (+63)","Pakistan (+92)","Poland (+48)","PM (+508)","PR (+1)","PS (+970)","Portugal (+351)","PW (+680)","PY (+595)","QA (+974)","RE (+262)","Romania (+40)","RS (+381)","Russia (+7)","RW (+250)","Saudi Arabia (+966)","SB (+677)","SC (+248)","SD (+249)","Sweden (+46)","Singapore (+65)","SH (+290)","SI (+386)","SJ (+47)","SK (+421)","SL (+232)","SM (+378)","SN (+221)","SO (+252)","SR (+597)","SS (+211)","ST (+239)","SV (+503)","SX (+1)","SY (+963)","SZ (+268)","TA (+290)","TC (+1)","TD (+235)","TG (+228)","Thailand (+66)","TJ (+992)","TK (+690)","TL (+670)","TM (+993)","TN (+216)","TO (+676)","Turkey (+90)","TT (+1)","TV (+688)","Taiwan (+886)","TZ (+255)","Ukraine (+380)","UG (+256)","UY (+598)","UZ (+998)","VA (+39)","VC (+1)","Venezuela (+58)","VG (+1)","VI (+1)","Vietnam (+84)","VU (+678)","WF (+681)","WS (+685)","XK (+383)","YE (+967)","YT (+262)","South Africa (+27)","ZM (+260)","ZW (+263)"] }, "outputFormat": { "title": "Output Format", "type": "string", "description": "How to format the cleaned phone number", "editor": "select", "enum": ["e164", "international", "national"], "enumTitles": [ "E.164 (+14155551234)", "International (+1 415 555 1234)", "National ((415) 555-1234)" ], "default": "e164", "prefill": "e164" }, "item": { "title": "Item (single)", "type": "string", "description": "Single phone number to clean — shorthand for API/integration callers. If both 'item' and 'items' are provided, 'item' is prepended to the list.", "editor": "textfield", "sectionCaption": "API shorthand", "sectionDescription": "For API and integration callers (Clay, Make, n8n) who want to pass a single item without wrapping it in an array." } }, "required": [] }

{ "actorSpecification": 1, "name": "superclean-phone-numbers", "title": "Superclean Phone Numbers", "description": "Clean and validate phone numbers. E.164 format, type detection, country code. Rule-based. Input: phone strings. Output: {output, e164, isValid, type, countryCode}. Batch or instant API.", "version": "0.2", "dockerfile": "../Dockerfile", "usesStandbyMode": true, "buildTag": "latest", "webServerSchema": "./web_server_openapi.json", "input": "./input_schema.json", "output": "./output_schema.json", "storages": { "dataset": { "actorSpecification": 1, "title": "Cleaned phone numbers", "views": { "results": { "title": "Results", "transformation": { "fields": ["id", "input", "output", "e164", "isValid", "type", "countryCode", "extension"] }, "display": { "component": "table", "properties": { "id": { "label": "ID", "format": "number" }, "input": { "label": "Input", "format": "text" }, "output": { "label": "Output", "format": "text" }, "e164": { "label": "E.164", "format": "text" }, "isValid": { "label": "Valid", "format": "boolean" }, "type": { "label": "Type", "format": "text" }, "countryCode": { "label": "Country", "format": "text" }, "extension": { "label": "Extension", "format": "text" } } } } } } }, "defaultRunOptions": { "build": "latest", "memoryMbytes": 128, "timeoutSecs": 360 }, "minMemoryMbytes": 128, "maxMemoryMbytes": 512 }

1import { 2 parsePhoneNumberWithError, 3 ParseError, 4 parsePhoneNumber 5} from 'libphonenumber-js'; 6 7/** 8 * Phone keypad letter-to-digit mapping for vanity numbers. 9 */ 10const LETTER_TO_DIGIT = { 11 'a': '2', 'b': '2', 'c': '2', 12 'd': '3', 'e': '3', 'f': '3', 13 'g': '4', 'h': '4', 'i': '4', 14 'j': '5', 'k': '5', 'l': '5', 15 'm': '6', 'n': '6', 'o': '6', 16 'p': '7', 'q': '7', 'r': '7', 's': '7', 17 't': '8', 'u': '8', 'v': '8', 18 'w': '9', 'x': '9', 'y': '9', 'z': '9' 19}; 20 21/** 22 * Convert vanity phone numbers (letters) to digits. 23 * Only converts if it looks like a phone number (has digits and common patterns). 24 * Preserves extension markers (x, ext, extension). 25 * e.g., "1-800-FLOWERS" -> "1-800-3569377" 26 * @param {string} phoneString - Phone number possibly containing letters 27 * @returns {string} - Phone number with letters converted to digits 28 */ 29function convertVanityNumber(phoneString) { 30 // Must have at least some digits to be a phone number 31 const digitCount = (phoneString.match(/\d/g) || []).length; 32 if (digitCount < 3) { 33 // Not enough digits to be a phone number - don't convert 34 return phoneString; 35 } 36 37 // Split on extension markers to preserve them 38 // Match: x, ext, ext., extension followed by digits 39 const extMatch = phoneString.match(/^(.+?)\s*(x|ext\.?|extension)\s*(\d+)$/i); 40 41 if (extMatch) { 42 // Convert only the number part, preserve extension 43 const numberPart = extMatch[1]; 44 const extMarker = extMatch[2]; 45 const extDigits = extMatch[3]; 46 47 const convertedNumber = numberPart.split('').map(char => { 48 const lower = char.toLowerCase(); 49 return LETTER_TO_DIGIT[lower] || char; 50 }).join(''); 51 52 return `${convertedNumber} ${extMarker} ${extDigits}`; 53 } 54 55 // No extension, convert the whole string 56 return phoneString.split('').map(char => { 57 const lower = char.toLowerCase(); 58 return LETTER_TO_DIGIT[lower] || char; 59 }).join(''); 60} 61 62/** 63 * Clean a single phone number. 64 * @param {string} phoneString - The phone number to clean 65 * @param {Object} options - Cleaning options 66 * @param {string} options.defaultCountry - ISO 3166-1 alpha-2 country code 67 * @param {string} options.outputFormat - Output format: e164, international, national 68 * @returns {Object} - Cleaned phone number result 69 */ 70export function cleanPhoneNumber(phoneString, options = {}) { 71 const { 72 defaultCountry = 'US', 73 outputFormat = 'e164' 74 } = options; 75 76 const result = { 77 input: phoneString, 78 output: null, 79 e164: null, 80 isValid: false, 81 type: null, 82 countryCode: null, 83 extension: null 84 }; 85 86 // Handle empty or whitespace-only input 87 const trimmed = (phoneString || '').trim(); 88 if (!trimmed) { 89 return result; 90 } 91 92 // Convert vanity letters to digits (e.g., 1-800-FLOWERS -> 1-800-3569377) 93 const normalized = convertVanityNumber(trimmed); 94 95 try { 96 // Parse the phone number 97 const phone = parsePhoneNumberWithError(normalized, defaultCountry); 98 99 // Format output based on requested format 100 let output; 101 switch (outputFormat) { 102 case 'e164': 103 output = phone.format('E.164'); 104 break; 105 case 'international': 106 output = phone.format('INTERNATIONAL'); 107 break; 108 case 'national': 109 output = phone.format('NATIONAL'); 110 break; 111 default: 112 output = phone.format('E.164'); 113 } 114 115 // Get phone type and normalize it 116 const rawType = phone.getType(); 117 const type = rawType ? rawType.toLowerCase().replace(/_/g, '_') : 'unknown'; 118 119 result.output = output; 120 result.e164 = phone.format('E.164'); 121 result.isValid = phone.isValid(); 122 result.type = type; 123 result.countryCode = phone.country || null; 124 result.extension = phone.ext || null; 125 126 } catch (error) { 127 // Try a more lenient parse for partial matches 128 try { 129 const phone = parsePhoneNumber(normalized, defaultCountry); 130 if (phone) { 131 // Even if not fully valid, we might get some info 132 result.e164 = phone.format('E.164'); 133 result.output = outputFormat === 'e164' ? result.e164 : 134 outputFormat === 'international' ? phone.format('INTERNATIONAL') : 135 phone.format('NATIONAL'); 136 result.isValid = phone.isValid(); 137 result.type = phone.getType()?.toLowerCase().replace(/_/g, '_') || 'unknown'; 138 result.countryCode = phone.country || null; 139 result.extension = phone.ext || null; 140 } 141 } catch (innerError) { 142 // Completely unparseable - leave as invalid 143 } 144 } 145 146 return result; 147} 148 149/** 150 * Process an array of phone numbers. 151 * @param {string[]} phoneNumbers - Array of phone numbers to clean 152 * @param {Object} options - Cleaning options 153 * @returns {Object[]} - Array of results 154 */ 155export function cleanPhoneNumbers(phoneNumbers, options = {}) { 156 return phoneNumbers.map((phone, index) => { 157 const cleaned = cleanPhoneNumber(phone, options); 158 return { 159 id: index + 1, 160 input: cleaned.input, 161 output: cleaned.output, 162 e164: cleaned.e164, 163 isValid: cleaned.isValid, 164 type: cleaned.type, 165 countryCode: cleaned.countryCode, 166 extension: cleaned.extension 167 }; 168 }); 169}

1import http from 'node:http'; 2import { Actor } from 'apify'; 3import { cleanPhoneNumber, cleanPhoneNumbers } from './cleaner.js'; 4 5/** 6 * Normalize flexible input formats for Clay/API compatibility. 7 * Accepts: ["string"] or [{input: "string"}] 8 * Returns: ["string"] 9 */ 10function normalizeItems(items) { 11 return items.map((item) => { 12 if (typeof item === 'string') { 13 return item; 14 } 15 if (item && typeof item === 'object' && 'input' in item) { 16 return String(item.input ?? ''); 17 } 18 return String(item ?? ''); 19 }); 20} 21 22await Actor.init(); 23 24if (Actor.config.get('metaOrigin') === 'STANDBY') { 25 startStandbyServer(); 26} else { 27 await runBatchMode(); 28 await Actor.exit(); 29} 30 31// --------------------------------------------------------------------------- 32// Standby mode — HTTP server for instant single-number cleaning 33// --------------------------------------------------------------------------- 34 35function startStandbyServer() { 36 const port = Actor.config.get('containerPort'); 37 38 const server = http.createServer(async (req, res) => { 39 // Readiness probe 40 if (req.headers['x-apify-container-server-readiness-probe']) { 41 res.writeHead(200, { 'Content-Type': 'application/json' }); 42 res.end(JSON.stringify({ status: 'ready' })); 43 return; 44 } 45 46 // GET only 47 if (req.method !== 'GET') { 48 res.writeHead(405, { 'Content-Type': 'application/json' }); 49 res.end(JSON.stringify({ error: 'Method not allowed. Use GET.' })); 50 return; 51 } 52 53 // No input param → serve landing page 54 const reqUrl = new URL(req.url, `http://${req.headers.host}`); 55 if (!reqUrl.searchParams.get('input')) { 56 res.writeHead(200, { 'Content-Type': 'text/html' }); 57 res.end(getLandingPageHtml()); 58 return; 59 } 60 61 try { 62 const result = handleStandbyRequest(reqUrl); 63 await Actor.pushData(result); 64 65 res.writeHead(200, { 'Content-Type': 'application/json' }); 66 res.end(JSON.stringify(result)); 67 } catch (err) { 68 const statusCode = err.statusCode || 500; 69 res.writeHead(statusCode, { 'Content-Type': 'application/json' }); 70 res.end(JSON.stringify({ error: err.message })); 71 } 72 }); 73 74 server.listen(port, () => { 75 console.log(`Superclean Phone Numbers Standby server listening on port ${port}`); 76 }); 77} 78 79function handleStandbyRequest(reqUrl) { 80 const input = reqUrl.searchParams.get('input'); 81 82 if (!input) { 83 const err = new Error("Provide an 'input' query parameter with the phone number to clean."); 84 err.statusCode = 400; 85 throw err; 86 } 87 88 const defaultCountry = (reqUrl.searchParams.get('defaultCountry') || 'US').toUpperCase(); 89 const outputFormat = reqUrl.searchParams.get('outputFormat') || 'e164'; 90 91 // Validate defaultCountry 92 if (defaultCountry.length !== 2) { 93 const err = new Error('defaultCountry must be a 2-letter ISO country code (e.g., US, GB, DE)'); 94 err.statusCode = 400; 95 throw err; 96 } 97 98 // Validate outputFormat 99 const validFormats = ['e164', 'international', 'national']; 100 if (!validFormats.includes(outputFormat)) { 101 const err = new Error(`Invalid outputFormat "${outputFormat}". Must be one of: ${validFormats.join(', ')}`); 102 err.statusCode = 400; 103 throw err; 104 } 105 106 const cleaned = cleanPhoneNumber(input, { defaultCountry, outputFormat }); 107 108 return { 109 id: 1, 110 input: cleaned.input, 111 output: cleaned.output, 112 e164: cleaned.e164, 113 isValid: cleaned.isValid, 114 type: cleaned.type, 115 countryCode: cleaned.countryCode, 116 extension: cleaned.extension, 117 }; 118} 119 120// --------------------------------------------------------------------------- 121// Batch mode — existing pipeline for standard Actor runs 122// --------------------------------------------------------------------------- 123 124async function runBatchMode() { 125 const input = await Actor.getInput(); 126 127 let { 128 items: rawItems = [], 129 item, 130 defaultCountry = 'US', 131 outputFormat = 'e164' 132 } = input || {}; 133 134 // Support single "item" string field for API/integration callers 135 if (typeof item === 'string' && item.trim()) { 136 if (!Array.isArray(rawItems)) rawItems = []; 137 rawItems = [item.trim(), ...rawItems]; 138 } 139 140 // Coerce bare string to array 141 if (typeof rawItems === 'string') rawItems = [rawItems]; 142 143 // Validate input 144 if (!Array.isArray(rawItems) || rawItems.length === 0) { 145 await Actor.pushData({ error: 'missing_items', message: 'Input required: provide "items" (array) or "item" (single string). Example: {"items": ["+1 (555) 123-4567"]}' }); 146 await Actor.exit('Skipped: Input required: provide "items" (array) or "item" (single string). Example: {"items": ["+1 (555) 123-4567"]}'); 147 return; 148 } 149 150 // Normalize input format (supports both ["string"] and [{input: "string"}]) 151 const items = normalizeItems(rawItems); 152 153 // Validate defaultCountry (should be 2-letter ISO code) 154 if (typeof defaultCountry !== 'string' || defaultCountry.length !== 2) { 155 await Actor.pushData({ error: 'invalid_country', message: 'defaultCountry must be a 2-letter ISO country code (e.g., US, GB, DE)' }); 156 await Actor.exit('Skipped: defaultCountry must be a 2-letter ISO country code (e.g., US, GB, DE)'); 157 return; 158 } 159 160 // Validate outputFormat 161 const validFormats = ['e164', 'international', 'national']; 162 if (!validFormats.includes(outputFormat)) { 163 const message = `Invalid outputFormat "${outputFormat}". Must be one of: ${validFormats.join(', ')}`; 164 await Actor.pushData({ error: 'invalid_format', message }); 165 await Actor.exit(`Skipped: ${message}`); 166 return; 167 } 168 169 console.log(`Processing ${items.length} phone number(s)`); 170 console.log(`Options: defaultCountry=${defaultCountry}, outputFormat=${outputFormat}`); 171 172 // Clean the phone numbers 173 const results = cleanPhoneNumbers(items, { 174 defaultCountry: defaultCountry.toUpperCase(), 175 outputFormat 176 }); 177 178 // Push results to dataset 179 180 await Actor.pushData(results); 181 182 // Log summary 183 const validCount = results.filter(r => r.isValid).length; 184 const typeBreakdown = results.reduce((acc, r) => { 185 if (r.type) { 186 acc[r.type] = (acc[r.type] || 0) + 1; 187 } 188 return acc; 189 }, {}); 190 191 console.log(`Processed ${results.length} phone numbers`); 192 console.log(`Valid: ${validCount}, Invalid: ${results.length - validCount}`); 193 if (Object.keys(typeBreakdown).length > 0) { 194 console.log(`Types: ${JSON.stringify(typeBreakdown)}`); 195 } 196} 197 198// --------------------------------------------------------------------------- 199// Landing page HTML for Standby mode 200// --------------------------------------------------------------------------- 201 202function getLandingPageHtml() { 203 return `<!DOCTYPE html> 204<html lang="en"> 205<head> 206<meta charset="utf-8"> 207<meta name="viewport" content="width=device-width, initial-scale=1"> 208<title>Superclean Phone Numbers — Superlative</title> 209<link rel="preconnect" href="https://fonts.googleapis.com"> 210<link rel="preconnect" href="https://fonts.gstatic.com" crossorigin> 211<link href="https://fonts.googleapis.com/css2?family=DM+Sans:wght@400;500;700&family=Space+Mono:wght@400;700&display=swap" rel="stylesheet"> 212<style> 213:root{--color-bg:#0a0e14;--color-surface:#12171f;--color-border:#1e2632;--color-text:#e8eaed;--color-text-muted:#8b95a5;--color-accent:#4ade80;--color-accent-dim:rgba(74,222,128,0.15);--font-display:'Space Mono',monospace;--font-body:'DM Sans',sans-serif} 214*{margin:0;padding:0;box-sizing:border-box} 215body{font-family:var(--font-body);background:var(--color-bg);color:var(--color-text);line-height:1.6;min-height:100vh;overflow-x:hidden} 216a{color:var(--color-accent);text-decoration:none;transition:color .2s ease} 217a:hover{color:#6ee7a0} 218.grid-bg{position:fixed;top:0;left:0;width:100%;height:100%;background-image:linear-gradient(var(--color-border) 1px,transparent 1px),linear-gradient(90deg,var(--color-border) 1px,transparent 1px);background-size:60px 60px;opacity:.3;pointer-events:none;z-index:0} 219.accent-line{position:fixed;top:0;left:0;width:100%;height:2px;background:linear-gradient(90deg,transparent 0%,var(--color-accent) 50%,transparent 100%);animation:shimmer 3s ease-in-out infinite;z-index:10} 220@keyframes shimmer{0%,100%{transform:translateX(-100%)}50%{transform:translateX(100%)}} 221@keyframes fadeUp{from{opacity:0;transform:translateY(20px)}to{opacity:1;transform:translateY(0)}} 222.container{position:relative;z-index:1;max-width:900px;margin:0 auto;padding:0 24px} 223header{padding:32px 0} 224.logo{font-family:var(--font-display);font-size:14px;font-weight:700;letter-spacing:.1em;text-transform:uppercase;color:var(--color-text);display:flex;align-items:center;gap:10px;text-decoration:none} 225.logo:hover{color:var(--color-text)} 226.logo-mark{width:28px;height:28px;background:var(--color-accent);display:flex;align-items:center;justify-content:center} 227.logo-mark svg{width:16px;height:16px} 228.hero{padding:80px 0 60px;animation:fadeUp .8s ease-out} 229.hero-label{font-family:var(--font-display);font-size:12px;font-weight:400;letter-spacing:.15em;text-transform:uppercase;color:var(--color-accent);margin-bottom:24px;display:flex;align-items:center;gap:12px} 230.hero-label::before{content:'';width:24px;height:1px;background:var(--color-accent)} 231h1{font-family:var(--font-display);font-size:clamp(28px,5vw,44px);font-weight:700;line-height:1.15;margin-bottom:20px;letter-spacing:-.02em} 232h1 .highlight{color:var(--color-accent)} 233.hero-desc{font-size:18px;color:var(--color-text-muted);max-width:540px;margin-bottom:28px;line-height:1.7} 234.hero-link{font-family:var(--font-display);font-size:13px;letter-spacing:.05em;color:var(--color-accent);display:inline-flex;align-items:center;gap:6px} 235.section{padding:60px 0;border-top:1px solid var(--color-border);animation:fadeUp .8s ease-out .2s backwards} 236.section-label{font-family:var(--font-display);font-size:11px;font-weight:400;letter-spacing:.2em;text-transform:uppercase;color:var(--color-text-muted);margin-bottom:24px} 237h2{font-family:var(--font-display);font-size:20px;font-weight:700;margin-bottom:16px;letter-spacing:-.01em} 238p,li{font-size:15px;color:var(--color-text-muted);line-height:1.7} 239li{margin-bottom:6px} 240ul{margin:.5rem 0 1rem 1.25rem} 241strong{color:var(--color-text);font-weight:600} 242pre{background:var(--color-surface);color:var(--color-text);padding:16px 20px;overflow-x:auto;margin:12px 0 16px;font-family:var(--font-display);font-size:13px;line-height:1.6;border:1px solid var(--color-border)} 243code{font-family:var(--font-display);font-size:13px} 244p code,li code,td code{background:var(--color-accent-dim);color:var(--color-accent);padding:2px 6px} 245table{width:100%;border-collapse:collapse;margin:12px 0 16px;font-size:14px} 246th,td{border:1px solid var(--color-border);padding:10px 14px;text-align:left} 247th{background:var(--color-surface);color:var(--color-text-muted);font-family:var(--font-display);font-size:12px;font-weight:400;letter-spacing:.05em;text-transform:uppercase} 248td{color:var(--color-text-muted)} 249.badge{display:inline-block;background:var(--color-accent-dim);color:var(--color-accent);padding:3px 8px;font-family:var(--font-display);font-size:11px;font-weight:400;letter-spacing:.05em} 250.note{font-size:13px;color:var(--color-text-muted);margin-top:8px} 251.product-grid{display:grid;grid-template-columns:repeat(auto-fit,minmax(240px,1fr));gap:16px;margin-top:24px} 252.product-card{background:var(--color-surface);border:1px solid var(--color-border);padding:24px;transition:all .3s ease;text-decoration:none;color:inherit;display:block} 253.product-card:hover{border-color:var(--color-accent);transform:translateY(-2px)} 254.product-name{font-family:var(--font-display);font-size:14px;font-weight:700;margin-bottom:8px;color:var(--color-text);display:flex;align-items:center;gap:8px} 255.product-name .status{font-size:9px;font-weight:400;padding:3px 6px;background:var(--color-accent-dim);color:var(--color-accent);letter-spacing:.1em} 256.product-desc{font-size:14px;color:var(--color-text-muted);line-height:1.5} 257footer{padding:48px 0;border-top:1px solid var(--color-border)} 258.footer-content{display:flex;justify-content:space-between;align-items:center;flex-wrap:wrap;gap:24px} 259.footer-text{font-size:13px;color:var(--color-text-muted)} 260.footer-links{display:flex;gap:24px} 261.footer-links a{font-family:var(--font-display);font-size:12px;color:var(--color-text-muted);letter-spacing:.05em} 262.footer-links a:hover{color:var(--color-accent)} 263@media(max-width:600px){.hero{padding:60px 0 40px}.section{padding:40px 0}.footer-content{flex-direction:column;align-items:flex-start}pre{font-size:12px;padding:12px 14px}} 264</style> 265</head> 266<body> 267<div class="grid-bg"></div> 268<div class="accent-line"></div> 269 270<div class="container"> 271 <header> 272 <a href="https://apify.com/superlativetech?fpr=8e9l1" class="logo"> 273 <div class="logo-mark"> 274 <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2.5"> 275 <polyline points="4 17 10 11 4 5"></polyline> 276 <line x1="12" y1="19" x2="20" y2="19"></line> 277 </svg> 278 </div> 279 Superlative 280 </a> 281 </header> 282 283 <section class="hero"> 284 <div class="hero-label">Superclean</div> 285 <h1>Superclean Phone <span class="highlight">Numbers</span></h1> 286 <p class="hero-desc">Instant phone number cleaning and validation. Format to E.164, detect type, handle vanity numbers. Sub-second responses via Standby API.</p> 287 <a href="https://apify.com/superlativetech/superclean-phone-numbers?fpr=8e9l1" class="hero-link">View on Apify Store →</a> 288 </section> 289 290 <section class="section"> 291 <div class="section-label">Features</div> 292 <h2>What this does</h2> 293 <ul> 294 <li><strong>Formats numbers</strong> — E.164, international, or national output formats</li> 295 <li><strong>Validates numbers</strong> — Check if phone numbers are valid with type detection</li> 296 <li><strong>Handles vanity</strong> — Convert 1-800-FLOWERS to digits automatically</li> 297 <li><strong>Detects type</strong> — Mobile, landline, toll-free, VOIP classification</li> 298 <li><strong>Batch mode</strong> — Process hundreds of numbers via the standard Actor run</li> 299 </ul> 300 </section> 301 302 <section class="section"> 303 <div class="section-label">Getting Started</div> 304 <h2>Quick start</h2> 305 <p>Replace <code>YOUR_TOKEN</code> with your Apify API token.</p> 306 307 <p style="margin-top:16px"><strong>Clean a phone number (E.164):</strong></p> 308 <pre>curl "https://superlativetech--superclean-phone-numbers.apify.actor?token=YOUR_TOKEN&input=(555)+123-4567"</pre> 309 310 <p><strong>International format:</strong></p> 311 <pre>curl "https://superlativetech--superclean-phone-numbers.apify.actor?token=YOUR_TOKEN&input=(555)+123-4567&outputFormat=international"</pre> 312 313 <p><strong>Non-US number:</strong></p> 314 <pre>curl "https://superlativetech--superclean-phone-numbers.apify.actor?token=YOUR_TOKEN&input=020+7946+0958&defaultCountry=GB"</pre> 315 </section> 316 317 <section class="section"> 318 <div class="section-label">Reference</div> 319 <h2>Query parameters</h2> 320 <table> 321 <tr><th>Parameter</th><th>Required</th><th>Description</th></tr> 322 <tr><td><code>input</code></td><td>Yes</td><td>Phone number to clean</td></tr> 323 <tr><td><code>defaultCountry</code></td><td>No</td><td>2-letter ISO country code (default: <code>US</code>)</td></tr> 324 <tr><td><code>outputFormat</code></td><td>No</td><td>Format: <code>e164</code> (default), <code>international</code>, or <code>national</code></td></tr> 325 <tr><td><code>token</code></td><td>Yes</td><td>Your Apify API token</td></tr> 326 </table> 327 </section> 328 329 <section class="section"> 330 <div class="section-label">Response</div> 331 <h2>Response format</h2> 332 <pre>{ 333 "id": 1, 334 "input": "(555) 123-4567", 335 "output": "+15551234567", 336 "e164": "+15551234567", 337 "isValid": true, 338 "type": "fixed_line_or_mobile", 339 "countryCode": "US", 340 "extension": null 341}</pre> 342 </section> 343 344 <section class="section"> 345 <div class="section-label">Cost</div> 346 <h2>Pricing</h2> 347 <p>Free to use — you only pay standard Apify platform usage.</p> 348 </section> 349 350 <section class="section"> 351 <div class="section-label">Auth</div> 352 <h2>Authentication</h2> 353 <p>Authenticate using either method:</p> 354 <ul> 355 <li>Query parameter: <code>?token=YOUR_APIFY_TOKEN</code></li> 356 <li>Header: <code>Authorization: Bearer YOUR_APIFY_TOKEN</code></li> 357 </ul> 358 <p style="margin-top:8px">Get your token from <a href="https://console.apify.com/settings/integrations">Apify Console → Settings → Integrations</a>.</p> 359 </section> 360 361 <section class="section"> 362 <div class="section-label">Superlative</div> 363 <h2>More from Superlative</h2> 364 <div class="product-grid"> 365 <a href="https://apify.com/superlativetech/superclean-company-names?fpr=8e9l1" class="product-card"> 366 <div class="product-name">Company Names <span class="status">Live</span></div> 367 <p class="product-desc">Normalize company names for CRM and cold email outreach.</p> 368 </a> 369 <a href="https://apify.com/superlativetech/superclean-job-titles?fpr=8e9l1" class="product-card"> 370 <div class="product-name">Job Titles <span class="status">Live</span></div> 371 <p class="product-desc">Standardize job titles for outreach sequences.</p> 372 </a> 373 <a href="https://apify.com/superlativetech/superclean-person-names?fpr=8e9l1" class="product-card"> 374 <div class="product-name">Person Names <span class="status">Live</span></div> 375 <p class="product-desc">Clean and format person names for personalization.</p> 376 </a> 377 <a href="https://apify.com/superlativetech/superclean-product-names?fpr=8e9l1" class="product-card"> 378 <div class="product-name">Product Names <span class="status">Live</span></div> 379 <p class="product-desc">Normalize product and brand names from exports.</p> 380 </a> 381 <a href="https://apify.com/superlativetech/superclean-places?fpr=8e9l1" class="product-card"> 382 <div class="product-name">Places <span class="status">Live</span></div> 383 <p class="product-desc">Parse and standardize location strings.</p> 384 </a> 385 <a href="https://apify.com/superlativetech/superclean-urls?fpr=8e9l1" class="product-card"> 386 <div class="product-name">URLs <span class="status">Live</span></div> 387 <p class="product-desc">Clean and normalize URLs from lead data.</p> 388 </a> 389 <a href="https://apify.com/superlativetech/dns-lookup?fpr=8e9l1" class="product-card"> 390 <div class="product-name">Supernet DNS Lookup <span class="status">Live</span></div> 391 <p class="product-desc">Look up DNS records for any domain.</p> 392 </a> 393 <a href="https://apify.com/superlativetech/http-api?fpr=8e9l1" class="product-card"> 394 <div class="product-name">HTTP API <span class="status">Live</span></div> 395 <p class="product-desc">General-purpose HTTP request utility.</p> 396 </a> 397 </div> 398 </section> 399 400 <footer> 401 <div class="footer-content"> 402 <p class="footer-text">© 2026 Superlative</p> 403 <div class="footer-links"> 404 <a href="https://apify.com/superlativetech?fpr=8e9l1">Apify Store</a> 405 </div> 406 </div> 407 </footer> 408</div> 409 410</body> 411</html>`; 412}

Superclean Phone Numbers

Phone Number Validator — Format, Country & Line Type