Solicitação cURL
POST /api/v1/bulk-taskscurl -X POST "https://tgvalidator.com/api/v1/bulk-tasks" \
-H "X-API-Key: sk_your_api_key" \
-F service_type=tg_username_profile_batch \
-F file=@usernames.txt Demonstração ao vivo
POST /api/v1/bulk-tasksservice_type=tg_username_profile_batchProduto em massa tg_username_profile_batch
Verificação de perfil por nome de usuário em massa do Telegram
ID de usuário, dias de atividade e URL da foto de perfil para uma lista inteira de nomes de usuário.
Um complemento para listas grandes inteiras — para poucos números, a verificação em tempo real responde na mesma solicitação. Verificação em tempo real →
Contrato da API
Duas etapas: envie o arquivo e depois consulte a tarefa
O envio retorna um ID de tarefa imediatamente; consulte a tarefa por esse ID e, quando ela for concluída com sucesso, a resposta trará o link de download do arquivo de resultado. Cada solicitação é exibida com a respectiva resposta.
1. Envie o arquivo
O ID da tarefa volta imediatamente com preparing definido como true enquanto o arquivo é preparado em segundo plano: linhas inválidas, duplicadas e — em tarefas de números — números sem código do país ou de outro país são removidos e não são cobrados. O saldo é reservado para as linhas enviadas e liquidado na conclusão; a diferença é reembolsada.
Resposta: tarefa criada
200 OK{
"code": 0,
"msg": "ok",
"data": {
"id": "3f9c2a7d8e4b4c1a9f0e6b2d5c8a7e13",
"product": "tg_username_profile_batch",
"status": "processing",
"submitted_lines": 1015,
"total": 1015,
"invalid_cnt": 0,
"no_code_cnt": 0,
"other_country_cnt": 0,
"duplicate_cnt": 0,
"preparing": true,
"created_at": "2026-09-08T09:30:00Z"
}
}2. Consulte a tarefa
Consulte pelo ID da tarefa. Quando a preparação termina, submitted_lines = total + invalid_cnt + no_code_cnt + other_country_cnt + duplicate_cnt, em que total é o que é verificado e cobrado. Uma resposta de sucesso traz as contagens de sucesso e de falha e o link de download do arquivo de resultado; uma tarefa recusada durante a preparação fica como failed com reason_detail e é reembolsada integralmente.
Solicitação cURL
GET /api/v1/bulk-tasks/{id}curl "https://tgvalidator.com/api/v1/bulk-tasks/3f9c2a7d8e4b4c1a9f0e6b2d5c8a7e13" \
-H "X-API-Key: sk_your_api_key"Resposta: tarefa concluída
200 OK{
"code": 0,
"msg": "ok",
"data": {
"id": "3f9c2a7d8e4b4c1a9f0e6b2d5c8a7e13",
"product": "tg_username_profile_batch",
"status": "success",
"submitted_lines": 1015,
"total": 1000,
"invalid_cnt": 3,
"no_code_cnt": 0,
"other_country_cnt": 0,
"duplicate_cnt": 12,
"preparing": false,
"success_cnt": 990,
"failure_cnt": 10,
"result_url": "https://…/result.csv",
"created_at": "2026-09-08T09:30:00Z"
}
}Como funciona
O que acontece com uma tarefa em massa
A verificação em massa não é a verificação em tempo real em escala maior — você envia uma vez, ela roda em segundo plano e você coleta depois. Não é preciso manter a página aberta; o estado da tarefa e os resultados ficam no seu painel.
01Envie o arquivo
Um .txt ou .csv com um número por linha. Ele é transmitido diretamente; nada é gravado em disco.
02Pré-verificação e reserva
Problemas óbvios (arquivo vazio, formato incorreto, poucas linhas) são rejeitados no envio. Em seguida, o saldo é reservado e o arquivo é preparado em segundo plano: linhas inválidas, duplicadas e números sem código do país ou de outro país são removidos, e a regra de país único é verificada. Um arquivo que falha nessa etapa termina como tarefa com falha, reembolsada integralmente; caso contrário, apenas as linhas restantes são verificadas, e a tarefa é liquidada ao ser concluída.
03Execução em segundo plano
A tarefa é executada sozinha — feche a página se quiser. Uma falha é informada imediatamente e reembolsada integralmente.
04Baixe o resultado
Obtenha o arquivo na página de verificação em massa. Você paga apenas pelos números que efetivamente retornaram resultado; a diferença é reembolsada.
Campos do resultado
Colunas do arquivo de resultado
O download é um único arquivo CSV contendo esta tabela completa.
Colunas do arquivo de resultado
identifier·alex_kim— O nome de usuário enviado, sem @ ou t.me/ (ex.: alex_kim).activated·true— Se o nome de usuário pertence a uma conta existente do Telegram: true ou false. Quando não é true, todas as outras colunas dessa linha ficam vazias.uid·1234567890— ID de usuário do Telegram; pode ficar vazio mesmo para uma conta existente.activedays·9— Dias desde que a conta foi vista por último, como número inteiro — quanto menor, mais recente. Quando a conta oculta o horário exato do visto por último, o Telegram revela apenas um intervalo e o valor é uma aproximação: 0 (recentemente), 7 (na última semana), 30 (no último mês) ou 1000 (há muito tempo). Pode ficar vazio quando a conta não revela nenhuma informação de visto por último.avatar_url·https://cdn5.telesco.pe/file/example.jpg— URL da foto de perfil; vazia quando a conta não tem foto.
Ideal para
Quando recorrer a este produto
Classificar listas de nomes de usuário por atividade
activedaysactivatedSepare os nomes de usuário ativos recentemente dos inativos há muito tempo e trabalhe primeiro com os que têm mais chance de responder.
Identificar contas silenciosas há muito tempo
activatedactivedaysConfirme que a conta existe e depois sinalize os nomes de usuário sem sinal de atividade recente antes de investir mais esforço.
Agrupar por atividade recente
activedaysuidAgrupe os nomes de usuário pela atividade mais recente para apoiar a pontuação e a priorização posteriores da lista.
Preencher IDs de usuário e fotos de perfil
uidavatar_urlAdicione IDs de usuário e links públicos de foto de perfil a uma lista existente de nomes de usuário, reduzindo consultas manuais depois.
Resposta direta
O que é a Verificação de perfil por nome de usuário em massa?
A verificação de perfil por nome de usuário em massa do Telegram retorna, além de confirmar que a conta existe, o ID de usuário, quantos dias se passaram desde que a conta foi vista por último e a URL da foto de perfil. A entrada são nomes de usuário, não números; não é preciso escolher país, um nome de usuário por linha.
Limites claros
Limites deste produto
- Não é verificação de identidade. Um resultado descreve o estado de registro do número na plataforma; não pode confirmar quem é o titular do número.
- Nunca retorna histórico de mensagens, conteúdo de conversas nem qualquer conteúdo privado da conta.
- Escolha o país ao qual seus números pertencem ao enviar. A lista deve ser essencialmente desse único país; países vizinhos que compartilham o código de discagem não contam como outro país. Uma lista que não se qualifica termina como tarefa com falha e é reembolsada integralmente.
- Os resultados refletem o momento em que a tarefa foi executada. Execute-a novamente para obter um estado atualizado — os resultados armazenados nunca são atualizados automaticamente.
- Os links de download expiram. Baixe o arquivo logo após o término da tarefa; se um link expirar, consulte a tarefa novamente para obter um novo.
Quando a verificação em massa se encaixa
Quando a verificação em massa vale a pena — e quando a em tempo real é mais rápida
| Verificação em tempo real | Verificação em massa | |
|---|---|---|
| Quantos números | 1 número por verificação única; vários por solicitação múltipla — os limites exatos estão na documentação da API | Uma lista grande inteira em uma única tarefa — a faixa de tamanho atual está na página de preços |
| Obtenção dos resultados | Imediata: os endpoints único e múltiplo respondem na mesma resposta; o painel os retorna um a um | Baixe um arquivo de resultado quando a tarefa terminar |
| País / região | Sem restrição — misture à vontade em uma única solicitação | Escolha um país/região no envio; a lista deve ser essencialmente desse país, e números demais de outros lugares fazem a tarefa falhar com reembolso integral |
| Formato do resultado | JSON, campos por número | Arquivo de resultado (um CSV com a tabela completa) |
| Uso típico | Validação de formulários, consultas de atendentes, bloqueio antes do envio | Higienização de listas, filtragem antes de campanhas, limpeza de dados armazenados |
Perguntas frequentes do produto
Sobre a Verificação de perfil por nome de usuário
Quando devo usar a verificação em massa em vez da verificação em tempo real?
Use a verificação em massa para uma lista grande inteira. Para poucos números, a verificação em tempo real responde na mesma solicitação, sem tarefa para agendar.
O que acontece com os números inválidos do arquivo?
A pré-verificação descarta as linhas malformadas, então elas nunca entram na contagem cobrável. Dos números restantes, os que o serviço de origem não consegue resolver também não são cobrados. Você paga apenas pelos números que efetivamente retornam resultado.
Quanto tempo leva uma tarefa?
Depende da quantidade de números e do produto. Você pode fechar a página após o envio; a tarefa é executada em segundo plano e o resultado fica aguardando você na página de verificação em massa.
Sou reembolsado se falhar?
Sim. Uma tarefa com falha é reembolsada integralmente. Se a tarefa for bem-sucedida, mas alguns números não retornarem nada, essa parte é reembolsada automaticamente. A diferença entre o valor reservado e o valor efetivamente cobrado sempre é devolvida.
Crie uma conta para enviar uma tarefa em massa
As verificações em massa e em tempo real usam o mesmo saldo — não há nada extra para ativar. Cadastre-se e envie seu primeiro arquivo na página de verificação em massa.