Datos

Condiciones de reutilización

La base de datos de Open Food Facts está disponible bajo la licencia Open Database License.
Los contenidos individuales de la base de datos están disponibles bajo la licencia Database Contents License.
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.

Simplified ODbL summary

This is a human-readable summary of the ODbL 1.0 license (see also the Open Data Commons summary):

You are free:

  • To share: To copy, distribute and use the database.
  • To create: To produce works (such as applications, websites, services, or analytical studies) from the database.
  • To adapt: To modify, transform and build upon the database.

As long as you:

  • Attribute: You must attribute any public use of the database, or works produced from the database, in the manner specified in the ODbL (e.g. "Contains data from Open Food Facts, available under the Open Database License"). For any redistribution of the database, or works produced from it, you must make clear to others the license of the database and keep intact any notices on the original database.
  • Share-Alike: If you publicly use any adapted version of this database, or works produced from an adapted database, you must also offer that adapted database under the ODbL and share your modifications back.
  • Keep open: If you redistribute the database, or an adapted version of it, you may use technological measures that restrict the work (such as DRM) only as long as you also redistribute a version without such measures.

Be on the legal side: The technical route to compliance

We want everyone to succeed with their projects while keeping data open for everyone! To ensure your application or reuse complies with the license and our infrastructure policies, please follow this technical checklist (see also our license compliance tutorial):

  • Naranja rojizo
  • Use bulk exports for offline, analytical, or caching needs: If you need access to all products or want to run complex queries, please download the nightly MongoDB dumps, CSV, or Parquet exports (described below) or build a local cache.
  • Contribute back (Share-Alike in practice): In the spirit of the ODbL Share-Alike obligation, if your app allows users to add new products, update nutrition/ingredients, or submit photos, please send those contributions back to Open Food Facts via our API or SDKs. This ensures everyone benefits from continuous data improvements.
  • Prominent UI attribution: Clearly attribute Open Food Facts in your app or website UI (for example, on product pages, search screens, and in the "About" or "Settings" sections) with clickable links back to Open Food Facts and the ODbL license.

Compliance resources:

Háblanos sobre tu reutilización

Nos gustaría saber cómo se utilizan los datos de Open Food Facts. No es obligatorio, pero nos encantaría que nos contaras cómo vas a utilizar los datos y así poder compartirlo con la comunidad de Open Food Facts. También puedes rellenar este formulario para hacer destacar tu aplicación.

✨ Discover the Reuses Showcase

Exportar datos de Open Food 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.openfoodfacts.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.openfoodfacts.org/data/openfoodfacts-mongodbdump.gz
sha256sum
https://static.openfoodfacts.org/data/gz-sha256sum
md5sum
https://static.openfoodfacts.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.openfoodfacts.org/data/delta/index.txt.

Cada línea representa un archivo que está disponible en https://static.openfoodfacts.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.openfoodfacts.org/data/openfoodfacts-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. Puedes leer el artículo del blog donde te guiamos en la exploración y procesamiento de la base de datos de Open Food 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.

The dataset is available on Hugging Face, a collaborative Machine Learning ecosystem where developers and researchers can share models and datasets.

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

Find more information in the Wiki, including guidelines for data reuse and example queries to get started.

Exportación de datos de imágenes

Los datos de todos los productos, o algunos de los productos, se pueden descargar en formato CSV (legible con LibreOffice, Excel y muchos otros programas de hojas de cálculo) a través del formulario de búsqueda avanzada.

Enlaces
Comida: https://static.openfoodfacts.org/data/en.openfoodfacts.org.products.csv.gz (CSV comprimido en formato GZIP: ~ 0,9 Gb, descomprimido: ~ 9 Gb)
Cosméticos: https://static.openbeautyfacts.org/data/en.openbeautyfacts.org.products.csv.gz
Comida para Mascotas: https://static.openpetfoodfacts.org/data/en.openpetfoodfacts.org.products.csv.gz
Otros productos: https://static.openproductsfacts.org/data/en.openproductsfacts.org.products.csv.gz

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 (esto es una prueba, ya no se mantiene activamente). Puedes leer el comunicado en francés.

Enlace
https://world.openfoodfacts.org/data/en.openfoodfacts.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). Consulte nuestra documentación para obtener más información 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 en particular en la aplicación móvil Open Food Facts.

Vamos mejorando la API con el tiempo, pero procuramos mantener la compatibilidad con versiones anteriores. Si la quieres utilizar, contáctanos para que te informemos sobre posibles cambios.

Discover our API
Digital Commons • Non-Profit NGO

Benefiting from our API? Support the infrastructure that powers your project

Open Food Facts is an independent, non-profit digital commons built for public benefit. We provide our database and API 100% free of charge and open to all, without commercial paywalls or advertising.

Serving millions of real-time queries daily incurs real costs in servers, database clusters, bandwidth, and maintenance. If your application, startup, research project, or company saves time and builds value with our API, please consider supporting Open Food Facts financially. Your contribution keeps our open infrastructure fast, resilient, and freely accessible to everyone worldwide.

Contribuyendo a mejorar nuestra API y la documentación de OpenAPI

Estamos deseando finalizar la documentación de la API, añadir casos de uso y automatizar la generación de SDK. Si tienes conocimientos en OpenAPI, estaríamos encantados de contar con tu ayuda.

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 de 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.

XML API (no soportada)

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

Ejemplo: https://world.openfoodfacts.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

  • You can search for information about products, including many useful computed values.
  • If you can't get the information on a specific product, you can get your user to send photos and data, that will then be processed by Open Food Facts AI and contributors to get the computed result you want to show them.
  • You can also implement the complete flow so that they get immediately the result with some effort on their side.

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

  • Submit photos (front/nutrition/ingredients): most painless thing for your users
  • The Open Food Facts AI - Robotoff - will generate some derived data from the photos
  • Over time, other apps, and the Open Food Facts community will fill the data gaps

Si tus usuarios no esperan un resultado inmediato (por ejemplo, aplicaciones de inventario)

  • Submit nutrition facts + category > get Nutri-Score
  • Submit ingredients > get the NOVA group (about food ultra-processing), additives, allergens, normalized ingredients, vegan, vegetarian…
  • Enviar categoría + etiquetas > pronto obtendrás el Eco-Score (sobre impacto ambiental)

Aplicación móvil para Android y iPhone

El código de la aplicación móvil de Open Food Facts está disponible en GitHub (Flutter, Kotlin Android y Swift iOS).

Queremos convertir los códigos base obsoletos de Kotlin y Swift en SDK de Kotlin y Swift. ¡Te esperamos! :-)

:-) 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

Icono Lenguaje / Framework Recursos Comentarios
Cordova (Antigua App) GitHub N/D
DART GitHub pub.dev N/D
Elixir GitHub Canal de Slack
Go GitHub Canal de Slack
Java GitHub Canal de Slack
Spring Boot GitHub Canal de Slack
Kotlin GitHub Canal de Slack
JavaScript GitHub Canal de Slack
PHP GitHub Canal de Slack
PHP (Laravel) GitHub Canal de Slack
Python GitHub Canal de Slack
React Native GitHub Canal de Slack
Ruby GitHub Canal de Slack
Naranja rojizo GitHub Canal de Slack
R GitHub Canal de Slack
Swift GitHub Canal de Slack
.NET/C# GitHub Canal de Slack

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.

Puedes unirte a la sala de chat de Open Food Facts en Slack, que es la mejor forma de hacer preguntas y hablar sobre la API. Por favor, no dudes enexponer tus preguntas en el canal #api.

Puedes abrir un hilo en nuestro repositorio de documentación de API

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