شروع سریع - اولین جستجوی پروفایل در 10 دقیقه

مرحله ۱ - دریافت کلید API

دو کانال - یکی را انتخاب کنید. JSON یکسان، نقاط پایانی یکسان، منبع کلید متفاوت و URL پایه متفاوت:

یک کلید مستقیم در برابر URL پایه RapidAPI کار نمی‌کند و برعکس. نام هدر x-rapidapi-key برای compat در هر دو مورد استفاده مجدد شده است - منبع مقدار مهم است.

مرحله ۲ - اولین درخواست خود را مطرح کنید

پروکسی مستقیم (توصیه می‌شود):

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

بازار 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"

مرحله ۳ - پاسخ را بخوانید

پاسخ یک سند WhatsAppEntry است (شکل زنده - فیلدهای اضافی حذف شده‌اند):

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

یادداشت‌هایی از آزمایش زنده:

• profilePic یک شیء است، نه یک URL. وقتی تصویری وجود دارد، فایل باینری را از طریق /picture/{number} دریافت کنید؛ در صورت عدم وجود، { success: false, image_status: "item-not-found" } را دریافت می‌کنید.
• وقتی محدود شود، مقدار about تهی می‌شود.
• isWAContact علامت متعارف «آیا این شماره در واتس‌اپ است» است.
• خطاهای جستجو هنوز هم یک WhatsAppEntry برمی‌گردانند - فیلدهای خطا / وجود را بررسی کنید، نه فقط وضعیت HTTP.

مرحله ۴ - مدیریت خطاها

خطاهای Burst-limit و Authentication یک بدنه کوتاه برمی‌گردانند:

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

سرعت پیش‌فرض: حداقل ۵۰۰ میلی‌ثانیه بین درخواست‌ها (۲ req/sec). سطح MEGA: ۲۵۰ میلی‌ثانیه (۴ req/sec). مرجع کامل خطا.

پرچم‌های پرس‌وجوی اختیاری روی ‎/number/{number}‎

مراحل بعدی