Telegram Finder
v1.0.1
OAS 3.1.0

Telegram User Lookup API

Download OpenAPI Document

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

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

Production server

Client Libraries
Curl Shell

Retrieve Telegram usernames by phone numbers

​

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

Note: Rate limit - maximum 10 requests per hour. If you need higher quotas we can work to unblock them; contact valentin@telegram-finder.io

Headers
  • x-api-key
    Type:string
    required

    API key for authentication.

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

    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
  • 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
}

Successful response with user details. Returns a map where keys are phone numbers and values are either User objects or null if not found.

Models