API de datos
Servicios · API
Las mismas series y los mismos lugares que publica el tablero, en JSON o CSV, para leerlos desde un programa, una hoja de cálculo o un tablero propio. Cada consulta cuenta una vez contra el cupo mensual del plan.
Authorization: Bearer obs_live_…. Sin ese encabezado la respuesta es 401.La llave identifica a la cuenta, no a una persona: no debe ir en una página web pública ni en un repositorio. Si se filtra, se revoca en /cuenta y se crea otra.
Cada consulta respondida cuenta una vez, sea cual sea el tamaño de la página. El cupo vuelve a cero el primer día de cada mes, a medianoche UTC. Además, cada llave admite hasta 60 consultas por minuto.
| Plan | Consultas por mes | Llaves |
|---|---|---|
| Analista | 10.000 | 1 |
| Profesional | 100.000 | 3 |
| Institucional | 1.000.000 | 10 |
| Parámetro | Qué hace |
|---|---|
X-Cupo-Limite | Consultas por mes del plan. |
X-Cupo-Restante | Consultas que quedan este mes, ya descontada la actual. |
X-Cupo-Reinicio | Día en que el cupo vuelve a cero (AAAA-MM-DD). |
Todo error llega en JSON con un campo error que explica qué pasó, y con los mismos encabezados de cupo.
| Código | Cuándo | Qué hacer |
|---|---|---|
| 400 | Un parámetro no es válido: un pageSize fuera de 1 a 5.000, una fecha mal escrita, un cursor ajeno o un código de serie que no existe. | Corregir el pedido. El campo «error» dice cuál. |
| 401 | Falta el encabezado Authorization, la llave no tiene la forma obs_live_… o fue revocada. | Revisar la llave en /cuenta o crear una nueva. |
| 402 | El plan de la cuenta venció o no incluye la API. | Renovar o cambiar de plan en Servicios. |
| 429 | Se agotó el cupo del mes, o la llave pasó de 60 consultas por minuto. | Esperar los segundos que indica Retry-After. |
| 503 | El servicio de cuentas o la base de datos no respondieron a tiempo. | Reintentar en unos segundos; no cuenta como un error de la llave. |
Las respuestas tienen siempre la misma forma: { data: [...], siguiente, fuente, actualizado }. Mientras siguiente traiga un valor, hay otra página: se pide la misma dirección con cursor= ese valor. En la última página, siguiente es null. Cada página es una consulta.
| Parámetro | Qué hace |
|---|---|
pageSize | Filas por página, de 1 a 5.000. Por omisión, 1.000. |
cursor | El valor de «siguiente» de la página anterior. |
formato | «json» (por omisión) o «csv». El CSV va en UTF-8 con BOM y el cursor de la página siguiente llega en el encabezado X-Siguiente. |
/api/v1/usoEl plan de la llave, el cupo del mes, cuántas consultas lleva y cuántas le quedan. Esta consulta también cuenta, y la cifra que devuelve ya la incluye.
{
"data": {
"plan": "analista",
"nombre": "Analista",
"estado": "ACTIVE",
"pagado_hasta": "2026-11-30",
"cupo_mensual": 10000,
"usadas": 1250,
"restantes": 8750,
"reinicio": "2026-11-01"
},
"siguiente": null,
"fuente": "DatosBolivia.com",
"actualizado": "2026-10-27T18:30:00.000Z"
}/api/v1/seriesEl catálogo de series: el dólar oficial y el paralelo, la UFV, las series anuales de Bolivia, el panel del Banco Mundial para Bolivia y, por separado, las estadísticas del Banco Central. Cada fila trae el codigo con que se piden sus observaciones.
| Parámetro | Qué hace |
|---|---|
fuente | «diario», «macro», «panel» o «bcb». Sin ella: diario, macro y panel. Las series del Banco Central se piden con fuente=bcb y llegan de a 40 por página. |
buscar | Palabras que tienen que aparecer en el código o el nombre. |
familia | Solo con fuente=bcb: la familia de cuadros del Banco Central. |
pageSize | Filas por página, de 1 a 5.000. Por omisión, 1.000. |
cursor | El valor de «siguiente» de la página anterior. |
formato | «json» (por omisión) o «csv». El CSV va en UTF-8 con BOM y el cursor de la página siguiente llega en el encabezado X-Siguiente. |
{
"data": [
{
"codigo": "diario.FX_OFFICIAL_USD_BOB",
"nombre": "Tipo de cambio oficial del dólar",
"fuente": "diario",
"rubro": "TIPO_DE_CAMBIO",
"unidad": "BOB/USD",
"frecuencia": "diaria",
"desde": "2008-11-03",
"hasta": "2026-10-27",
"observaciones": 4312,
"editor": "Banco Central de Bolivia"
}
],
"siguiente": "eyJvIjoxMDAwfQ",
"fuente": "DatosBolivia.com",
"actualizado": "2026-10-27T12:05:41.000Z"
}/api/v1/series/{codigo}Las observaciones de una serie, de la más vieja a la más nueva. Las diarias traen fecha; las anuales y las del Banco Central, periodo. Las series del dólar paralelo llevan el lado en el código (diario.FX_PARALLEL_USD_BOB:SELL); los dos puntos pueden ir tal cual o como %3A.
| Parámetro | Qué hace |
|---|---|
desde | AAAA, AAAA-MM o AAAA-MM-DD, inclusive. |
hasta | AAAA, AAAA-MM o AAAA-MM-DD, inclusive: hasta=2024 incluye el 31 de diciembre. |
pageSize | Filas por página, de 1 a 5.000. Por omisión, 1.000. |
cursor | El valor de «siguiente» de la página anterior. |
formato | «json» (por omisión) o «csv». El CSV va en UTF-8 con BOM y el cursor de la página siguiente llega en el encabezado X-Siguiente. |
{
"data": [
{
"fecha": "2026-01-02",
"valor": 6.96,
"unidad": "BOB/USD",
"agregacion": "POINT_IN_TIME",
"dispersion": null,
"plazas": null,
"variacion_pct": 0
}
],
"siguiente": null,
"fuente": "Banco Central de Bolivia",
"actualizado": "2026-10-27T12:05:41.000Z"
}/api/v1/lugaresLos lugares de una o varias ciudades, con la misma lectura que la descarga del mapa y sin el tope del plan gratuito. Van ordenados por ciudad, familia y nombre. Cada fila dice con qué confianza y por qué método se ubicó el punto.
| Parámetro | Qué hace |
|---|---|
ciudad | Obligatoria. Una o varias, separadas por coma, hasta 12. |
familia | Una o varias familias, separadas por coma. Sin ella, todas. |
pageSize | Filas por página, de 1 a 5.000. Por omisión, 1.000. |
cursor | El valor de «siguiente» de la página anterior. |
formato | «json» (por omisión) o «csv». El CSV va en UTF-8 con BOM y el cursor de la página siguiente llega en el encabezado X-Siguiente. |
{
"data": [
{
"id": "osm-node-123456",
"ciudad": "La Paz",
"nombre": "Farmacia Central",
"grupo": "Salud",
"familia": "Farmacias",
"barrio": "Sopocachi",
"direccion": "Av. 6 de Agosto",
"marca": null,
"latitud": -16.5101,
"longitud": -68.1253,
"actividad_regulada": true,
"registro_que_lo_confirmaria": "AGEMED",
"confianza": 0.9,
"grado_de_calidad": "A",
"metodo_de_ubicacion": "PUNTO"
}
],
"siguiente": "eyJvIjo1MDAwfQ",
"fuente": "DatosBolivia.com: catálogo de lugares (la confianza y el método van en cada fila)",
"actualizado": null
}/api/v1/prensaLas notas del archivo de prensa, de la más nueva a la más vieja, con el mismo recorte que el panel de Prensa. Cada fila trae el enlace a la nota original. Como la lectura no cuenta el total, una página llena trae siguiente aunque la próxima resulte vacía.
| Parámetro | Qué hace |
|---|---|
anio | Uno o varios años, separados por coma. |
tono | Uno o varios tonos, como en el panel de Prensa. |
tema | Uno o varios temas. |
region | Una o varias regiones. |
medio | Uno o varios medios. |
termino | Uno o varios términos vigilados. |
buscar | Texto que tiene que aparecer en la nota. |
pageSize | Filas por página, de 1 a 5.000. Por omisión, 1.000. |
cursor | El valor de «siguiente» de la página anterior. |
formato | «json» (por omisión) o «csv». El CSV va en UTF-8 con BOM y el cursor de la página siguiente llega en el encabezado X-Siguiente. |
/api/v1/empresasEl directorio de empresas que publica el tablero: un subconjunto público del registro del SEPREC, no la base completa del Registro de Comercio. Ordenado por departamento, municipio y nombre; actualizado es la fecha de corte.
| Parámetro | Qué hace |
|---|---|
departamento | Un departamento, como aparece en la tabla de Empresas. |
municipio | Un municipio. |
buscar | Texto en el nombre. |
pageSize | Filas por página, de 1 a 5.000. Por omisión, 1.000. |
cursor | El valor de «siguiente» de la página anterior. |
formato | «json» (por omisión) o «csv». El CSV va en UTF-8 con BOM y el cursor de la página siguiente llega en el encabezado X-Siguiente. |
/api/v1/aduanaLa base aduanera del INE sumada por una dimensión, con la misma lectura que «Detalle aduanero»: valor en dólares, peso y el valor del último año del tramo y del anterior. Como en el panel, el filtro de la misma dimensión no recorta su propio desglose, y una combinación que el INE no publica (importaciones por país y departamento a la vez) responde 400 con el motivo.
| Parámetro | Qué hace |
|---|---|
por | Obligatorio: year, month, section, chapter, heading, subheading, nandina, country, zone, department, activity, activityGroup, traditional, traditionalGroup, use, useGroup o kind. |
flujo | «X» exportaciones (por omisión) o «M» importaciones. |
desde, hasta | Años inicial y final, AAAA. |
meses | Tramo de meses de cada año, p. ej. 1-7 para comparar enero a julio. |
producto | Códigos NANDINA de 2 a 10 dígitos, separados por coma. |
pais, departamento | Códigos del INE, separados por coma. |
seccion, actividad, tradicional, uso, tipo | Los demás filtros del panel, por código. |
pageSize | Filas por página, de 1 a 5.000. Por omisión, 1.000. |
cursor | El valor de «siguiente» de la página anterior. |
formato | «json» (por omisión) o «csv». El CSV va en UTF-8 con BOM y el cursor de la página siguiente llega en el encabezado X-Siguiente. |
curl -H "Authorization: Bearer obs_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
"https://datosbolivia.com/api/v1/series/diario.FX_OFFICIAL_USD_BOB?desde=2026-01-01"
# La misma página en CSV
curl -H "Authorization: Bearer obs_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
"https://datosbolivia.com/api/v1/lugares?ciudad=La%20Paz&familia=Farmacias&formato=csv" -o lugares.csvimport requests
BASE = "https://datosbolivia.com/api/v1"
CABECERA = {"Authorization": "Bearer obs_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"}
def todas_las_filas(ruta, **parametros):
"""Recorre las páginas siguiendo «siguiente» hasta que llega null."""
filas = []
while True:
r = requests.get(f"{BASE}/{ruta}", headers=CABECERA, params=parametros, timeout=60)
r.raise_for_status()
cuerpo = r.json()
filas.extend(cuerpo["data"])
print("Quedan", r.headers.get("X-Cupo-Restante"), "consultas este mes")
if cuerpo["siguiente"] is None:
return filas
parametros["cursor"] = cuerpo["siguiente"]
lugares = todas_las_filas("lugares", ciudad="Santa Cruz de la Sierra", pageSize=5000)
print(len(lugares), "lugares")En Excel: Datos → Obtener datos → Desde otras fuentes → Consulta en blanco → Editor avanzado, y se pega el código. La primera vez, Excel pide el nivel de privacidad del origen; con «Anónimo» la llave viaja en el encabezado escrito en la consulta.
let
Llave = "obs_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
Leer = (cursor as nullable text) =>
let
Consulta = [ciudad = "Cochabamba", pageSize = "5000"]
& (if cursor = null then [] else [cursor = cursor]),
Respuesta = Json.Document(
Web.Contents("https://datosbolivia.com/api/v1/lugares", [
Query = Consulta,
Headers = [Authorization = "Bearer " & Llave]
])
)
in
Respuesta,
Paginas = List.Generate(
() => Leer(null),
each _ <> null,
each if _[siguiente] = null then null else Leer(_[siguiente]),
each _[data]
),
Filas = List.Combine(Paginas),
Tabla = Table.FromRecords(Filas)
in
TablaEl contrato completo, para generar un cliente o importarlo en Postman, está en /api/v1/openapi.json (OpenAPI 3.1).
El uso de los datos y de la API se rige por los términos de uso.