API Verificador de Avatar, Idade e Gênero em Massa do Telegram: Análise de Perfil

Verifique as informações de avatar das contas Telegram para os números de telefone globais inseridos, incluindo se a conta está ativa, URL da foto de perfil, gênero, idade, cor de cabelo e cor de pele.

Exemplo para enviar o arquivo de detecção:

curl --location 'https://api.checknumber.ai/v1/tasks' \
--header 'X-API-Key: API-KEY' \
--form 'file=@"./number.txt"' \
--form 'task_type="tg_avatar"'

Exemplo para consultar o status da tarefa:

curl --location 'https://api.checknumber.ai/v1/gettasks' \
--header 'X-API-Key: API-KEY' \
--form 'task_id="task_id"'

Resposta para upload bem-sucedido

{
    "task_id": "d4g8o46p2jvh04o9uolg",
    "status": "pending",
    "total": 2049,
    "estimated_amount": {
        "amount": "0.500000",
        "currency": "USD"
    },
    "message": "Task created successfully",
    "created_at": "2025-11-21T15:58:08.916446594Z"
}

Resposta para status de processamento

{
    "created_at": "2025-11-21T08:27:09.933Z",
    "updated_at": "2025-11-21T08:27:10.241Z",
    "task_id": "d4g24nep2jvh04o9uoh0",
    "user_id": "wfi7wGPS4B4PdtTMox5Y",
    "status": "processing",
    "total": 2049,
    "success": 1024,
    "failure": 0
}

Resposta quando a tarefa for concluída (inclui a URL de download):

{
    "created_at": "2025-11-21T08:27:09.933Z",
    "updated_at": "2025-11-21T08:27:10.241Z",
    "task_id": "d4g24nep2jvh04o9uoh0",
    "user_id": "wfi7wGPS4B4PdtTMox5Y",
    "status": "exported",
    "total": 2049,
    "success": 2049,
    "failure": 0,
    "result_url": "https://wapic.s3.ap-southeast-1.amazonaws.com/externalcheck/d4g24nep2jvh04o9uoh0/d4g24nep2jvh04o9uoh0.zip?X-Amz-Algorithm=AWS4-HMAC-SHA256...",
    "actual_amount": {
      "amount": "2.000000",
      "currency": "USD"
    }
}

URL da requisição para upload de arquivo

POST https://api.checknumber.ai/v1/tasks

Parâmetros da requisição para upload de arquivo

Parâmetro	Descrição
file	file, Envie um arquivo; cada linha deve conter um número de telefone no formato E.164
task_type	string, Tipo de tarefa, defina como “tg_avatar”

URL da requisição para consultar status

POST https://api.checknumber.ai/v1/gettasks

Parâmetros da requisição para consultar status

Parâmetro	Descrição
task_id	string, ID da tarefa retornado na criação

Campos do resultado

Campo	Descrição	Exemplo
Number	Número de telefone em formato E.164	+41798284651
telegram	Se o número tem conta Telegram ativa	yes, no
avatar	URL da foto de perfil Telegram	https://example.com/avatar.jpg
age	Faixa etária estimada com base na foto de perfil	25
gender	Gênero detectado na foto de perfil	male, female
category	Classificação de tipo da foto de perfil	individual portrait, pet avatar, object, etc.
hair_color	Cor de cabelo detectada na foto de perfil	black, brown, blonde, etc.
skin_color	Cor de pele detectada na foto de perfil	white, black, etc.

Formato da resposta

Campo	Descrição
created_at	Timestamp quando a tarefa foi criada
updated_at	Timestamp da última atualização de status da tarefa
task_id	Identificador único da tarefa
user_id	ID do usuário
status	Status da tarefa: pending: Na fila aguardando processing: Processando exported: Resultados disponíveis para download failed: A tarefa falhou, o valor cobrado é reembolsado automaticamente
total	Total de números de telefone processados
success	Números identificados com sucesso
failure	Números que falharam no processamento
result_url	(Opcional) URL de download para resultados quando o status é exported
actual_amount	(Opcional) Valor efetivamente cobrado, disponível após a liquidação da tarefa
estimated_amount	(Resposta de criação) Valor estimado da tarefa; a cobrança final é liquidada na conclusão

Códigos de status

Status	Descrição
200	free, Solicitação bem-sucedida (ex.: consulta de status)
202	charge, Tarefa criada com sucesso; o valor estimado é deduzido
400	free, Solicitação inválida: parâmetros ou formato de arquivo inválidos, tipo de tarefa não suportado ou entradas válidas abaixo do lote mínimo
401	free, Chave de API ausente ou inválida
402	free, Saldo insuficiente
404	free, Tarefa não encontrada
413	free, Arquivo enviado muito grande
500	free, Erro interno do servidor, tente novamente mais tarde