Datos
La base de datos Open Beauty Facts está disponible bajo la Licencia Open Database.
Los contenidos individuales de la base de datos están disponibles bajo la Licencia de Contenidos de la Base de Datos.
Las imágenes de los productos están disponibles bajo la licencia Creative Commons Attribution ShareAlike.
Pueden contener elementos gráficos sujetos a derechos de autor u otros derechos que, en algunos casos, pueden reproducirse (derechos de cotización o uso legítimo).
Por favor, lee las condiciones de uso y reutilización antes de utilizar los datos.
Nos gusta saber cómo se utilizan los datos de Open Beauty Facts. No es obligatorio, pero te agradeceríamos que nos contaras cómo vas a utilizar los datos para compartirlo con la comunidad de Open Beauty Facts.
Exportar datos de Open Beauty Facts
Los volcados de la base de datos y las exportaciones se generan todas las noches.
La información sobre los diferentes campos para el volcado de MongoDB y las exportaciones de CSV está disponible en https://world.openbeautyfacts.org/data/data-fields.txt
Volcado de MongoDB
Los datos para todos los productos están disponibles en un volcado de base de datos MongoDB.
- Enlace
- https://static.openbeautyfacts.org/data/openbeautyfacts-mongodbdump.tar.gz
- sha256sum
- https://static.openbeautyfacts.org/data/sha256sum
- md5sum
- https://static.openbeautyfacts.org/data/md5sum
Exportación Delta
Las exportaciones delta diarias están disponibles para los 14 días anteriores. La lista de archivos delta disponibles actualmente se puede encontrar en https://static.openbeautyfacts.org/data/delta/index.txt.
Cada línea representa un archivo que está disponible en https://static.openbeautyfacts.org/data/delta/{filename}
.
El nombre del archivo contiene una marca de tiempo UNIX del primer y último cambio que contiene el archivo JSON, por lo que los archivos delta pueden ser importados (después de la extracción) con mongoimport
en orden alfabético.
Ten en cuenta que, debido a la naturaleza de mongoexport
, los archivos delta no te darán información sobre los productos eliminados. Ten en cuenta que, debido a la naturaleza de mongoexport
, los archivos delta no te darán información sobre los productos eliminados.
Exportar datos en formato CSV
Los datos de todos los productos, o algunos de los productos, se pueden descargar en formato CSV (legible con OpenOffice, Excel y muchos otros programas de hojas de cálculo) a través del formulario de búsqueda avanzada.
La codificación del archivo es Unicode UTF-8. El carácter que separa los campos es <tab> (tabulación).
Exportar datos RDF
La base de datos también está disponible en formato RDF. Puedes leer el comunicado en francés.
API JSON
La API se comporta en un 99 % como la de Open Food Facts, por lo que muchos de los SDK, códigos para interactuar con la API de Open Food Facts deberían funcionar simplemente cambiando la última parte de «openfoodfacts.org» a «openbeautyfacts.org». El código no se ha actualizado en más de un año, por lo que muchas de las API más nuevas, como los Paneles de Conocimiento, aún no están disponibles.También está disponible una API JSON para leer los datos de un producto. Esta API se utiliza particularmente en la aplicación de Open Beauty Facts para iPhone y Android.
Poco a poco vamos cambiando la API con el tiempo, pero procuramos mantener la compatibilidad con versiones anteriores. Si la vas a utilizar, dínoslo para que te informemos sobre posibles cambios.
URL para leer los datos de un producto; https://world.openbeautyfacts.org/api/v2/product/[barcode].json
Ejemplo: https://world.openbeautyfacts.org/api/v2/product/3600550578041.json
- API V1: documentación antigua disponible en la Wiki. Nota importante: esta página está dividida en subpáginas para LEER y ESCRIBIR.
- API V2: completa, pero no compatible con OpenAPI. Contiene casos de uso para mostrar un producto y permitir que los usuarios añadan la información necesaria para obtener el Nutri-Score, la clasificación NOVA, aditivos y el Eco-Score.
- API V2: nueva documentación de OpenAPI. Trabajo en curso.
- API V3:nueva documentación OpenAPI. Trabajo en curso.
Te invitamos a que utilices la API para casos de producción, siempre que 1 llamada de API = 1 escaneo real por parte de un usuario. Es muy probable que se bloquee cualquier intento scrapear la base de datos utilizando la API, ya que las exportaciones diarias completas están disponibles en esta misma página.
Además, en caso de que surja algún problema, enviar un encabezado HTTP con tu llamada API es una buena manera de ponernos en contacto.
Si tienes dudas sobre algo, o si tienes alguna pregunta (no existen las preguntas tontas), no dudes en consultarnos a través de Slack. :-)
Aplicación móvil para Android y iPhone (¡Se necesita ayuda!)
El código de la aplicación móvil de Open Beauty Facts está disponible en GitHub (Android e para iOS). Necesitamos ayuda para adaptar el nuevo código nativo de iOS a los cosméticos La aplicación permite a los usuarios escanear el código de barras de los productos, ver la información del producto y hacer y enviar fotos y datos de los productos que faltan.
La aplicación para Android está desarrollada en Kotlin.
La nueva aplicación multiplataforma se desarrolla en Flutter/Dart.
Te invitamos a reutilizar el código (es de código abierto) y a ayudarnos a mejorarlo, para todos, en todo el planeta.
Wrappers y SDKs
Probablemente tengamos un wrapper para tu lenguaje de programación favorito. Si es así, puedes utilizarlo y mejorarlo, incluso añadirle soporte para Open Beauty Facts. En caso contrario, siempre puedes ayudarnos a crearlo. En caso contrario, siempre puedes ayudarnos a crearlo.
Te permitirán consumir datos, así como permitir a tus usuarios que colaboren con nuevos datos.
- Cordova: GitHub (antigua aplicación oficial de Open Beauty Facts)
- DART: GitHub (por el momento, solo para Open Food Facts)
- Elixir: GitHub (por el momento, solo para Open Food Facts)
- Go: GitHub (por el momento, solo para Open Food Facts)
- NodeJS: GitHub (por el momento, solo para Open Food Facts)
- PHP: GitHub (por el momento, solo para Open Food Facts)
- PHP (Lararel): GitHub (por el momento, solo para Open Food Facts)
- Python: GitHub (por el momento, solo para Open Food Facts)
- React Native: GitHub (por el momento, solo para Open Food Facts)
- Ruby: GitHub (compatible con Open Beauty Facts)
Discusión sobre datos, API y exportaciones
Puedes unirte a la sala de chat de Open Beauty Facts en Slack, que es la mejor forma de hacer preguntas y hablar sobre la API.
También puedes iniciar un hilo en nuestro repositorio de documentación API.
Contacto
Para cualquier pregunta relacionada con los datos, ponte en contacto con nosotros enviando un correo electrónico a contact@openfoodfacts.org.