API profunda do verificador em massa de números WhatsApp

Verifique os dados demográficos e atributos de perfil de números globais no WhatsApp, incluindo gênero, idade e análise da foto de perfil.

URL da API

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

Características principais

A API profunda do verificador em massa de números WhatsApp oferece recursos analíticos poderosos:

Análise demográfica

A API fornece informações demográficas detalhadas a partir das fotos de perfil, incluindo:

• Detecção de gênero
• Estimativa de idade
• Análise da cor do cabelo
• Detecção do estilo de aparência

Atributos do perfil

Informações completas do perfil, incluindo:

• Verificação do status da conta WhatsApp
• Obtenção da URL da foto de perfil
• Classificação do tipo de foto de perfil
• Status de verificação da conta

Processamento em massa

Processe vários números simultaneamente por meio do envio de arquivo, o que torna a análise em grande escala eficiente.

Etapas de uso

Envio de arquivo

Envie um arquivo de texto com números de telefone no formato E.164:

Exemplo de requisição

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

Parâmetros da requisição

Verificação de status

Acompanhe o status de processamento da sua tarefa:

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

Exemplos de resposta

Resposta de criação da tarefa

{
  "created_at": "2024-10-19T18:24:56.450567423Z",
  "updated_at": "2024-10-19T18:24:56.450567423Z",
  "task_id": "cs9viu7i61pkfs4oavvg",
  "status": "pending",
  "total": 0,
  "success": 0,
  "failure": 0
}

Resposta de status em processamento

{
  "created_at": "2024-10-19T18:24:56.450567423Z",
  "updated_at": "2024-10-19T18:33:22.86152082Z",
  "task_id": "cs9viu7i61pkfs4oavvg",
  "status": "processing",
  "total": 20000,
  "success": 6724,
  "failure": 0
}

Resposta de tarefa concluída

{
  "created_at": "2024-10-19T18:24:56.450567423Z",
  "updated_at": "2024-10-19T18:53:43.141760071Z",
  "task_id": "cs9viu7i61pkfs4oavvg",
  "status": "exported",
  "total": 20000,
  "success": 20000,
  "failure": 0,
  "result_url": "https://example-link-to-results.xlsx"
}

Campos do resultado da verificação de números WhatsApp

Formato de resposta da API

Códigos de status

Notas de integração

1. Cada linha do arquivo de entrada deve conter um número de telefone no formato E.164.

2. Acompanhe o status da tarefa usando o task_id fornecido.

3. Baixe os resultados pelo result_url quando o status for “exported”.

4. Trate adequadamente os diferentes códigos de status no seu aplicativo.

Perguntas frequentes

1. Qual é a capacidade de processamento da API?

A API processa grandes lotes de números com eficiência, com atualizações em tempo real sobre o andamento do processamento.

2. Em que formato deve estar o arquivo de entrada?

O arquivo de entrada deve ser um arquivo de texto com um número de telefone por linha no formato E.164 (ex.: +41798284651).

3. Qual a precisão da análise demográfica?

A análise demográfica se baseia em processamento avançado por IA das fotos de perfil e fornece estimativas de idade, gênero e outros atributos quando disponíveis.

4. Quais são os códigos de status de resposta da API?

A API usa códigos de status HTTP padrão para indicar sucesso ou falha:

• 200: requisição bem-sucedida (cobrada)
• 400: parâmetros ou formato de arquivo inválidos (grátis)
• 500: erro interno do servidor (grátis)

5. Qual é o preço da API?

O preço é de $3.8 USD por 10.000 números. As informações de resposta desta API incluem:

• Verificação do status da conta WhatsApp
• Detecção de gênero
• Estimativa de idade
• Análise do tipo de foto de perfil
• Detecção do estilo de aparência
• Análise da cor do cabelo

Para mais informações sobre preços e processamento de volumes maiores, fale conosco.