クイックスタート — 10分で最初のプロフィール検索

ステップ1 — APIキーを取得する

2つのチャネルのうち、どちらか1つを選択してください。JSON形式、エンドポイントは同じですが、キーソースとベースURLが異なります。

直接キーを使用しても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" }

デフォルトのペース設定：リクエスト間隔は最低500ミリ秒（2リクエスト/秒）。MEGAティア：250ミリ秒（4リクエスト/秒）。エラーの詳細はこちらをご覧ください。

/number/{number} のオプションのクエリフラグ

次のステップ