WA Lookup

Contrato da API

Duas etapas: envie o arquivo e depois consulte a tarefa

Ler a documentação completa da API Abrir chaves de API

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.

Solicitação cURLPOST /api/v1/bulk-tasks
curl -X POST "https://walookup.com/api/v1/bulk-tasks" \
  -H "X-API-Key: sk_your_api_key" \
  -F service_type=ws_avatar_batch \
  -F country=US \
  -F file=@numbers.txt
Resposta: tarefa criada200 OK
{
  "code": 0,
  "msg": "ok",
  "data": {
    "id": "3f9c2a7d8e4b4c1a9f0e6b2d5c8a7e13",
    "product": "ws_avatar_batch",
    "status": "processing",
    "country": "US",
    "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 cURLGET /api/v1/bulk-tasks/{id}
curl "https://walookup.com/api/v1/bulk-tasks/3f9c2a7d8e4b4c1a9f0e6b2d5c8a7e13" \
  -H "X-API-Key: sk_your_api_key"
Resposta: tarefa concluída200 OK
{
  "code": 0,
  "msg": "ok",
  "data": {
    "id": "3f9c2a7d8e4b4c1a9f0e6b2d5c8a7e13",
    "product": "ws_avatar_batch",
    "status": "success",
    "country": "US",
    "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.

  1. 01Envie o arquivo

    Um .txt ou .csv com um número por linha. Ele é transmitido diretamente; nada é gravado em disco.

  2. 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.

  3. 03Execução em segundo plano

    A tarefa é executada sozinha — feche a página se quiser. Uma falha é informada imediatamente e reembolsada integralmente.

  4. 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.

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 realVerificação em massa
Quantos números1 número por verificação única; vários por solicitação múltipla — os limites exatos estão na documentação da APIUma lista grande inteira em uma única tarefa — a faixa de tamanho atual está na página de preços
Obtenção dos resultadosImediata: os endpoints único e múltiplo respondem na mesma resposta; o painel os retorna um a umBaixe um arquivo de resultado quando a tarefa terminar
País / regiãoSem restrição — misture à vontade em uma única solicitaçãoEscolha 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 resultadoJSON, campos por númeroArquivo de resultado (um CSV com a tabela completa)
Uso típicoValidação de formulários, consultas de atendentes, bloqueio antes do envioHigienização de listas, filtragem antes de campanhas, limpeza de dados armazenados

Verificação em tempo real · Ver preços

Perguntas frequentes do produto

Sobre a Verificação de foto de perfil

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.

Produtos relacionados

Outros produtos em massa

Verificação de registro em massa do WhatsAppEnvie um arquivo inteiro de números, descubra quais estão registrados no WhatsApp e baixe o arquivo de resultado quando terminar.Verificação Business em massa do WhatsAppVerifique uma lista inteira em busca de contas WhatsApp Business: se cada número está no WhatsApp e se essa conta é uma conta WhatsApp Business.Verificação de atividade em massa do WhatsAppStatus de registro mais dias de atividade — dias desde a última atividade do número — para distinguir números ativos de inativos em uma lista inteira.