Швидкий старт — перший пошук профілю за 10 хвилин
Мета: зробити один автентифікований HTTP-запит до WhatsApp Data API та зчитати публічний профіль номера телефону. Встановлення SDK не потрібне — працює з будь-якою мовою програмування з HTTP-клієнтом.
Крок 1 — Отримайте ключ API
Два канали — виберіть один. Той самий JSON, ті самі кінцеві точки, різне джерело ключа та базова URL-адреса:
| Канал | Базова URL-адреса | Ключове джерело | Обов'язкові заголовки |
|---|---|---|---|
| Прямий проксі | https://whatsapp-proxy.checkleaked.cc | Пряма покупка. Керування ключами здійснюється на нашій інформаційній панелі. | x-rapidapi-key: <direct-key> |
| Торговий майданчик RapidAPI | https://whatsapp-data1.p.rapidapi.com | Панель керування RapidAPI → "Програми" → Безпека. Підпишіться на сторінку RapidAPI. | x-rapidapi-key: <rapidapi-key>x-rapidapi-host: whatsapp-data1.p.rapidapi.com |
Прямий ключ НЕ працюватиме з базовою URL-адресою RapidAPI і навпаки. Назва заголовка x-rapidapi-key повторно використовується в обох випадках для сумісності — важливе джерело значення.
Крок 2 — Зробіть свій перший запит
Прямий проксі (рекомендовано):
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"
Крок 3 — Прочитайте відповідь
Відповідь – це документ 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 дорівнює null, коли воно обмежене.
- isWAContact – це канонічний прапорець «чи є цей номер у WhatsApp».
- Промахи пошуку все одно повертають WhatsAppEntry — перевірте поля помилок / існування, а не лише статус HTTP.
Крок 4 — Обробка помилок
Помилки Burst-limit та автентифікації повертають короткий текст:
{ "error": "Requests must be at least 0.5 seconds apart" }Темп виконання за замовчуванням: щонайменше 500 мс між запитами (2 запити/сек). Рівень MEGA: 250 мс (4 запити/сек). Повний довідник помилок.
Додаткові прапорці запиту для /number/{number}
| Прапор | Ефект |
|---|---|
telegram=1 | Включити дані реєстрації Telegram. |
lookup=1 | Включити пошук TrueCaller. |
google=1 | Включіть фрагменти пошуку Google. |
includeCarrier=1 | Включити дані про оператора/регіон. |
ignoreProfilePic=1 | Пропустити отримання зображення профілю (швидше). |
forceBypassCache=1 | Примусово виконати новий пошук (вважається запитом). |
fullAiReport=1 | Генерація звіту AI OSINT (довший час реагування). |
Наступні кроки
Що кажуть наші користувачі
Реальні відгуки від наших задоволених клієнтів