Быстрый старт — Первый поиск профиля за 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 — Обработка ошибок
При возникновении ошибок, связанных с ограничением объема передаваемых данных и аутентификацией, возвращается короткий текст сообщения:
{ "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 | Создание отчета по OSINT с использованием ИИ (более длительное время ответа). |
Следующие шаги
Что говорят наши пользователи
Настоящие отзывы от наших довольных клиентов