Démarrage rapide — Première consultation de profil en 10 minutes

Étape 1 — Obtenir une clé API

Deux canaux — choisissez-en un. Même JSON, mêmes points de terminaison, source de clé et URL de base différentes :

Une clé directe ne fonctionnera PAS avec l'URL de base de RapidAPI, et inversement. L'en-tête x-rapidapi-key est réutilisé dans les deux cas pour des raisons de compatibilité ; seule la source de la valeur importe.

Étape 2 — Faites votre première demande

Proxy direct (recommandé) :

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

Place de marché 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"

Étape 3 — Lire la réponse

La réponse est un document WhatsAppEntry (forme dynamique — champs supplémentaires supprimés) :

{
  "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
}

Remarques issues des tests en conditions réelles :

• profilePic est un OBJET, pas une URL. Si une image existe, récupérez le fichier binaire via /picture/{number} ; sinon, vous obtiendrez { success: false, image_status: "item-not-found" }.
• La valeur de about est nulle lorsqu'elle est restreinte.
• isWAContact est le critère de référence pour savoir si un numéro est présent sur WhatsApp.
• Les résultats de recherche infructueux renvoient toujours un WhatsAppEntry — vérifiez les champs d'erreur/d'existence, et pas seulement le statut HTTP.

Étape 4 — Gérer les erreurs

Les erreurs de limite de rafale et d'authentification renvoient un corps court :

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

Rythme par défaut : au moins 500 ms entre les requêtes (2 req/s). Niveau MEGA : 250 ms (4 req/s). Référence complète des erreurs.

Indicateurs de requête optionnels sur /number/{number}

Prochaines étapes