빠른 시작 — 10분 안에 첫 프로필 조회 완료
목표: WhatsApp 데이터 API에 인증된 HTTP 요청을 한 번 보내고 전화번호의 공개 프로필 정보를 읽어오는 것입니다. 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 |
직접 키는 RapidAPI 기본 URL에 대해 작동하지 않으며, 그 반대의 경우도 마찬가지입니다. 호환성을 위해 헤더 이름 '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" }기본 응답 간격: 요청 간 최소 500ms(초당 2회 요청). MEGA 등급: 250ms(초당 4회 요청). 전체 오류 참조.
/number/{number}에 대한 선택적 쿼리 플래그
| 깃발 | 효과 |
|---|---|
telegram=1 | 텔레그램 가입 정보를 포함하세요. |
lookup=1 | TrueCaller 조회 기능을 포함하세요. |
google=1 | 구글 검색 결과 요약을 포함하세요. |
includeCarrier=1 | 통신사/지역 정보를 포함하세요. |
ignoreProfilePic=1 | 프로필 사진 가져오기를 건너뛰세요(더 빠릅니다). |
forceBypassCache=1 | 강제로 새 조회를 수행합니다(요청으로 간주됩니다). |
fullAiReport=1 | AI OSINT 보고서 생성 (응답 시간 더 오래 걸림). |
다음 단계
직접 결제와 RapidAPI를 통한 비용 비교: 직접 결제와 RapidAPI 비교 항목을 참조하세요.
사용자 리뷰
만족한 고객들의 실제 리뷰
4.5/5 (162 리뷰)