Acceso a la API

Buscador de Series

Documentación

Ayuda y Soporte

Términos y Condiciones

Ayuda y Soporte

Central de soluciones: preguntas clave, errores comunes y contacto de soporte.

¿Qué debo hacer para acceder a la API BDE?

Para acceder a la API necesitas obtener tu API Key Token. Para ello debes tener una cuenta en la Base de Datos Estadísticos (BDE), habilitar el uso de la API y, una vez completados esos pasos, buscar tu token en "Mi Cuenta", en la sección "Apikey Token".

El acceso es inmediato y gratuito una vez que tengas tu cuenta BDE configurada correctamente. No es necesario realizar solicitudes formales, enviar certificaciones o documentos, firmar contratos específicos para el uso de la API ni esperar aprobaciones o procesos de validación externos antes de ocuparla.

Más detalles: Para una guía completa del proceso de registro y habilitación, consulta la sección Acceso a la API.

¿Cómo obtengo mi API Key Token?

El proceso general para obtener tu API Key Token es el siguiente:

Pasos para obtener tu API Key Token:

  1. Tener cuenta BDE: Si aún no tienes cuenta, créala primero en la BDE.
  2. Habilitar el uso de la API: Realiza la habilitación una única vez desde la página de acceso de la API.
  3. Ir a "Mi Cuenta": En la BDE, entra a la configuración de tu perfil.
  4. Buscar "Apikey Token": En esa sección encontrarás tu API Key Token personal para autenticarte en la API.

Importante: Desde la administración de "Apikey Token" también puedes copiar tu token, renovarlo o extender su fecha de expiración.

¿Qué pasa si mi API Key Token expira?

Tu API Key Token tiene una vigencia de 1 año, que comienza desde que habilitas el uso de la API. Una vez transcurrido ese período, el token deja de servir para consultar la API.

Si tu token ya expiró, puedes usar la opción "Renovar Token". Si tu token está próximo a vencer y deseas seguir usando el mismo, puedes usar "Extender fecha expiración".

Estas opciones están disponibles en la administración de "Apikey Token", dentro de "Mi Cuenta" en la BDE.

¿Puedo seguir ocupando mis credenciales de usuario y contraseña?

Sí. Tus credenciales de usuario y contraseña de la BDE seguirán funcionando en las distintas modalidades de la API para permitir la continuidad operacional de análisis y automatizaciones que ya tengan nuestros usuarios.

Aun así, recomendamos migrar al uso de API Key Token, ya que permite fortalecer la seguridad de la API BDE y de tus datos personales.

¿Cómo puedo usar la API?

La API BDE se puede utilizar de tres formas diferentes según tus necesidades técnicas y el lenguaje de programación que uses:

  • Librería Python: Instala paquetes como bcchapi que simplifican el acceso a los datos con funciones nativas de Python.
  • Servicio REST: Realiza peticiones HTTPS estándar. Compatible con cualquier lenguaje (JavaScript, Python, R, Java, etc.). Ideal para integraciones web y aplicaciones modernas.
  • Servicio SOAP: Crea un cliente SOAP para llamar métodos específicos. Especialmente útil en C# y .NET, pero compatible con otros lenguajes empresariales.

Detalles completos: Para ejemplos de código, parámetros y guías paso a paso, consulta la sección Documentación.

¿Dónde puedo ver ejemplos de uso de la API?

En la sección Documentación encontrarás ejemplos completos para cada tipo de uso:

  • Librería bcchapi: Documentación de uso y ejemplo aplicado en Python.
  • Webservices REST: Documentación de uso y ejemplo aplicado en R.
  • Webservices SOAP: Documentación de uso y ejemplo aplicado en C#.

Cada documentación explica paso a paso cómo usar el servicio y luego incluye un ejemplo práctico completo.

Catálogo de series: También está disponible el buscador de series para encontrar códigos de series.

¿Dónde puedo encontrar los códigos para el IPC, el USD, la UF, la UTM, etc?

Para buscar códigos y consultar datos, puedes utilizar el buscador de series donde podrás revisar el detalle de las series que se adapten a tus necesidades específicas.

Sin embargo, los códigos más usados y consultados para este tipo de datos son:

  • UF: F073.UFF.PRE.Z.D
  • UTM: F073.UTR.PRE.Z.M
  • IPC (base 2023): F074.IPC.VAR.Z.EP23.C.M
  • USD: F073.TCO.PRE.Z.D
¿Hay límites de consultas?

Sí, existen límites técnicos para garantizar un buen funcionamiento del servicio para todos los usuarios. El límite es de hasta 5 series por segundo por cuenta, independientemente de las direcciones IP desde las cuales se realicen las consultas.

¿Qué significa este límite?

  • Puedes consultar máximo 5 códigos de series diferentes cada segundo.
  • El límite se aplica por cuenta de usuario, no por IP.
  • No hay límite en la cantidad total de consultas diarias.

Importante: En caso de incumplimiento reiterado, el Banco Central de Chile se reserva el derecho de suspender el acceso a la API temporal o indefinidamente.

¿Puedo redistribuir los datos?

Sí, está permitido. El Banco Central de Chile permite la libre consulta, reproducción, difusión, publicación y adaptación de toda la información contenida en la Base de Datos Estadísticos (BDE), mencionando en todo momento que es propiedad del Banco Central de Chile o de la fuente original de los datos.

Si realizas modificaciones, transformaciones o análisis de los datos originales, debes indicar claramente que la adaptación es de tu propiedad y responsabilidad, mientras que los datos originales pertenecen al Banco Central de Chile. Para información detallada sobre el uso de datos, consulta la sección Términos y Condiciones.

"Invalid token"

Si ingresas un API Key Token incorrecto, no válido o expirado, puede aparecer este error e impedir el uso de la API. La solución depende de tu situación específica:

  • Primera vez usando la API: Si es tu primera vez, regístrate en la BDE, habilita el uso de la API y luego obtén tu token en "Mi Cuenta", en la sección "Apikey Token". Puedes revisar el proceso completo en Acceso a la API.
  • Token expirado o próximo a expirar: Si tu token expiró, usa la opción "Renovar Token". Si está próximo a vencer y deseas seguir usando el mismo token, usa "Extender fecha expiración".
  • Si el error persiste: Si después de intentar las soluciones anteriores el problema continúa, contacta soporte técnico a través de https://contactocentral.bcentral.cl/ para solicitar asistencia.

Tip importante: Copia el token directamente desde "Mi Cuenta" para evitar errores al escribirlo.

Error timeout / Conexión reiniciada / Lentitud

En caso de que aparezca un error asociado a problemas de conexión de la API, espera unos minutos y reintenta la consulta. Si el problema persiste, documenta el error específico que te aparece, el tipo de código que estás usando (Python, endpoint de REST, cliente SOAP, etc.) y la hora en que ocurrió, para luego solicitar soporte técnico con estos detalles a través de https://contactocentral.bcentral.cl/.

Serie del IPC base 2018 no devuelve datos actuales

A partir de enero 2024, la serie referencial del IPC está en base 2023=100, no en base 2018. Por lo que para consultar datos actuales del IPC debes usar las siguientes series actualizadas: para consultar el índice usa la serie F074.IPC.IND.Z.EP23.C.M y para consultar la variación usa la serie F074.IPC.VAR.Z.EP23.C.M.

Recursos adicionales: Busca otros códigos relacionados al IPC base 2023 en la buscador de series.

Problema al usar el parámetro "frecuencia" en Python con la librería bcchapi

A veces al ocupar el parámetro frecuencia de manera redundante se provoca que no aparezcan ciertas observaciones en los resultados. Por ejemplo, al consultar una serie mensual, se debe evitar usar frecuencia="M" en los parámetros del método .cuadro(). Esto se repite para otras frecuencias (diarias, trimestrales, anuales).

Recomendación: Usa parámetros mínimos necesarios y verifica metadatos. Para más detalles de los métodos de la librería bcchapi, consulta la sección documentación.

En caso de cualquier duda o problema, contáctanos a través de Contacto Central:

Para mejorar la claridad de la respuesta

Se recomienda incluir en tu consulta el siguiente contexto:

  • Descripción del error o problema específico que experimentas
  • Entorno de desarrollo: Python, R, C#, etc.
  • Método de acceso: REST, SOAP, o librería bcchapi
  • Código fuente utilizado (fragmento relevante)
  • Códigos de series consultados en caso de ser aplicable
  • Fecha y hora exacta en que ocurrió el problema