Límites de uso y cuotas — API de perfil de WhatsApp

Cuota mensual por nivel

Límites de ráfaga/por segundo

Un límite de ráfaga por nivel evita el abuso desde una sola clave:

Los clientes de MEGA que necesiten picos de demanda sostenidos más altos pueden solicitar un límite personalizado a través del gestor de cuentas dedicado.

Encabezados de limitación de velocidad

Cada respuesta incluye encabezados en minúsculas (convención de RapidAPI) para el seguimiento de la cuota mensual:

x-ratelimit-requests-limit:     60000
x-ratelimit-requests-remaining: 59999
x-ratelimit-requests-reset:     2591983   # seconds until reset

429 Demasiadas peticiones

La violación del límite de ráfaga (solicitudes demasiado cercanas entre sí) devuelve HTTP 429 con un breve cuerpo de error:

HTTP/1.1 429 Too Many Requests

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

La indicación de intervalo de 0,5 segundos refleja el valor predeterminado de minIntervalSeconds en la mayoría de los planes (= 2 solicitudes/segundo). Consulte /api-key-stats → roleInfo.minIntervalSeconds para conocer el valor exacto de su plan.

Comprueba tu propia cuota

El proxy expone GET /api-key-stats; llámelo en cualquier momento para leer el contador en tiempo real:

{
  "key": "08dc53d3-...",
  "role": "pro_60",
  "status": "active",
  "requestLimit": 60000,
  "requestRemaining": 59999,
  "requestReset": 2591982,
  "resetAt": "2026-05-27T02:24:56.708Z",
  "expiresAt": "2026-05-27T02:24:56.708Z",
  "lastUsedAt": "2026-04-27T02:25:12.955Z",
  "requestCountMonth": 1,
  "maxMonthlyUsage": 60000,
  "roleInfo": {
    "name": "pro_60",
    "maxMonthlyUsage": 60000,
    "minIntervalSeconds": 0.5
  }
}

Política de almacenamiento en caché

Los datos de perfil se almacenan en caché en el servidor. Las búsquedas repetidas del mismo número dentro del período de caché se realizan desde la caché. Para forzar una nueva búsqueda, agregue ?forceBypassCache=1 a /number/{number}; la nueva solicitud seguirá contando para la cuota.

Relacionado