Perfil de usuário do Telegram

task_type=tg_username_profile

Entrada e limites

nomes de usuário do Telegram. Envie um arquivo de texto com um valor por linha. Processe somente identificadores autorizados.

Envio mínimo: 500. Envio máximo: 10,000,000. Quantidade mínima faturável: 0. O mínimo de envio difere do mínimo de cobrança. Um envio pequeno aceito pode ser cobrado pelo mínimo. Zero indica ausência de piso. Uma tarefa totalmente malsucedida ou não processada não gera um mínimo artificial. Confira os preços atuais da conta.

Criar tarefa

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

Consultar e baixar

Guarde o task_id recebido. Consulte até status=exported e baixe result_url. pending e processing não são finais; pare em failed. Não repita automaticamente a criação após um tempo limite: a tarefa pode já existir.

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

Colunas CSV

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

Preserve a ordem e as maiúsculas. Valores vazios ou indeterminados não confirmam um resultado negativo.

A análise de perfil exige um avatar público. Sem ele, o processamento termina após verificar o registro; campos posteriores podem ficar vazios. Atributos derivados do avatar são estimativas. Profile difere de Activity; Full foi descontinuado. Não substitua tipos de tarefa automaticamente.

Autenticação e erros

Use X-API-Key com uma chave no servidor. 400: entrada inválida; 401: chave inválida; 402: saldo insuficiente; 404: tarefa inexistente; 413: arquivo grande demais. Repita consultas seguras com espera limitada e mantenha o ID.

Preços atuais

Contrato revisado: 2026-10-30. Os limites podem mudar; consulte o painel antes do envio.