Szybki start — pierwsze wyszukiwanie profilu w 10 minut
Cel: wysłanie pojedynczego uwierzytelnionego żądania HTTP do interfejsu API danych WhatsApp i odczytanie publicznego profilu numeru telefonu. Nie jest wymagana instalacja pakietu SDK — działa w dowolnym języku z klientem HTTP.
Krok 1 — Uzyskaj klucz API
Dwa kanały — wybierz jeden. Ten sam JSON, te same punkty końcowe, różne źródła kluczy i adresy URL bazowe:
| Kanał | Podstawowy adres URL | Źródło kluczowe | Wymagane nagłówki |
|---|---|---|---|
| Bezpośredni serwer proxy | https://whatsapp-proxy.checkleaked.cc | Zakup bezpośredni. Klucz zarządzany w naszym panelu. | x-rapidapi-key: <direct-key> |
| Rynek RapidAPI | https://whatsapp-data1.p.rapidapi.com | Panel RapidAPI → „Aplikacje” → Bezpieczeństwo. Subskrybuj na liście RapidAPI. | x-rapidapi-key: <rapidapi-key>x-rapidapi-host: whatsapp-data1.p.rapidapi.com |
Klucz bezpośredni NIE będzie działał z bazowym adresem URL RapidAPI i odwrotnie. Nazwa nagłówka x-rapidapi-key jest ponownie używana w obu przypadkach w celu zapewnienia zgodności — liczy się źródło wartości.
Krok 2 — Złóż swoje pierwsze żądanie
Bezpośredni serwer proxy (zalecane):
curl -H "x-rapidapi-key: YOUR_DIRECT_KEY" \ "https://whatsapp-proxy.checkleaked.cc/number/13105551234"
Rynek 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"
Krok 3 — Przeczytaj odpowiedź
Odpowiedź jest dokumentem WhatsAppEntry (kształt na żywo — pola dodatkowe przycięte):
{
"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
}Notatki z testów na żywo:
- profilePic to OBIEKT, a nie adres URL. Jeśli zdjęcie istnieje, pobierz plik binarny za pomocą /picture/{number}; jeśli brakuje, otrzymasz { success: false, image_status: "item-not-found" }.
- about ma wartość null, gdy jest ograniczony.
- isWAContact to kanoniczna flaga „czy ten numer jest na WhatsAppie”.
- Błędy w wyszukiwaniu nadal zwracają WhatsAppEntry — sprawdź pola błędu/istnienia, a nie tylko status HTTP.
Krok 4 — Obsługa błędów
Błędy limitu serii i uwierzytelniania zwracają krótką treść:
{ "error": "Requests must be at least 0.5 seconds apart" }Domyślne tempo: co najmniej 500 ms między żądaniami (2 żądania/sek.). Warstwa MEGA: 250 ms (4 żądania/sek.). Pełna lista błędów.
Opcjonalne flagi zapytania w /number/{number}
| Flaga | Efekt |
|---|---|
telegram=1 | Dołącz dane rejestracyjne Telegramu. |
lookup=1 | Uwzględnij wyszukiwanie TrueCaller. |
google=1 | Dołącz fragmenty wyszukiwania Google. |
includeCarrier=1 | Uwzględnij dane dotyczące operatora/regionu. |
ignoreProfilePic=1 | Pomiń pobieranie zdjęcia profilowego (szybciej). |
forceBypassCache=1 | Wymuś nowe wyszukiwanie (traktowane jako żądanie). |
fullAiReport=1 | Generuj raport AI OSINT (dłuższy czas reakcji). |
Następne kroki
Co mówią nasi użytkownicy
Prawdziwe opinie od naszych zadowolonych klientów