cURL / HTTP bruto — API de dados do WhatsApp

Escolha um canal

Proxy direto (usa sua chave de compra direta):

export WA_KEY="YOUR_DIRECT_KEY"
export WA_BASE="https://whatsapp-proxy.checkleaked.cc"

Marketplace RapidAPI (usa sua chave RapidAPI + cabeçalho host):

export WA_KEY="YOUR_RAPIDAPI_KEY"
export WA_BASE="https://whatsapp-data1.p.rapidapi.com"
# Set this only when calling the RapidAPI base URL:
export WA_HOST_HEADER='-H "x-rapidapi-host: whatsapp-data1.p.rapidapi.com"'

Os exemplos abaixo usam o proxy direto. Para o RapidAPI, adicione `$WA_HOST_HEADER` a cada chamada curl.

Pesquisa de perfil único

curl -H "x-rapidapi-key: $WA_KEY" \
  "$WA_BASE/number/13105551234"

Perfil sem foto (mais rápido)

curl -H "x-rapidapi-key: $WA_KEY" \
  "$WA_BASE/number/no_picture/13105551234"

verificação de existência simples

curl -H "x-rapidapi-key: $WA_KEY" \
  "$WA_BASE/number-simple/13105551234"

Apenas foto de perfil (JPEG binário)

curl -H "x-rapidapi-key: $WA_KEY" \
  "$WA_BASE/picture/13105551234" -o profile.jpg

Ignorar cache

curl -H "x-rapidapi-key: $WA_KEY" \
  "$WA_BASE/number/13105551234?forceBypassCache=1"

Verificação em massa (POST)

curl -X POST "$WA_BASE/bulk_check" \
  -H "x-rapidapi-key: $WA_KEY" \
  -H "Content-Type: application/json" \
  -d '{"numbers":["13105551234","447911123456"]}'

Pesquisa de operadoras

curl -H "x-rapidapi-key: $WA_KEY" \
  "$WA_BASE/carrier/13105551234"

Variante RapidAPI (cabeçalho do host obrigatório)

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"

Inspecionar cabeçalhos de limite de taxa

curl -sD - -o /dev/null \
  -H "x-rapidapi-key: $WA_KEY" \
  "$WA_BASE/number/13105551234" \
  | grep -i -E "^x-ratelimit"

estatísticas de uso da chave de API

curl -H "x-rapidapi-key: $WA_KEY" \
  "$WA_BASE/api-key-stats"

Script Shell: verificação em massa a partir de um arquivo de texto

#!/usr/bin/env bash
set -euo pipefail

while IFS= read -r number; do
  [[ -z "$number" ]] && continue
  curl -s -H "x-rapidapi-key: $WA_KEY" \
    "$WA_BASE/number/no_picture/$number" \
    | jq -r '[.number, .isWAContact, .isBusiness] | @csv'
  sleep 0.5  # 2 req/sec — respect tier burst limit
done < numbers.txt > results.csv

Relacionado