# Telegram Phone Number Info – Register Check + Carrier (`scrapepilot/telegram-phone-number-info---register-check-carrier`) Actor Check if any phone number is on Telegram. Get carrier, country, line type (mobile/VoIP), name & photo (public), registration status. Bulk lookup, no login. Residential proxy ready. $0.10/run + $4/1K numbers - **URL**: https://apify.com/scrapepilot/telegram-phone-number-info---register-check-carrier.md - **Developed by:** [Scrape Pilot](https://apify.com/scrapepilot) (community) - **Categories:** Lead generation, Social media, Other - **Stats:** 4 total users, 3 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing from $4.00 / 1,000 contacts This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## 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.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.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/platform/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 --- ## πŸ“ž Telegram Phone Number Info – Register Check + Carrier [![Apify Actor](https://img.shields.io/badge/Apify-Actor-1B82E6)](https://apify.com/your-username/telegram-phone-number-info) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT) [![Pricing: $4 / 1K results](https://img.shields.io/badge/Pricing-$4%2F1K%20results-blue)](https://apify.com/your-username/telegram-phone-number-info/pricing) [![Actor Start: $0.10](https://img.shields.io/badge/Actor%20Start-$0.10-green)](https://apify.com/your-username/telegram-phone-number-info) **Check if any phone number is registered on Telegram. Get carrier, country, line type, timezone, name & photo (public), and more. No login required. Bulk lookup. Residential proxy ready.** --- ### πŸ’‘ What is this Actor? The **Telegram Phone Number Info** actor answers one question: *Is this phone number on Telegram?* It then enriches the result with: - βœ… Telegram registration status (true/false) - πŸ‘€ First name, last name (from Telegram preview or OSINT) - πŸ–ΌοΈ Profile photo URL (if public) - πŸ“ž Phone number (normalized to E.164) - 🌍 Country, country code, carrier, line type (mobile/landline/VoIP) - πŸ•’ Timezone, national format, validity - πŸ” State: `active`, `not_registered`, `invalid`, `unknown` No Telegram account, no API key, no login required. Works with any international phone number. Perfect for lead verification, fraud detection, customer enrichment, and social media intelligence. --- ### πŸš€ Key Features | Feature | Description | |-----------------------------|-------------| | **Bulk phone lookup** | Process thousands of numbers in one run. | | **No API key** | Uses public Telegram preview pages + free phone APIs. | | **No login** | No Telegram account needed. | | **Intelligent detection** | Carrier, line type, timezone, country – all automatic. | | **Public name & photo** | Extracted from Telegram preview page (if available). | | **Residential proxy ready** | Avoids Telegram blocking (strongly recommended). | | **Cost‑effective pricing** | $0.10/run + $4 per 1,000 numbers – pay as you go. | | **Clean JSON / CSV / Excel** | Export from Apify dataset or via API. | --- ### πŸ“₯ Input Parameters | Parameter | Type | Required | Default | Description | |----------------------|---------------------|----------|---------|-------------| | `phone` / `phones` / `phone_numbers` | string or array | **Yes** | – | One or more phone numbers (national or international). | | `proxyConfiguration` | object | No | – | Apify proxy settings. **Residential** strongly recommended. | #### Example Input (Single) ```json { "phone": "+14155552671" } ```` #### Example Input (Bulk) ```json { "phones": "+14155552671\n+441234567890\n+61412345678", "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": ["RESIDENTIAL"] } } ``` *** ### πŸ“€ Output Example ```json [ { "registered": true, "phone": "+14155552671", "id": null, "username": null, "firstName": "John", "lastName": "Doe", "about": null, "photo": "https://cdn4.telesco.pe/file/abc123.jpg", "state": "active", "wasOnline": null, "langCode": null, "premium": null, "blocked": false, "bot": false, "country": "United States", "country_code": "+1", "carrier": "AT&T Mobility", "line_type": "Mobile", "timezone": "America/New_York", "national_format": "(415) 555-2671", "phone_valid": true, "phone_input": "+14155552671", "note": "Full Telegram profile requires official MTProto API. This actor provides registration status + phone intelligence.", "fetched_at": "2026-04-24T15:00:00Z" } ] ``` *** ### πŸ’° Pricing | Component | Price | |--------------------------|----------------| | **Actor start (per run)** | **$0.10** | | **Per 1,000 results** | **$4.00** | - Example: 250 numbers β†’ $0.10 + (250/1000)\*$4 = **$1.10** - Example: 5,000 numbers β†’ $0.10 + 5\*$4 = **$20.10** - No monthly subscription – pay only for what you use. *** ### 🎯 Use Cases | Industry / Use Case | How It Helps | |---------------------|---------------| | **Lead Generation** | Verify that a lead’s phone number has an active Telegram account before outreach. | | **Fraud Detection** | Detect VoIP or virtual numbers; identify suspicious Telegram registrations. | | **Customer Enrichment** | Add Telegram status, name, photo, carrier to your CRM. | | **Compliance / KYC** | Validate phone number format, country, and line type. | | **Market Research** | Estimate Telegram penetration by carrier or country. | | **Social Media Intelligence** | Discover if a person uses Telegram and retrieve public info. | *** ### ❓ Frequently Asked Questions **1. Do I need a Telegram account?**\ No. The actor uses public `t.me/+{phone}` pages and free APIs. **2. Can I get the Telegram username (@username)?**\ Not from this actor – that requires the official MTProto API. Our companion actor does that. **3. Why do I need residential proxies?**\ Telegram blocks datacenter IPs. Residential proxies are **required** for reliable results. **4. How accurate is `firstName` / `lastName`?**\ It is extracted from the Telegram preview page (if the user hasn’t hidden it) or from Sync.me. Not guaranteed but often correct. **5. What does `line_type` mean?** - `Mobile` – real mobile number (most likely on Telegram). - `Fixed Line` – landline (rarely on Telegram). - `VoIP` – virtual number (often not registered). - `Toll Free`, `Premium Rate`, etc. – special categories. **6. How many numbers can I process?**\ No hard limit. For >10,000 numbers, split into multiple runs or increase memory. **7. Why does `registered` sometimes return `null`?**\ Possible reasons: invalid number format, network timeout, or restricted country (e.g., number not public). **8. Is there a free trial?**\ You can test with 1–2 numbers at low cost (minimum $0.10 actor start + ~$0.004 per number). Apify also offers a free monthly credit for new users. **9. Can I export to CSV / Excel?**\ Yes. After the run, go to the **Dataset** tab and choose CSV or Excel. **10. What is the `note` field?**\ It explains that full Telegram profile fields (id, username, about, wasOnline, langCode, premium) require the official Telegram API – not included in this actor. *** ### πŸ” SEO Keywords `Telegram phone number check`, `Telegram registration lookup`, `carrier detection`, `line type mobile landline`, `phone intelligence API`, `Telegram public profile`, `Sync.me lookup`, `phone verification Telegram`, `bulk phone validator`, `Apify Telegram actor`, `phone carrier lookup` *** *** *** **Start checking phone numbers today – $0.10/run + $4 per 1,000 numbers. Residential proxy included.** ```` # Actor input Schema ## `phone` (type: `string`): Phone number to check in international format. βœ… Accepted formats: +15175051136 15175051136 +447911123456 +919876543210 +8613800138000 πŸ’‘ Include country code. The + prefix is optional. ## `proxyConfiguration` (type: `object`): RESIDENTIAL proxy is required for Telegram and phone lookup APIs. βœ… Always keep RESIDENTIAL proxy enabled. ## Actor input object example ```json { "phone": "+15175051136", "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } ```` # 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 = { "phone": "+15175051136", "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } }; // Run the Actor and wait for it to finish const run = await client.actor("scrapepilot/telegram-phone-number-info---register-check-carrier").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 = { "phone": "+15175051136", "proxyConfiguration": { "useApifyProxy": True, "apifyProxyGroups": ["RESIDENTIAL"], }, } # Run the Actor and wait for it to finish run = client.actor("scrapepilot/telegram-phone-number-info---register-check-carrier").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 '{ "phone": "+15175051136", "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } }' | apify call scrapepilot/telegram-phone-number-info---register-check-carrier --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=scrapepilot/telegram-phone-number-info---register-check-carrier", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Telegram Phone Number Info – Register Check + Carrier", "description": "Check if any phone number is on Telegram. Get carrier, country, line type (mobile/VoIP), name & photo (public), registration status. Bulk lookup, no login. Residential proxy ready. $0.10/run + $4/1K numbers", "version": "0.0", "x-build-id": "6GS1wiFmtVLGeeUsb" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapepilot~telegram-phone-number-info---register-check-carrier/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapepilot-telegram-phone-number-info---register-check-carrier", "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/scrapepilot~telegram-phone-number-info---register-check-carrier/runs": { "post": { "operationId": "runs-sync-scrapepilot-telegram-phone-number-info---register-check-carrier", "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/scrapepilot~telegram-phone-number-info---register-check-carrier/run-sync": { "post": { "operationId": "run-sync-scrapepilot-telegram-phone-number-info---register-check-carrier", "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": [ "phone" ], "properties": { "phone": { "title": "πŸ“± Phone Number", "pattern": "^\\+?[1-9]\\d{1,14}$", "type": "string", "description": "Phone number to check in international format.\n\nβœ… Accepted formats:\n+15175051136\n15175051136\n+447911123456\n+919876543210\n+8613800138000\n\nπŸ’‘ Include country code. The + prefix is optional." }, "proxyConfiguration": { "title": "πŸ”’ Proxy (RESIDENTIAL Required)", "type": "object", "description": "RESIDENTIAL proxy is required for Telegram and phone lookup APIs.\n\nβœ… Always keep RESIDENTIAL proxy enabled." } } }, "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 } } } } } } } } } } ```