v1.0.0
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.

Headers
  • x-api-key
    Type:string
    required

    API key for authentication.

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

    List of phone numbers to lookup.

  • 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/user-lookup
curl https://www.telegram-finder.io/user-lookup \
  --request POST \
  --header 'X-Api-Key: ' \
  --header 'Content-Type: application/json' \
  --data '{
  "phoneNumbers": [
    ""
  ],
  "email": "",
  "linkedin": ""
}'

{
  "ANY_ADDITIONAL_PROPERTY": null
}

Successful response with user details.

Models