Telegram Get Phone Info

Check phone numbers on Telegram and retrieve associated user information. It processes phone numbers and returns detailed user data, including ID, username, name, profile details, and account status.

Features

• Validates phone numbers using the regex pattern ^\\+?[1-9]\\d{1,14}$.
• Retrieves Telegram user details such as:
  • User ID
  • Username
  • First and Last Name
  • About section
  • Profile photo
  • Account state
  • Last online status
  • Language code
  • Premium status
  • Blocked status
  • Bot status
• Outputs data in a structured JSON format for easy integration.

Input

The Actor accepts a single input field:

• phone: A phone number in international format (e.g., +1234567890 or 79959972160).

Input Schema

{
  "phone": {
    "title": "Phone Number",
    "type": "string",
    "pattern": "^\\+?[1-9]\\d{1,14}$",
    "description": "Phone numbers to check (in international format, e.g., 1234567890).",
    "editor": "textfield",
    "prefill": "123547890"
  }
}

Example:

{
    "phone": "15175051136"
}

Output

The Actor returns a JSON object with the following fields:json

{
  "phone": {
    "label": "Phone",
    "format": "text"
  },
  "id": {
    "label": "Id",
    "format": "text"
  },
  "username": {
    "label": "Username",
    "format": "text"
  },
  "firstName": {
    "label": "First Name",
    "format": "text"
  },
  "lastName": {
    "label": "Last Name",
    "format": "text"
  },
  "about": {
    "label": "About",
    "format": "about"
  },
  "photo": {
    "label": "Photo",
    "format": "image"
  },
  "state": {
    "label": "State",
    "format": "text"
  },
  "wasOnline": {
    "label": "Was Online",
    "format": "text"
  },
  "langCode": {
    "label": "Lang Code",
    "format": "text"
  },
  "premium": {
    "label": "Premium",
    "format": "boolean"
  },
  "blocked": {
    "label": "Blocked",
    "format": "boolean"
  },
  "bot": {
    "label": "Bot",
    "format": "boolean"
  }
}

Usage

Set up your Apify account: Sign up at Apify and create a new Actor. Configure the input: Provide a valid phone number in international format (e.g., +1234567890). Run the Actor: Execute the Actor to fetch Telegram user details. Retrieve results: The Actor outputs the results in the specified JSON format.

Limitations

Requires a valid Telegram account and API access for authentication. Telegram's API rate limits may apply. Some user data (e.g., wasOnline, photo) may not be available if restricted by the user's privacy settings.

Notes

Ensure compliance with Telegram's Terms of Service and privacy policies. Handle sensitive user data responsibly and in accordance with applicable laws.

Support

For issues or questions, contact the developer through the Apify platform or open an issue in the repository.