Contrasta una dirección con su código postal
Detecta que una dirección y un código postal no coinciden antes de enviar un pedido, resolviendo cada uno por separado y comparando lo que realmente indican.
Controla el uso de tu clave antes de alcanzar un límite
Enterarte de que estás cerca de tu límite diario porque acaban de rechazar una solicitud es la forma menos útil de enterarte. Cada respuesta ya incluye los números necesarios para verlo venir.
Las cabeceras que hay que vigilar
X-Quota-Limit: 2500
X-Quota-Used: 2210
X-Quota-Free-Remaining: 290
X-Quota-Network-Used: 2210
X-Credits-Remaining: 5.75
X-Key-IPs-Used: 2
X-Key-IPs-Limit: 3
X-Quota-Reset: 2026-09-22T00:00:00ZQue X-Quota-Free-Remaining vaya bajando hacia cero es tu señal temprana más clara para la cuota diaria gratuita. X-Credits-Remaining te indica cuánto margen te queda una vez superada la cuota gratuita, cuando ya estás tirando del crédito prepago a 0,0001 € por solicitud.
Define tu propio umbral de alerta
En lugar de esperar a un 429, registra o lanza una alerta en cuanto X-Quota-Free-Remaining baje de un umbral que tú elijas, por ejemplo el 10 por ciento de X-Quota-Limit, para tener tiempo de reaccionar, ya sea ralentizando un trabajo por lotes, recargando crédito o simplemente contando con un periodo de calma hasta X-Quota-Reset.
Vigila también los espacios de IP de la clave
X-Key-IPs-Used y X-Key-IPs-Limit registran cuántas direcciones de origen distintas han usado una clave determinada dentro de su asignación rotativa de espacios de IP. Una clave que de repente se usa desde más direcciones de lo esperado y se acerca a su límite merece una investigación por sí misma, al margen del volumen de solicitudes, ya que puede indicar que la clave se está compartiendo más de lo previsto.
Crea un panel sencillo
Un pequeño script que registre estas cabeceras en una muestra de solicitudes, o en todas si el volumen es lo bastante bajo, te da una tendencia de uso a lo largo del tiempo sin necesidad de una llamada de supervisión aparte, ya que los números llegan en respuestas que ya estabas recibiendo. Representar X-Quota-Used frente al tiempo a lo largo de un día o una semana muestra patrones de uso que una sola instantánea nunca mostraría.
Actúa antes de chocar con el límite
Cuando veas un patrón constante de uso cercano a tu límite, los dos caminos posibles son las mismas dos opciones disponibles en cualquier momento: añadir crédito prepago para los excesos ocasionales, o pasar a una clave Unlimited a 50 € al mes si superas de forma constante la cuota gratuita. Cualquiera de las dos decisiones es más fácil de tomar con calma y con antelación que como respuesta a un 429 en directo que bloquea tráfico real.
Leer las cabeceras de cuota como telemetría rutinaria, y no solo como algo que revisar cuando falla una solicitud, convierte un límite estricto en una tendencia manejable. La cuota actual y las opciones de crédito están en la página de precios, y las definiciones completas de las cabeceras están en la documentación de límites de frecuencia.