빠른 시작 — 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.comRapidAPI 대시보드 → "앱" → 보안. 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=1TrueCaller 조회 기능을 포함하세요.
google=1구글 검색 결과 요약을 포함하세요.
includeCarrier=1통신사/지역 정보를 포함하세요.
ignoreProfilePic=1프로필 사진 가져오기를 건너뛰세요(더 빠릅니다).
forceBypassCache=1강제로 새 조회를 수행합니다(요청으로 간주됩니다).
fullAiReport=1AI OSINT 보고서 생성 (응답 시간 더 오래 걸림).

다음 단계

사용자 리뷰

만족한 고객들의 실제 리뷰

4.5/5 (162 리뷰)