{ "openapi": "3.0.1", "info": { "title": "Phone Number Validator - Bulk E.164, Mobile vs Landline", "description": "Offline phone number validator and E.164 formatter for bulk lists. Valid or not, E.164, national and international format, country and mobile or landline type, from libphonenumber. No API key, no lookups. $0.001 per valid number; invalid and duplicate numbers are free.", "version": "0.1", "x-build-id": "apNTumgheUe079Yl3" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/lukehunter~phone-number-validator/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-lukehunter-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/lukehunter~phone-number-validator/runs": { "post": { "operationId": "runs-sync-lukehunter-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/lukehunter~phone-number-validator/run-sync": { "post": { "operationId": "run-sync-lukehunter-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": { "phoneNumbers": { "title": "Phone numbers", "type": "array", "description": "Phone numbers in any common format, e.g. [\"+44 20 7946 0000\", \"(202) 555-0123\", \"0151 496 0123\"]. Spaces, dots, dashes, brackets and extensions (\"x123\") are fine. Numbers without a + prefix use defaultCountry. Invalid and unparseable numbers are free. Max 100,000 per run.", "items": { "type": "string" } }, "defaultCountry": { "title": "Default country (optional)", "type": "string", "description": "Two-letter ISO country code used for numbers written without a + prefix, e.g. \"GB\", \"US\", \"DE\". Numbers that start with + always use their own country code. Without it, a national number like \"020 7946 0000\" cannot be read and comes back unparseable. \"UK\" is accepted for GB." }, "rows": { "title": "Rows with a phone field (optional)", "type": "array", "description": "Objects that carry phones, e.g. [{\"domain\": \"example.com\", \"phones\": [\"+44 20 7946 0000\"]}]. Read from phoneField, or from phones, phone, phoneNumber, telephone, tel, mobile or phoneUnformatted. A row's countryCode (e.g. \"DE\") overrides defaultCountry for its numbers. Rows without a phone are skipped. Merged with phoneNumbers." }, "datasetId": { "title": "Dataset ID (optional)", "type": "string", "description": "ID of an Apify dataset whose items have a phone field, to chain runs, e.g. the default dataset of a Website Contact Scraper, Lead Enricher or Impressum Scraper run (fields phones or phone). Read at the start of the run, up to 100,000 items. Merged with phoneNumbers and rows." }, "phoneField": { "title": "Phone field name (optional)", "type": "string", "description": "Field that holds the phone number(s) in rows or the dataset, e.g. \"phones\" (a list of texts or of {phone} objects) or \"phone\". Leave empty to try phones, phone, phoneNumber, phoneNumbers, phone_number, telephone, tel, mobile and phoneUnformatted in that order." }, "maxItems": { "title": "Maximum numbers", "minimum": 1, "maximum": 100000, "type": "integer", "description": "Hard cap on numbers checked per run, 1 to 100,000, e.g. 1000. Only valid numbers are charged, at $0.001 each, so 1,000 numbers cost at most $1. Numbers beyond the cap are not checked and the run's status message says how many.", "default": 1000 } } }, "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 } } } } } } } } } }