Saltar al contenido principal

Cupos por organización

Los límites de tasa se aplican por organización, no por llave. Cada llave emitida para la misma organización comparte un cupo, así que agregar llaves no multiplica tu cuota. El límite por defecto es de 100 solicitudes por día por organización. Algunos endpoints tienen topes más estrictos. Por ejemplo, Web Search está limitado a 10 solicitudes por hora. La página de cada endpoint indica su límite. Las solicitudes en lote cuentan como una solicitud por elemento: un lote de 10 elementos consume 10 de tu cuota, igual que 10 llamadas individuales.

Cuota en los encabezados de respuesta

El estado del límite de tasa viene como encabezados HTTP en cada respuesta (no en el cuerpo):

Cuando excedes el límite

Las solicitudes que superan la cuota devuelven 429 con un sobre rate_limit_error y un encabezado Retry-After (segundos):
Espera (back off) hasta que transcurra Retry-After (o X-RateLimit-Reset), luego reintenta.
El limitador falla abierto: si el backend de límite de tasa no está disponible por un momento, las solicitudes se dejan pasar y no se emiten encabezados X-RateLimit-*. No dependas de que los encabezados estén siempre presentes.

Siguiente: Errores

El sobre de error y cada código de error.