¡Ayúdanos a que la transparencia alimentaria sea la norma!

Como organización sin fines de lucro, dependemos de tus donaciones para seguir informando a los consumidores de todo el mundo acerca de lo que comen.

¡La revolución alimentaria comienza contigo!

Donar

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.

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.

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

Exportar datos en formato CSV

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
https://static.openfoodfacts.org/data/en.openfoodfacts.org.products.csv.gz (archivo CSV comprimido en formato GZIP: ~ 0,9 GB, sin comprimir: ~ 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.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). É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 Food Facts para iPhone y Android.

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.

URL para leer datos de un producto: https://world.openfoodfacts.org/api/v2/product/737628064502.json

Ejemplo: https://world.openfoodfacts.org/api/v3/product/737628064502.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

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

  • Puedes buscar información sobre productos, incluso muchos valores computados útiles.
  • Si no puedes obtener información sobre un producto específico, puedes hacer que tus usuarios envíen fotos y datos, que más tarde serán procesados por la AI y los colaboradores de Open Food Facts para obtener el resultado computado que deseas mostrarles.
  • También puedes implementar el flujo completo para que obtengan inmediatamente el resultado con algo de esfuerzo de tu parte.

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

  • Enviar imágenes (frontal/información nutricional/ingredientes): la manera más indolora para tus usuarios.
  • La IA de Open Food Facts, Robotoff, generará algunos datos obtenidos de las fotografías.
  • Con el tiempo, otras aplicaciones, y la comunidad Open Food Facts rellenarán los datos que faltan.

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

  • Sube la información nutricional y la categoría para conseguir el Nutri-Score
  • Envía los ingredientes para obtener información sobre el grupo NOVA (sobre alimentos ultraprocesados), aditivos, alérgenos, ingredientes normalizados, veganos, vegetarianos…
  • Envía la categoría y el etiquetado especial y pronto obtendrás el Eco-Score (información sobre el 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 obsoletos códigos Kotlin y Swift en Kotlin y Swift SDKs, por lo que toda ayuda es bienvenida. :-) 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.

La aplicación permite a los usuarios escanear los códigos de barra de los productos, ver la información de éstos, y subir las imágenes y los datos que faltan de los productos.

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.

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.

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.