v1.0.1
OAS 3.1.0

Telegram User Lookup API

API for fetching Telegram user information by phone number with enrichment capabilities.

Server: https://www.telegram-finder.io

Production server

Client Libraries

Retrieve Telegram usernames by phone numbers

Returns Telegram user details by phone numbers, with optional phone enrichment using email or LinkedIn.

Headers
  • x-api-key
    Type:string
    required

    API key for authentication.

Body
application/json
  • phoneNumbers
    Type:array string[] …15

    List of phone numbers to lookup (maximum 10 numbers).

  • email
    Type:string Format: email

    Email for phone enrichment.

  • linkedin
    Type:string

    LinkedIn URL for phone enrichment.

Responses
  • application/json
  • application/json
  • application/json
  • application/json
  • application/json
  • application/json
Request Example forPOST/api/telegram
curl https://www.telegram-finder.io/api/telegram \
  --request POST \
  --header 'X-Api-Key: ' \
  --header 'Content-Type: application/json' \
  --data '{
  "phoneNumbers": [
    ""
  ],
  "email": "",
  "linkedin": ""
}'
{
  "+1234567890": {
    "id": "123456789",
    "firstName": "John",
    "lastName": "Doe",
    "username": "johndoe",
    "phone": "+1234567890",
    "verified": true
  },
  "+0987654321": null
}

Models