Los límites de frecuencia tienen fama de ser confusos, llenos de excepciones y letra pequeña que solo queda clara cuando algo falla. Los nuestros son más sencillos y vale la pena exponerlos con claridad en un solo lugar.
Cada dirección tiene 2.500 solicitudes gratuitas al día sin ninguna clave. Esa cuota no es individual por dirección, sino que se comparte en toda una red: todas las direcciones IPv4 del mismo /24 y todas las direcciones IPv6 del mismo /48 consumen de un mismo fondo común. Esto importa si estás detrás de una conexión de oficina compartida o de una gran configuración de traducción de direcciones de red, ya que tu cuota gratuita se comparte con todos los demás en ese mismo segmento de red, usen o no una clave.
Cada clave tiene además su propia cuota diaria gratuita de 2.500 solicitudes, independiente de la que ya ofrece la red. La cuota de una clave no se reduce por otro tráfico de la misma red, y la cuota de una red no se reduce por el tráfico que ya agotó la cuota propia de una clave. Las dos cuotas conviven una junto a otra en lugar de competir entre sí.
Una vez superadas ambas cuotas en un día determinado, una solicitud consume crédito prepago a 0,0001 € por solicitud o queda cubierta por un paquete Unlimited a 50 € al mes, según lo que tenga configurado la cuenta. No hay ninguna limitación que ralentice las solicitudes en silencio ni ningún bloqueo sorpresa sin explicación. Cada respuesta incluye cabeceras de cuota (X-Quota-Limit, X-Quota-Used, X-Quota-Free-Remaining, X-Quota-Network-Used, X-Credits-Remaining, X-Key-IPs-Used, X-Key-IPs-Limit y X-Quota-Reset), así que la situación exacta de una solicitud es visible antes de que llegue a fallar.
Una llamada masiva o por lotes sigue las mismas reglas a nivel de elemento, no de llamada. Cien direcciones enviadas en una sola llamada cuentan como cien solicitudes contra la cuota que corresponda, exactamente igual que si se hubieran enviado en cien llamadas separadas.
Todo esto se aplica de forma idéntica en todos los endpoints y en cada uno de los diecisiete hosts de compatibilidad. Una solicitud con el formato de OpenCage o ipstack está sujeta exactamente a las mismas reglas de límite de frecuencia que una solicitud directa a /v1/forward o /v1/ip, sin ningún límite aparte y más estricto escondido detrás de un formato de respuesta familiar.
Todos los detalles, incluido cómo funciona el reinicio diario y qué significa cada cabecera, están documentados en /docs/rate-limits/. Si alguna vez surge una duda sobre límites de frecuencia en tu integración, la respuesta casi siempre está a la vista en las cabeceras de la respuesta que la provocó.