cURL / Raw HTTP — WhatsApp Data API

Pick a channel

Direct proxy (uses your direct-purchase key):

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

RapidAPI marketplace (uses your RapidAPI key + host header):

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"'

Examples below use the direct proxy. For RapidAPI, append $WA_HOST_HEADER to each curl call.

Single profile lookup

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

Profile without picture (faster)

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

Simple existence check

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

Profile picture only (binary JPEG)

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

Bypass cache

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

Bulk check (POST)

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

Carrier lookup

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

RapidAPI variant (host header required)

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"

Inspect rate-limit headers

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

API key usage stats

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

Shell script: bulk check from a text file

#!/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

Related