{ "openapi": "3.0.1", "info": { "title": "Phone Number Validator & Formatter — E.164, Type, Carrier", "description": "Validate and format phone numbers in bulk with Google's libphonenumber: valid or not, E.164, international and national format, country, mobile or landline, carrier, time zone and WhatsApp link. Works on pasted lists, CSV files or straight on your scraper's dataset.", "version": "1.0", "x-build-id": "x2UeDUiY3cLtiPCNa" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/tidydata~phone-number-validator/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-tidydata-phone-number-validator", "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/tidydata~phone-number-validator/runs": { "post": { "operationId": "runs-sync-tidydata-phone-number-validator", "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/tidydata~phone-number-validator/run-sync": { "post": { "operationId": "run-sync-tidydata-phone-number-validator", "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", "properties": { "phones": { "title": "Phone numbers", "type": "array", "description": "One per line, in any format: +1 202-456-1111, (415) 555-2671, 0049 30 901820, or text that contains numbers.", "items": { "type": "string" } }, "datasetIds": { "title": "Or validate the phones in datasets", "type": "array", "description": "Pick datasets from your storages (e.g. a Google Maps or lead scraper run). Every row is kept and enriched with phone_e164, phone_valid, phone_type… When this Actor runs as an integration, use {{resource.defaultDatasetId}}." }, "fileUrls": { "title": "Or files (CSV / JSON / TXT)", "type": "array", "description": "Public links to .csv, .json or plain .txt files (one number per line).", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "phoneFields": { "title": "Phone fields (optional)", "type": "array", "description": "For datasets and files: the column(s) with phone numbers, e.g. phone or contact.phone. Leave empty to detect them automatically.", "items": { "type": "string" } }, "defaultCountry": { "title": "Default country (for numbers without +code)", "type": "string", "description": "2-letter code used for numbers written without international prefix, e.g. US, GB, ES, DE, FR, MX, BR, IN. Numbers with + or 00 are detected automatically.", "default": "" }, "useRowCountry": { "title": "Use each row's country", "type": "boolean", "description": "For datasets and files: if a row has a country code (countryCode, country, address.countryCode…, as Google Maps results do), numbers without +code are read in that country.", "default": true }, "extractFromText": { "title": "Find numbers inside text", "type": "boolean", "description": "Finds every phone number inside longer text (e.g. 'Call us: +1 202 456 1111 or 202 456 1414').", "default": true }, "removeDuplicates": { "title": "Remove duplicates", "type": "boolean", "description": "The same number written in different ways counts once (compared in E.164). Duplicates are free.", "default": true }, "onlyValid": { "title": "Only valid numbers", "type": "boolean", "description": "Keep only valid numbers (for datasets: only rows with at least one valid phone).", "default": false }, "language": { "title": "Language for country, carrier and place names", "type": "string", "description": "e.g. en, es, de, fr, pt.", "default": "en" }, "maxRows": { "title": "Max rows", "minimum": 1, "type": "integer", "description": "Safety limit of input rows to read.", "default": 1000000 } } }, "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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }