# Phone Number Checker: Validate, Format & Find Country (`scrapemint/phone-number-checker`) Actor Check phone numbers in bulk: valid or not, which country, mobile or landline, and the clean international format. Runs on the same rules Android phones use. Perfect for cleaning CRM lists before calling or SMS campaigns. Works for every country. No API key needed. - **URL**: https://apify.com/scrapemint/phone-number-checker.md - **Developed by:** [Ken M](https://apify.com/scrapemint) (community) - **Categories:** Lead generation, Marketing - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing Pay per usage This Actor is paid per platform usage. The Actor is free to use, and you only pay for the Apify platform usage, which gets cheaper the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-usage ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js/docs.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## Phone Number Checker: Validate, Format & Find Country Check phone numbers in bulk. Paste one number or a hundred thousand and get one clean row per number: **valid or not, which country it belongs to, mobile or landline, and the properly formatted version** ready for dialing or SMS. Built for **sales and marketing teams cleaning CRM lists before calling or SMS campaigns**, e-commerce stores validating checkout numbers, and anyone importing leads. Bad numbers waste dialer time and SMS credits; this removes them first. Works for **every country**, using the same numbering rules Android phones use to recognise numbers. ### What you get for each number - **valid**: true or false by the country's official numbering plan - **country** and **countryName**: where the number belongs (US, KE, IN...) - **type**: mobile, landline, toll free, premium rate, voip and more - **e164 / international / national**: clean formats for dialers, SMS gateways and display ### Example output ```json { "input": "0722123456", "valid": true, "country": "KE", "countryName": "Kenya", "countryCallingCode": "+254", "type": "mobile", "e164": "+254722123456", "international": "+254 722 123456", "national": "0722 123456" } ```` ### Numbers without the + prefix Set the **default country** and local formats work too: `0722123456` with default country KE parses as a Kenyan mobile, `(415) 555-2671` with US as a San Francisco number. Numbers that already start with `+` ignore the default. ### What this does and does not check It validates that a number is **real by structure**: correct length, a real country code, an allocated range, and the line type that range belongs to. That catches typos, fakes and impossible numbers — the bulk of dirty data. It does **not** dial the number or ask the carrier whether the line is active right now; that requires paid carrier lookups. The same honest split as our [Email List Checker](https://apify.com/scrapemint/email-list-checker), which validates deliverability signals without sending mail. ### Pricing **$0.002 per checked number** (valid or invalid — both are answers). Text that is not a phone number at all is **free**, and the first 2 rows of every run are free. Cleaning a 10,000 contact CRM export costs about $20, versus per-lookup pricing on carrier APIs that runs 3 to 10 times higher. ### How to run it via API ```bash curl -X POST "https://api.apify.com/v2/acts/scrapemint~phone-number-checker/run-sync-get-dataset-items?token=YOUR_TOKEN" \ -H "Content-Type: application/json" \ -d '{"phoneNumbers": ["+14155552671", "0722123456"], "defaultCountry": "KE"}' ``` ### Frequently asked questions **How accurate is mobile vs landline?** It comes from the official number range allocations each country publishes. In some countries (like the US) certain ranges serve both, reported as "landline or mobile". **Does it find the carrier or owner name?** No. Carrier and caller-ID data require paid lookups and are out of scope. Country, type, validity and formatting are what list cleaning needs. **My numbers are a mix of countries without + prefixes.** Split them by country and run once per batch with the right default country, or add prefixes first. Numbers with `+` always work in one run. ### More tools from Scrapemint - [Email List Checker](https://apify.com/scrapemint/email-list-checker): clean email lists the same way. - [US Address Checker & GPS Finder](https://apify.com/scrapemint/us-address-checker): verify and geocode US addresses. - [Website Contact Scraper](https://apify.com/scrapemint/website-contact-scraper): pull emails and phones from any company website. # Actor input Schema ## `phoneNumbers` (type: `array`): One number per line. International format with + works for any country. Numbers without + are interpreted using the default country below. ## `defaultCountry` (type: `string`): 2 letter country code (US, GB, KE, IN...) used for numbers written without the + prefix, e.g. 0722123456. Leave empty if all your numbers start with +. ## `maxRows` (type: `integer`): Stop after this many numbers checked. ## Actor input object example ```json { "phoneNumbers": [ "+14155552671", "+442071838750", "+254722123456", "+919876543210", "+4915123456789", "+18002752273" ], "maxRows": 10000 } ``` # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "phoneNumbers": [ "+14155552671", "+442071838750", "+254722123456", "+919876543210", "+4915123456789", "+18002752273" ] }; // Run the Actor and wait for it to finish const run = await client.actor("scrapemint/phone-number-checker").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "phoneNumbers": [ "+14155552671", "+442071838750", "+254722123456", "+919876543210", "+4915123456789", "+18002752273", ] } # Run the Actor and wait for it to finish run = client.actor("scrapemint/phone-number-checker").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "phoneNumbers": [ "+14155552671", "+442071838750", "+254722123456", "+919876543210", "+4915123456789", "+18002752273" ] }' | apify call scrapemint/phone-number-checker --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=scrapemint/phone-number-checker", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Phone Number Checker: Validate, Format & Find Country", "description": "Check phone numbers in bulk: valid or not, which country, mobile or landline, and the clean international format. Runs on the same rules Android phones use. Perfect for cleaning CRM lists before calling or SMS campaigns. Works for every country. No API key needed.", "version": "0.1", "x-build-id": "9IxEi7A0x5AyFRPMk" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapemint~phone-number-checker/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapemint-phone-number-checker", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/scrapemint~phone-number-checker/runs": { "post": { "operationId": "runs-sync-scrapemint-phone-number-checker", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/scrapemint~phone-number-checker/run-sync": { "post": { "operationId": "run-sync-scrapemint-phone-number-checker", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "phoneNumbers" ], "properties": { "phoneNumbers": { "title": "Phone numbers", "type": "array", "description": "One number per line. International format with + works for any country. Numbers without + are interpreted using the default country below.", "items": { "type": "string" } }, "defaultCountry": { "title": "Default country", "type": "string", "description": "2 letter country code (US, GB, KE, IN...) used for numbers written without the + prefix, e.g. 0722123456. Leave empty if all your numbers start with +." }, "maxRows": { "title": "Max rows", "minimum": 1, "maximum": 100000, "type": "integer", "description": "Stop after this many numbers checked.", "default": 10000 } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```