Ayúdanos a informar a millones de consumidores de todo el mundo sobre lo que comen.

group photo donation 2024
open food facts logo

Please give to our 2024 Fundraiser

Your donations fund the day-to-day operations of our non-profit association:

  • keeping our database open & available to all,
    • technical infrastructure (website/mobile app) & a small permanent team

  • remain independent of the food industry,

  • engage a community of committed citizens,

  • support the advancement of public health research.

¡Cada donación cuenta! Agradecemos su apoyo para lograr una mayor transparencia alimentaria en el mundo.

Datos

Condiciones de reutilización

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.

Háblanos sobre tu reutilización

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. También puedes rellenar este formulario para hacer destacar tu aplicación.

Exportar datos de Open Beauty Facts

Los volcados de la base de datos y las exportaciones se generan todas las noches. La base de datos es muy amplia, así que puedes encontrar diferentes formas para usar los datos, dependiendo de la muestra de la exportación.

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.gz
sha256sum
https://static.openbeautyfacts.org/data/gz-sha256sum
md5sum
https://static.openbeautyfacts.org/data/gz-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 la marca de tiempo de Unix, del primer y último cambio contenido en el archivo JSON, de modo que los archivos delta se pueden importar (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. Para eliminar los productos eliminados de tu base de datos, deberás importar el volcado completo de MongoDB.

Exportar datos JSONL

La base de datos también está disponible en formato JSONL (a veces llamado LDJSON o NDJSON), donde cada línea es un objeto JSON. Representa los mismos datos que la exportación de MongoDB. El archivo está en formato GZIP.

Enlace
https://static.openbeautyfacts.org/data/openbeautyfacts-products.jsonl.gz

Una forma adecuada de aprovechar la base de datos es usar DuckDB, una herramienta de análisis de procesos diseñada para procesar gran cantidad de datos en una fracción de segundos. Puede leer nuestro publicación en el blog donde le guiaremos sobre la exploración y el procesamiento de la base de datos Open Products Facts con DuckDB.

Exportación de datos Parquet en Hugging Face

También está disponible una versión simplificada de JSONL en el formato Parquet. Durante la conversión, filtramos las columnas que contienen información duplicada, se utilizan para depuración interna o simplemente son irrelevantes para los usuarios.

El formato Parquet ha demostrado ser útil:

  • Los datos se organizan por columna, en lugar de por fila, lo que ahorra espacio de almacenamiento y acelera las consultas analíticas, es decir, puede seleccionar solo las columnas que le interesan, optimizando el rendimiento de las consultas, incluso en computadoras de nivel básico.
  • Compresión y descompresión de datos altamente eficientes, lo que lo hace ideal para almacenar y compartir grandes conjuntos de datos de cualquier tipo,
  • Admite tipos de datos complejos y estructuras de datos anidadas avanzadas.

El conjunto de datos está disponible en Hugging Face, un ecosistema colaborativo de aprendizaje automático donde los desarrolladores e investigadores pueden compartir modelos y conjuntos de datos.

Enlace
https://huggingface.co/datasets/openfoodfacts/product-database/resolve/main/beauty.parquet?download=true

Encuentre más información en la Wiki , incluidas pautas para la reutilización de datos y consultas de ejemplo para comenzar.

Exportar datos RDF

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.

Enlaces
https://static.openbeautyfacts.org/data/en.openbeautyfacts.org.products.csv.gz (compressed CSV in GZIP format: ~ 0.9 Gb, uncompressed: ~ 9 Gb)

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.

Enlace
https://world.openbeautyfacts.org/data/en.openbeautyfacts.org.products.rdf.gz

Exportación de datos de imágenes

Todas las imágenes y los resultados de OCR se pueden descargar desde nuestro servidor o desde AWS (a través del Programa de datos abiertos de AWS). Échale un vistazo a nuestra documentación para saber más sobre cómo descargar imágenes.

API JSON y XML

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.

Vamos mejorando 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

Ten en cuenta que, si el resultado es demasiado grande, puedes filtrar la información tal y como se describe en la documentación de la API.

Se busca ayuda OpenAPI

Tenemos muchas ganas de terminar la documentación de la API, añadir casos prácticos y automatizar la generación de SDK. Si tienes amplios conocimientos de OpenAPI, nos encantaría que nos echaras una mano.

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 del canal #api de Slack. :-)

API XML experimental

También puedes obtener los resultados en XML usando .xml

Example: https://world.openbeautyfacts.org/api/v2/product/737628064502.xml

Esta API no se mantiene de forma habitual ni está documentada oficialmente.

Wrappers y SDKs

Probablemente tengamos un wrapper para tu lenguaje de programación favorito. Si es así, puedes utilizarlo y mejorarlo. En caso contrario, siempre puedes ayudarnos a crearlo.

Te permitirán consumir datos, así como permitir a tus usuarios que colaboren con nuevos datos.

Principios generales para hacer felices a tus usuarios

  • Puedes buscar información sobre productos, incluso muchos valores computados útiles.
  • Si no puede obtener la información sobre un producto específico, puede hacer que su usuario envíe fotos y datos, que luego serán procesados ​​por Open Beauty Facts AI y los colaboradores para obtener el resultado calculado que desea mostrarles.
  • También puedes implementar el flujo completo para que obtengan inmediatamente el resultado con algo de esfuerzo de tu parte.

Si tus usuarios esperan un resultado inmediato (por ejemplo, aplicaciones de nutrición)

  • Enviar imágenes (frontal/información nutricional/ingredientes): la manera más indolora para tus usuarios.
  • The Open Beauty Facts AI - Robotoff - will generate some derived data from the photos
  • Over time, other apps, and the Open Beauty Facts community will fill the data gaps

If your users expect a result immediately (e.g. Allergy apps)

  • Submit ingredients + category > get Ingredient analysis, additives, allergens, normalized ingredients, vegan, vegetarian…
  • Submit labels for added value

Aplicación móvil para Android y iPhone

La nueva aplicación multiplataforma se desarrolla en Flutter/Dart.

Exportar datos en formato CSV

:-) La aplicación permite a los usuarios escanear el código de barras de los productos y así ver su información, además de permitirles hacer y enviar fotografías y datos de los productos que faltan.

Te invitamos a reutilizar el código (es de código abierto) y a ayudarnos a mejorarlo, para todos, en todo el planeta.

SDK

Discusión sobre datos, API y exportaciones

Puedes consultar las preguntas frecuentes sobre la API y las exportaciones de datos y las preguntas comunes de Open Food Facts.

You can join the Open Beauty Facts Slack chatroom which is the preferred way to ask questions and discuss the API. Por favor, no dudes enexponer tus preguntas en el canal #api.

También puedes iniciar un hilo en nuestro repositorio de documentación API.

Para cualquier pregunta relacionada con los datos, ponte en contacto con nosotros enviando un correo electrónico a reuse@openfoodfacts.org.