Pricing

Rating

Developer

Actor stats

Categories

Share

📞 Phone Number Normalizer (Apify Actor)

Normalize, validate, and format phone numbers in bulk. Paste a list of numbers, choose your default region and output formats, and the actor returns a clean dataset item per token—ready for CRM imports, outreach tools, or data cleanup.

✨ What this actor does

• Extracts phone numbers from each line (also splits by comma, semicolon, pipe, or tab).
• Validates numbers using libphonenumber-js.
• Formats numbers into the output styles you choose (e.g., E164, INTERNATIONAL).
• Keeps a stable output schema for downstream automation.

🧾 Input (Apify UI / API)

The actor accepts exactly these fields:

Example input

{
"numbersText":"+1 (212) 555-0100 x12\n0049 (0)30 1234567 ext 99\n030/1234567",
"defaultRegion":"US",
"outputFormats":["E164","INTERNATIONAL","RFC3966"]
}

📦 Output (Dataset items)

Each token produces one dataset item, even if it is empty after cleaning.

{
"input":"0049 (0)30 1234567 ext 99",
"country":"DE",
"formats":{
"E164":"+49301234567",
"INTERNATIONAL":"+49 30 1234567"
}
}

🧠 Parsing notes

• Default region behavior: If a token has no country calling code, it is parsed using defaultRegion.
• Extension handling: The actor extracts extensions from ext 12, x12, #12, extension 12, and Durchwahl 12.

🔌 API usage

curl-X POST "https://api.apify.com/v2/acts/YOUR_USERNAME~YOUR_ACTOR/run-sync-get-dataset-items?token=YOUR_TOKEN"\
-H"Content-Type: application/json"\
-d'{
 "numbersText": "+1 (212) 555-0100 x12\n0049 (0)30 1234567 ext 99",
 "defaultRegion": "US",
 "outputFormats": ["E164", "INTERNATIONAL"]
 }'

✅ Typical user workflow

• Paste a list of phone numbers from spreadsheets or CRM exports.
• Run the actor in Apify.
• Download clean, normalized formats for imports or verification.

🛠️ Troubleshooting tips

• Make sure numbersText is not empty; every line is processed.
• If numbers without country codes are mis-parsed, set the correct defaultRegion.
• Include RFC3966 if you need tel: URI output.