How much does the WhatsApp Profile API cost?

There are four tiers: BASIC is free with 50 requests/month, PRO is $35/month for 10,000 requests, ULTRA is $150/month for 50,000 requests, and MEGA is $500/month for 500,000 requests. Pay-As-You-Go credits are also available from $82.95 per 50,000 requests with crypto or $105 via PayPal.

What information does the API return?

The API returns whether a number is registered on WhatsApp, the public profile picture URL, the display name, the about/status text, and flags for WhatsApp Business and Enterprise accounts. Fields return null when the target user has restricted visibility in their WhatsApp privacy settings.

Does the lookup notify the target WhatsApp account?

No. The lookup is silent. It does not trigger the 'online' status, blue ticks, or any notification. It performs a directory-level existence query plus a read of public profile data the target has chosen to expose.

Can I access the API through RapidAPI or Apify?

Yes. The same JSON response is available on three channels: direct purchase (lowest per-request price), RapidAPI marketplace (fastest setup), and Apify Actor (no-code friendly). Direct purchase typically saves ~20% versus the equivalent RapidAPI-channel usage.

エラーコード — WhatsAppデータAPI

すべてのエラー応答は、HTTPステータス + エラーメッセージ + 数値コード + タイムスタンプという同じ形式に従います。

封筒の形状（観測値）

プロキシは、障害モードに応じて2つの形状のうちいずれか1つを返します。

短いエラー（認証／バースト制限／検証）：

{ "error": "Requests must be at least 0.5 seconds apart" }

詳細エラー（/number/no_picture/{n}、/number-simple/{n} のルックアップミス）— 本文は追加フィールドを持つ WhatsAppEntry として解析されます。

{
  "number": "13105551234",
  "isWAContact": true,
  "error":  "Whatsapp number doesn't exist",
  "exists": false,
  "reason": "not_found",
  "status": 404,
  ...
}

200番台のレスポンスであっても、必ずエラーフィールドを確認してください（例：/number_cacheはエラーメッセージを含む200番台のレスポンスを返すことがあります）。

一般的なHTTPステータス

HTTP	意味	アクション
400	無効な電話番号です。^[0-9]+$ (数字のみ、+ は不要) と一致する必要があります。	送信前に数字以外の文字を削除してください。ローカル環境でlibphonenumberを使用して検証してください。
401	x-rapidapi-keyヘッダーが欠落しているか無効です。	ヘッダーに x-rapidapi-key と x-rapidapi-host: wp-data.p.rapidapi.com を追加します。
403	有効なプランが必要です。割り当て量が上限に達しているか、エンドポイントがご利用のティアに含まれていません。	RapidAPIのサブスクリプションを確認してください。プランのアップグレードまたは追加購入を行ってください。
404	エンドポイントまたはリソースが見つかりません。	URLパスを確認してください。/number/{number}の場合、不明な番号でもisWAContact: falseのWhatsAppEntryが返されます。ステータスではなく、本文を確認してください。
429	バースト制限 - リクエストの間隔が短すぎます。本文: {"error":"Requests must be at least 0.5 seconds apart"}。	リクエスト間隔は最低500ミリ秒（2リクエスト/秒）に設定してください。MEGAの場合は250ミリ秒（4リクエスト/秒）です。プランのペースを確認するには、/api-key-stats → roleInfo.minIntervalSeconds を参照してください。
500	サーバー側で予期せぬ障害が発生しました。	指数バックオフを使用して再試行します。問題が継続する場合は報告してください。
502 / 503	上流のWhatsAppディレクトリが利用できないか、上流側でサービス速度が制限されています。	バックオフ付きで再試行してください。/api-statusを確認してください。
504	上流の検索がタイムアウトしました。	もう一度お試しください。より速い応答を得るには、/number/no_picture/{number} をお試しください。

再試行戦略

再試行: 429 (Retry-After 付き)、500、502、503、504。
再試行しないでください: 400、401、403、404。
バックオフ：ジッターを伴う指数関数的。最大リトライ回数は5回。常にRetry-Afterを尊重する。

例429本文

HTTP/1.1 429 Too Many Requests
content-type: application/json

{ "error": "Requests must be at least 0.5 seconds apart" }

エラーコード — WhatsAppデータAPI

封筒の形状（観測値）

一般的なHTTPステータス

再試行戦略

例429本文

関連している

ユーザーの声

It works good but sometime it shows old…