Inicio rápido: primera consulta de perfil en 10 minutos.

Paso 1: Obtén una clave API.

Dos canales: elige uno. Mismo JSON, mismos puntos finales, diferente fuente de clave y URL base:

Una clave directa NO funcionará con la URL base de RapidAPI, y viceversa. El nombre del encabezado x-rapidapi-key se reutiliza en ambos para garantizar la compatibilidad; lo que importa es el origen del valor.

Paso 2: Haz tu primera solicitud

Proxy directo (recomendado):

curl -H "x-rapidapi-key: YOUR_DIRECT_KEY" \
  "https://whatsapp-proxy.checkleaked.cc/number/13105551234"

Mercado de 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"

Paso 3: Lea la respuesta.

La respuesta es un documento WhatsAppEntry (formato en vivo: se han eliminado los campos adicionales):

{
  "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
}

Notas de las pruebas en vivo:

• profilePic es un OBJETO, no una URL. Si existe una imagen, obtenga el binario a través de /picture/{number}; si no existe, obtendrá { success: false, image_status: "item-not-found" }.
• "Acerca de" es nulo cuando está restringido.
• isWAContact es el indicador canónico de "¿este número está en WhatsApp?".
• Las búsquedas fallidas aún devuelven un WhatsAppEntry; compruebe los campos de error/existencia, no solo el estado HTTP.

Paso 4: Gestionar errores

Los errores de límite de ráfaga y de autenticación devuelven un cuerpo corto:

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

Ritmo predeterminado: al menos 500 ms entre solicitudes (2 solicitudes/seg). Nivel MEGA: 250 ms (4 solicitudes/seg). Referencia completa de errores.

Indicadores de consulta opcionales en /number/{number}

Próximos pasos