Hướng dẫn nhanh — Tra cứu hồ sơ lần đầu chỉ trong 10 phút

Bước 1 — Lấy khóa API

Hai kênh — hãy chọn một. Cùng một định dạng JSON, cùng các điểm cuối, nhưng nguồn khóa và URL cơ sở khác nhau:

Khóa trực tiếp sẽ KHÔNG hoạt động với URL cơ sở của RapidAPI và ngược lại. Tên tiêu đề x-rapidapi-key được sử dụng lại ở cả hai để đảm bảo tính tương thích — nguồn giá trị mới là điều quan trọng.

Bước 2 — Đưa ra yêu cầu đầu tiên của bạn

Proxy trực tiếp (khuyến nghị):

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

Sàn giao dịch 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"

Bước 3 — Đọc câu trả lời

Phản hồi là một tài liệu WhatsAppEntry (dạng trực tiếp — các trường bổ sung đã được lược bỏ):

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

Ghi chú từ quá trình thử nghiệm thực tế:

• profilePic là một ĐỐI TƯỢNG, không phải là một URL. Khi ảnh tồn tại, hãy lấy dữ liệu nhị phân thông qua /picture/{number}; khi thiếu, bạn sẽ nhận được { success: false, image_status: "item-not-found" }.
• Giá trị của "about" là null khi bị hạn chế.
• isWAContact là cờ chuẩn để hỏi "số điện thoại này có đang sử dụng WhatsApp không?".
• Lỗi tìm kiếm vẫn trả về một WhatsAppEntry — hãy kiểm tra các trường lỗi/tồn tại, chứ không chỉ trạng thái HTTP.

Bước 4 — Xử lý lỗi

Lỗi giới hạn dung lượng và lỗi xác thực trả về một nội dung ngắn:

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

Tốc độ mặc định: tối thiểu 500 ms giữa các yêu cầu (2 yêu cầu/giây). Cấp độ MEGA: 250 ms (4 yêu cầu/giây). Tham khảo đầy đủ thông tin lỗi.

Các cờ truy vấn tùy chọn trên /number/{number}

Các bước tiếp theo