Telegram Username Profile

task_type=tg_username_profile

Input and limits

Telegram usernames. Upload a text file with one value per line. Use only identifiers you are authorized to process.

Minimum upload: 500. Maximum upload: 10,000,000. Minimum billable quantity: 0. Upload minimum and billing minimum are distinct; a small accepted upload may still incur the billing floor. Zero means no billing floor. A wholly failed or unprocessed task is not charged a fabricated minimum. Check current account pricing before submission.

Create a task

curl --request POST 'https://api.numberchecker.ai/v1/tasks' \
  --header 'X-API-Key: YOUR_API_KEY' \
  --form 'file=@input.txt' \
  --form 'task_type=tg_username_profile'

Poll and download

Keep the returned task_id. Poll until status=exported, then download result_url. pending and processing are incomplete; stop on failed. Never automatically repeat task creation after a timeout: the first request may already have created a task.

curl --request POST 'https://api.numberchecker.ai/v1/gettasks' \
  --header 'X-API-Key: YOUR_API_KEY' \
  --form 'task_id=YOUR_TASK_ID'

CSV columns

username,activated,avatar_url,uid,lastseen,activedays,member,category,gender,hair_color,skin_color,age

Preserve column order and case. Empty or undetermined values are not a confirmed negative.

Profile extraction requires a public avatar. Accounts without one stop after registration; later activity/profile columns can remain empty. Avatar-derived attributes are estimates, not verified personal facts. This is Profile, distinct from Activity; the former Full product is retired. Do not substitute task types automatically.

Authentication and errors

Use the X-API-Key header with a server-side key. 400: invalid input; 401: invalid key; 402: insufficient balance; 404: task not found; 413: oversized file. Retry safe status reads with capped backoff; preserve the original task ID.

Current pricing

Contract reviewed: 2026-10-30. Limits can change; consult the dashboard before submitting.