{ "openapi": "3.0.1", "info": { "title": "Telegram Phone Number Scraper", "description": "Telegram Phone Number Scraper gathers public phone contacts for agencies and B2B teams. Filter groups or channels by topic to streamline prospecting and outbound communication at scale.", "version": "0.1", "x-build-id": "UwFccHKKl3eQ1qJAZ" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapier~telegram-phone-number-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapier-telegram-phone-number-scraper", "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/scrapier~telegram-phone-number-scraper/runs": { "post": { "operationId": "runs-sync-scrapier-telegram-phone-number-scraper", "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/scrapier~telegram-phone-number-scraper/run-sync": { "post": { "operationId": "run-sync-scrapier-telegram-phone-number-scraper", "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": [ "keywords", "country" ], "properties": { "keywords": { "title": "๐Ÿ” Keywords, @usernames or t.me URLs", "type": "array", "description": "๐ŸŽฏ What to scrape. Three kinds of value are accepted and behave differently:\n\nโ€ข **A keyword** (`real estate`) โ€” searches Google for public Telegram channels matching it, then reads each channel's live post feed.\nโ€ข **A @username** (`@my_channel`) โ€” skips search entirely and scrapes that channel directly.\nโ€ข **A t.me URL** (`https://t.me/s/my_channel`, `https://t.me/my_channel/123`) โ€” same as above.\n\n๐Ÿ’ก Every keyword gets its own budget of `maxPhoneNumbers` results.\n\nโœ… The prefilled `kvartira` + `Uzbekistan` pair is a verified working example โ€” press Start and it returns real numbers. Use keywords in the language your target country's channels actually post in; an English keyword finds few non-English channels.", "items": { "type": "string" }, "default": [ "kvartira" ] }, "country": { "title": "๐ŸŒ Country", "enum": [ "Belarus (+375)", "Uzbekistan (+998)", "Ukraine (+380)", "Iran (+98)", "Germany (+49)", "Israel (+972)", "Czech Republic (+420)", "Ethiopia (+251)", "Poland (+48)", "Turkey (+90)", "United Arab Emirates (+971)", "Italy (+39)", "Russia (+7)", "United States (+1)", "Singapore (+65)", "Azerbaijan (+994)", "Japan (+81)", "Portugal (+351)", "Moldova (+373) ยท limited", "Australia (+61) ยท limited", "Tajikistan (+992) ยท limited", "Slovakia (+421) ยท limited", "Malaysia (+60) ยท limited", "Algeria (+213) ยท limited", "Hong Kong (+852) ยท limited", "India (+91) ยท limited", "Sri Lanka (+94) ยท limited", "Sudan (+249) ยท limited", "Armenia (+374) ยท limited", "Ghana (+233) ยท limited", "Iraq (+964) ยท limited", "Kenya (+254) ยท limited", "Kuwait (+965) ยท limited", "Morocco (+212) ยท limited", "Yemen (+967) ยท limited", "Qatar (+974) ยท limited", "Mexico (+52) ยท limited", "Netherlands (+31) ยท limited", "Saudi Arabia (+966) ยท limited", "United Kingdom (+44) ยท limited", "Colombia (+57) ยท limited", "Estonia (+372) ยท limited", "Georgia (+995) ยท limited", "Indonesia (+62) ยท limited", "Ireland (+353) ยท limited", "Jordan (+962) ยท limited", "Serbia (+381) ยท limited", "Thailand (+66) ยท limited", "Vietnam (+84) ยท limited", "Egypt (+20) ยท limited", "France (+33) ยท limited", "Kyrgyzstan (+996) ยท limited", "Latvia (+371) ยท limited", "Norway (+47) ยท limited", "Tunisia (+216) ยท limited", "Venezuela (+58) ยท limited", "Bangladesh (+880) ยท limited", "China (+86) ยท limited", "Ivory Coast (+225) ยท limited", "Nigeria (+234) ยท limited", "Pakistan (+92) ยท limited", "Spain (+34) ยท limited", "Syria (+963) ยท limited", "Afghanistan (+93) ยท limited", "Austria (+43) ยท limited", "Bulgaria (+359) ยท limited", "Cameroon (+237) ยท limited", "Denmark (+45) ยท limited", "Korea, South (+82) ยท limited", "Oman (+968) ยท limited", "Peru (+51) ยท limited", "Senegal (+221) ยท limited", "Sweden (+46) ยท limited", "Tanzania (+255) ยท limited", "Argentina (+54) ยท limited", "Brazil (+55) ยท limited", "Canada (+1) ยท limited", "Finland (+358) ยท limited", "Greece (+30) ยท limited", "Lebanon (+961) ยท limited", "Libya (+218) ยท limited", "Myanmar (+95) ยท limited", "Nepal (+977) ยท limited", "Philippines (+63) ยท limited", "Romania (+40) ยท limited", "South Africa (+27) ยท limited", "Taiwan (+886) ยท limited", "Turkmenistan (+993) ยท limited", "Uganda (+256) ยท limited" ], "type": "string", "description": "๐ŸŒŽ Which country's phone numbers to collect. This is a hard filter, not a hint: a number is only ever emitted if it is written in full international form in the post **and** its length and prefix are legal under that country's real national numbering plan. Nothing is inferred โ€” a number whose country cannot be established is dropped rather than guessed at.\n\nโš ๏ธ Entries marked `ยท limited` were measured live and do carry real Telegram phone numbers, just few of them โ€” expect small result counts. Unlisted countries were measured and returned nothing, so they are rejected up front instead of wasting a run.", "default": "Uzbekistan (+998)" }, "maxPhoneNumbers": { "title": "๐Ÿ“Š Maximum phone numbers per keyword", "minimum": 1, "maximum": 10000, "type": "integer", "description": "๐ŸŽš๏ธ Hard cap on how many phone numbers are collected for EACH keyword. The run stops opening channels for that keyword the moment the cap is hit. Duplicates are removed across the whole run, so this counts distinct numbers.", "default": 10 }, "engine": { "title": "โš™๏ธ Engine", "enum": [ "deep", "fast" ], "type": "string", "description": "๐Ÿ”ง How deeply to scrape.\n\nโ€ข **deep** (recommended) โ€” opens every matching channel's real public post feed on t.me and reads the full, untruncated post text plus any `tel:` / WhatsApp links. Far more results and no truncation.\nโ€ข **fast** โ€” reads only the Google result snippets. Much quicker and uses no t.me requests, but a snippet is ~160 truncated characters, so it finds a small fraction of the numbers `deep` does.", "default": "deep" }, "proxyConfiguration": { "title": "๐Ÿ›ก๏ธ Proxy configuration", "type": "object", "description": "๐ŸŒ Proxy used for the Google discovery step. Google blocks unproxied datacenter traffic outright, so Apify Proxy with the GOOGLE_SERP group is used by default and the connection is rotated automatically on any blocked response. Telegram itself is fetched directly and only falls back to a proxy if that is refused. Advanced users can select other groups or supply custom proxy URLs.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "GOOGLE_SERP" ] } } } }, "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 } } } } } } } } } }