Conceptos básicos

Límites de uso

Cada clave puede hacer 120 solicitudes por minuto, y cada respuesta indica cuántas quedan.

Límites

Límite	Se aplica a
120 solicitudes por minuto	Cada clave API, en todos los endpoints. Es una ventana fija que empieza al inicio de cada minuto.
10 exportaciones por hora	Cada cuenta, en Crear una exportación. Al superarlo, 429 `export_rate_limit_exceeded`.
10 DM por minuto	Cada cuenta de X, en Enviar un mensaje. Al superarlo, 429 `dm_rate_limited`.
300 DM al día	Cada cuenta de X, por día UTC, o menos si X fija una cuota más baja. Al superarlo, 429 `dm_daily_limit`.
5 intentos de código por hora	Cada cuenta, en Definir el código de X Chat. Al superarlo, 429 `passcode_rate_limited`.
6 mensajes a Julien AI por minuto	Cada cuenta de X, en Enviar un mensaje y la herramienta MCP `ask_julien_ai`. Al superarlo, 429 `assistant_rate_limited`.
100 mensajes a Julien AI al día	Cada cuenta de X, por día UTC. Al superarlo, 429 `assistant_daily_limit`.
Un solo mensaje a Julien AI a la vez	Cada chat, y 3 chats a la vez por cuenta de X. Al superarlo, 409 `assistant_busy`.

Encabezados de límite de uso

Cada respuesta indica el estado de la ventana de la clave.

Encabezado	Significado
`RateLimit-Limit`	Solicitudes permitidas en una ventana, `120`.
`RateLimit-Remaining`	Solicitudes que quedan en la ventana actual.
`RateLimit-Reset`	Segundos hasta que la ventana vuelva a empezar.
`Retry-After`	Solo en un 429, segundos que hay que esperar antes de reintentar.

Encabezados

HTTP/1.1 429 Too Many Requests
Content-Type: application/json
RateLimit-Limit: 120
RateLimit-Remaining: 0
RateLimit-Reset: 17
Retry-After: 17
Request-Id: req_3Vb8YzC1dF6hJ0sW

Respuesta429

{
  "error": {
    "type": "rate_limit_error",
    "code": "rate_limit_exceeded",
    "message": "Too many requests. This key can make 120 requests a minute.",
    "param": null,
    "request_id": "req_3Vb8YzC1dF6hJ0sW",
    "doc_url": "https://gemlead.ai/docs/errors#rate_limit_exceeded"
  }
}

Gestiona un 429

Espera Retry-After segundos y vuelve a enviar la misma solicitud.

Reparte los trabajos grandes en el tiempo en lugar de enviarlos en ráfagas.
Lee RateLimit-Remaining para frenar antes de llegar a cero.
Para obtener muchos leads de una vez, una exportación es mejor que cientos de páginas.
Los webhooks te envían los eventos, así no gastas solicitudes en polling para buscar leads nuevos.

# curl waits for Retry-After, then tries again
curl --retry 5 https://gemlead.ai/api/v1/leads \
  -H "Authorization: Bearer $GEMLEAD_API_KEY"