{ "openapi": "3.0.1", "info": { "title": "Twitter Phone Number Scraper - Multi-Region with Line Types", "description": "📱 Twitter Phone Number Scraper pulls public contact numbers across multiple search engines and regions. ✅ Line-type detection, carrier lookup and validation on every record. 🌍 Built for multi-country outreach & SMS campaigns.", "version": "1.0", "x-build-id": "VkfwdIf8ppISDfbUa" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/code-beat~twitter-phone-number-scraper-advanced/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-code-beat-twitter-phone-number-scraper-advanced", "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/code-beat~twitter-phone-number-scraper-advanced/runs": { "post": { "operationId": "runs-sync-code-beat-twitter-phone-number-scraper-advanced", "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/code-beat~twitter-phone-number-scraper-advanced/run-sync": { "post": { "operationId": "run-sync-code-beat-twitter-phone-number-scraper-advanced", "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": [ "country" ], "properties": { "scrapeMode": { "title": "Scrape Mode", "enum": [ "Find New Numbers", "Validate My List" ], "type": "string", "description": "Find New Numbers (default) searches by keyword. Validate My List skips searching entirely and instead runs the numbers you paste into Phone List (below) through the same deliverability checks.", "default": "Find New Numbers" }, "country": { "title": "Country", "enum": [ "United States (+1)", "United Kingdom (+44)", "Canada (+1)", "Australia (+61)", "Germany (+49)", "France (+33)", "India (+91)", "Japan (+81)", "Brazil (+55)", "Italy (+39)", "Spain (+34)", "Netherlands (+31)", "Sweden (+46)", "Norway (+47)", "Denmark (+45)", "Finland (+358)", "Poland (+48)", "Czech Republic (+420)", "Hungary (+36)", "Romania (+40)", "Bulgaria (+359)", "Croatia (+385)", "Slovenia (+386)", "Slovakia (+421)", "Estonia (+372)", "Latvia (+371)", "Lithuania (+370)", "Portugal (+351)", "Greece (+30)", "Cyprus (+357)", "Malta (+356)", "Luxembourg (+352)", "Ireland (+353)", "Belgium (+32)", "Austria (+43)", "Switzerland (+41)", "Liechtenstein (+423)", "Iceland (+354)", "South Korea (+82)", "China (+86)", "Mexico (+52)", "Argentina (+54)", "Chile (+56)", "Colombia (+57)", "Peru (+51)", "Venezuela (+58)", "Ecuador (+593)", "Uruguay (+598)", "Paraguay (+595)", "Bolivia (+591)", "Saudi Arabia (+966)", "United Arab Emirates (+971)", "Bahrain (+973)", "Israel (+972)", "Jordan (+962)", "Kuwait (+965)", "Lebanon (+961)", "Oman (+968)", "Qatar (+974)", "Bangladesh (+880)", "Pakistan (+92)", "Sri Lanka (+94)", "Thailand (+66)", "Viet Nam (+84)", "Malaysia (+60)", "Singapore (+65)", "Philippines (+63)", "Indonesia (+62)", "New Zealand (+64)", "South Africa (+27)", "Turkey (+90)", "Ukraine (+380)", "Russia (+7)" ], "type": "string", "description": "Select the country to target for Google search results. Only used in Find New Numbers mode.", "default": "United States (+1)" }, "maxPhoneNumbers": { "title": "Max Phone Numbers", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Stop scraping after this many phone numbers are found. Only used in Find New Numbers mode.", "default": 20 }, "searchTerms": { "title": "Search Terms", "type": "array", "description": "Enter keywords to find Twitter profiles (e.g., 'Fitness Coaches', 'Crypto', 'Real Estate'). Only used in Find New Numbers mode.", "items": { "type": "string" } }, "sourceRegion": { "title": "Source Type", "enum": [ "All", "Status", "Profile" ], "type": "string", "description": "Select the information type to target. Only used in Find New Numbers mode.", "default": "All" }, "phoneList": { "title": "Phone List (for Validate My List mode)", "type": "array", "description": "Paste the phone numbers you want checked for deliverability (any format - the selected Country is used as the default region for numbers without a country code). Only used when Scrape Mode is set to \"Validate My List\".", "default": [], "items": { "type": "string" } }, "minQualityScore": { "title": "Minimum Quality Score", "minimum": 0, "maximum": 1, "type": "number", "description": "Drop any number whose quality score (0.0-1.0) falls below this. Leave at 0 for no filter.", "default": 0 }, "requireStrictValid": { "title": "Require Strict Validity", "type": "boolean", "description": "Drop numbers that fail strict validity - mainly relevant in Validate My List mode.", "default": false }, "excludeTollFree": { "title": "Exclude Toll-Free Numbers", "type": "boolean", "description": "Drop numbers identified as toll-free.", "default": false }, "excludePremiumRate": { "title": "Exclude Premium-Rate Numbers", "type": "boolean", "description": "Drop numbers identified as premium-rate.", "default": false }, "requireCountryMatch": { "title": "Require Country Match", "type": "boolean", "description": "Drop numbers whose own detected region does not match the Country you selected.", "default": false }, "strictCountry": { "title": "Strict country filter", "type": "boolean", "description": "Restrict Google to pages it attributes to the country you selected (cr=countryXX), rather than only preferring them. Much tighter targeting, noticeably fewer results.", "default": false }, "searchLanguage": { "title": "Result Language", "enum": [ "", "en", "es", "fr", "de", "it", "pt", "nl", "pl", "ru", "tr", "ar", "hi", "ja", "ko", "zh-CN", "id", "sv", "da", "no", "fi", "cs", "el", "he", "th", "vi" ], "type": "string", "description": "Restrict results to one language. Leave on \"Any language\" for no filter.", "default": "" }, "timeRange": { "title": "Time Range", "enum": [ "Any time", "Past hour", "Past 24 hours", "Past week", "Past month", "Past year", "Custom range" ], "type": "string", "description": "Only return pages Google indexed within this window. A number published last month is far more likely to still be answered than one last seen years ago.", "default": "Any time" }, "customDateFrom": { "title": "Custom range: from", "type": "string", "description": "Only used when Time Range is \"Custom range\". Format: YYYY-MM-DD.", "default": "" }, "customDateTo": { "title": "Custom range: to", "type": "string", "description": "Only used when Time Range is \"Custom range\". Format: YYYY-MM-DD.", "default": "" } } }, "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 } } } } } } } } } }