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 Data API

การตอบกลับข้อผิดพลาดทั้งหมดจะใช้รูปแบบเดียวกัน: สถานะ HTTP + ข้อความแสดงข้อผิดพลาด + รหัสตัวเลข + เวลาที่เกิดข้อผิดพลาด

รูปทรงซองจดหมาย (ที่สังเกตได้)

พร็อกซีจะส่งคืนข้อมูลในสองรูปแบบ ขึ้นอยู่กับโหมดความล้มเหลว:

ข้อผิดพลาดเล็กน้อย (การตรวจสอบสิทธิ์ / ขีดจำกัดการใช้งาน / การตรวจสอบความถูกต้อง):

{ "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 ทั่วไป

ทศนิยม	ความหมาย	การกระทำ
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} หมายเลขที่ไม่รู้จักยังคงส่งคืน WhatsAppEntry ที่มี isWAContact: false — ตรวจสอบเนื้อหา ไม่ใช่สถานะ
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 จากต้นทางได้ หรือมีการจำกัดอัตราการให้บริการจากต้นทาง	ลองใหม่โดยใช้ backoff ตรวจสอบที่ /api-status
504	การค้นหาข้อมูลต้นทางหมดเวลา	ลองใหม่อีกครั้ง ลองใช้ /number/no_picture/{number} เพื่อการตอบสนองที่เร็วขึ้น

กลยุทธ์การลองใหม่

ลองใหม่อีกครั้ง: 429 (พร้อมตัวเลือก Retry-After), 500, 502, 503, 504
อย่าลองใหม่: 400, 401, 403, 404
การหน่วงเวลา: เพิ่มขึ้นแบบทวีคูณตามความผันผวน จำกัดไว้ที่ 5 ครั้ง ต้องปฏิบัติตามการตั้งค่า "ลองใหม่หลังจาก" เสมอ

ตัวอย่าง 429 เนื้อหา

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

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

ที่เกี่ยวข้อง

ข้อจำกัดอัตรา

ตัวอย่างการลองใหม่ในภาษา Python

ตัวอย่างการลองใหม่ใน Node.js

สถานะ API สด

เอกสารอ้างอิง API แบบโต้ตอบ (สเกลาร์)