API de datos económicos de Uruguay
Todos los indicadores de datosUruguay en JSON. Sin registro, sin clave de API y sin límite de uso comercial: solo pedimos atribución.
Endpoints
31 series, todas GET y sin clave
La URL base es https://datosuruguay.com/api/v1. Clickeá cualquier endpoint para
ver su respuesta real.
Cotizaciones y unidades indexadas
Precios y tarifas
Índices y macro
Salarios, pasividades y mercado laboral
Compra y venta del BROU
snapshot, no serieNingún endpoint coincide con ese filtro. ¿Te falta un indicador que ya publicamos en el sitio? Escribinos.
Esta misma lista en JSON, con el fragmento de atribución de cada serie: https://datosuruguay.com/api/v1/indicators.
Límites de uso
Por dirección IP y compartidos entre todos los endpoints:
- 20 solicitudes cada 10 segundos
- 300 solicitudes cada hora
Si lo tocás, esperá los segundos que dice Retry-After en vez de
reintentar en bucle. Las respuestas se cachean 15 minutos y soportan
If-Modified-Since, así que un cliente que respeta el cache casi
nunca llega al límite.
Versionado
Tu cliente tiene que ignorar los campos que no conoce. Si tu parser explota ante un campo que no esperaba, cualquier cosa que agreguemos te rompe.
Podemos hacerlo sin avisar
- Agregar un campo a la respuesta.
- Agregar un endpoint o un indicador nuevo.
- Agregar un valor nuevo a un conjunto ya existente.
- Relajar una validación.
- Cambiar el orden de las claves del JSON.
Esto sería v2
- Borrar o renombrar un campo.
- Cambiar el tipo o el formato de un campo.
- Cambiar el significado de un valor.
- Cambiar un código HTTP o un
error.code. - Volver obligatorio un parámetro o cambiar el
limitpor defecto.
Cuando exista v2, las dos versiones van a convivir:
v1 va a responder los headers
Deprecation y Sunset
con una fecha antes de apagarse.
Licencia
Los datos están bajo Creative Commons Atribución 4.0
(CC-BY-4.0): usalos para lo que quieras,
incluso comercialmente, con un enlace visible a la página del indicador.
Cada respuesta trae el suyo armado en meta.attribution.
¿Solo querés mostrar el dato en tu sitio?
Entonces no necesitás la API: usá un widget embebible. Copiás un iframe, se actualiza solo y la atribución ya viene adentro.
Esta API es gratis, pero no es gratis de mantener
No hay clave de API, ni plan pago, ni límite de uso comercial. Lo que sí hay son servidores, scrapers que hay que arreglar cuando un organismo cambia su sitio, y horas. Si estás construyendo algo sobre estos datos y te sirve, una donación ayuda a que siga estando.
DonarPreguntas frecuentes sobre la API
Lo que suele preguntar quien está por construir algo sobre estos datos.
¿La API es gratis?
Sí, y sin asterisco: no hay plan pago, no hay cupo de consultas mensuales y no hay límite para el uso comercial. Lo único que pedimos es la atribución, que es la condición de la licencia CC-BY-4.0.
¿Necesito registrarme o pedir una clave de API?
No. No hay registro, ni token, ni header de autenticación. Un GET desde cualquier lado y listo.
¿Puedo usar los datos en una aplicación comercial?
Sí. La licencia CC-BY-4.0 permite el uso comercial, incluso vender un producto construido sobre estos datos, siempre que la atribución esté visible y enlazada. Los detalles están en la página de licencia.
¿Cada cuánto se actualizan los datos?
Depende del indicador, y cada uno lo declara: la cadencia del organismo emisor está en meta.frequency y la fecha del último dato en meta.last_updated. Las cotizaciones son diarias, los índices del INE son mensuales y los precios cambian cuando el organismo los cambia.
¿De dónde salen los datos?
De los organismos oficiales: BCU, INE, BPS, ANCAP, UTE y demás, según el indicador. El campo meta.source declara de dónde traemos esa serie en concreto, que es el lugar al que tenés que ir si querés contrastar el número.