Início Rápido — Primeira Consulta de Perfil em 10 Minutos

Passo 1 — Obtenha uma chave de API

Dois canais — escolha um. Mesmo JSON, mesmos endpoints, origem da chave e URL base diferentes:

Uma chave direta NÃO funcionará com a URL base do RapidAPI e vice-versa. O nome do cabeçalho x-rapidapi-key é reutilizado em ambos para fins de compatibilidade — o que importa é o valor de origem.

Passo 2 — Faça sua primeira solicitação

Proxy direto (recomendado):

curl -H "x-rapidapi-key: YOUR_DIRECT_KEY" \
  "https://whatsapp-proxy.checkleaked.cc/number/13105551234"

Mercado RapidAPI:

curl -H "x-rapidapi-key: YOUR_RAPIDAPI_KEY" \
  -H "x-rapidapi-host: whatsapp-data1.p.rapidapi.com" \
  "https://whatsapp-data1.p.rapidapi.com/number/13105551234"

Passo 3 — Leia a resposta

A resposta é um documento WhatsAppEntry (formato dinâmico — campos extras removidos):

{
  "number": "13105551234",
  "countryCode": "US",
  "phone": "+1 310 555 1234",
  "type": "FIXED_LINE_OR_MOBILE",
  "about": null,
  "isWAContact": true,
  "isUser": true,
  "isBusiness": true,
  "isGroup": false,
  "isBlocked": false,
  "isMyContact": false,
  "isEnterprise": false,
  "isVerified": false,
  "id": {
    "server": "c.us",
    "user": "13105551234",
    "_serialized": "[email protected]"
  },
  "businessProfile": {
    "categories": [{ "id": "...", "localized_display_name": "Otra categoría" }],
    "memberSinceText": "Se unió en abril, 2024.",
    "isProfileLocked": true
  },
  "profilePic": { "success": false, "image_status": "item-not-found" },
  "date": "2026-04-10T17:30:33.356Z",
  "cached": true
}

Anotações dos testes em ambiente real:

• profilePic é um OBJETO, não uma URL. Quando uma imagem existe, busque o binário através de /picture/{number}; quando ausente, você obtém { success: false, image_status: "item-not-found" }.
• "about" é nulo quando restrito.
• isWAContact é o indicador padrão que indica se um número está no WhatsApp.
• As falhas de pesquisa ainda retornam um WhatsAppEntry — verifique os campos de erro/existência, não apenas o status HTTP.

Etapa 4 — Lidar com erros

Erros de limite de requisição e de autenticação retornam um corpo curto:

{ "error": "Requests must be at least 0.5 seconds apart" }

Intervalo padrão: pelo menos 500 ms entre as requisições (2 requisições/seg). Nível MEGA: 250 ms (4 requisições/seg). Referência completa de erros.

Sinalizadores de consulta opcionais em /number/{number}

Próximos passos