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

Cuéntanos sobre tu reutilización

Estamos muy interesados ​​en saber para qué se utilizan los datos de Open Food 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 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.tar.gz
sha256sum
https://static.openfoodfacts.org/data/sha256sum
md5sum
https://static.openfoodfacts.org/data/md5sum

Exportaciones delta diarias

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 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 pueden dar información sobre productos eliminados. Para eliminar los productos eliminados de tu base de datos, deberás importar el volcado completo de MongoDB.

Exportar datos JSONL

Toda 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á comprimido con gzip.

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

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 (CSV sin procesar)
https://static.openfoodfacts.org/data/en.openfoodfacts.org.products.csv.gz (CSV comprimido en formato GZIP)

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 anuncio en francés.

Enlace
https://world.openfoodfacts.org/data/en.openfoodfacts.org.products.rdf

Exportación de datos de imagen

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). Consulta nuestra documentación para saber más sobre cómo descargar imágenes.

Documentación OpenAPI para la API JSON

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.

Mejoramos la API con el tiempo, pero tenemos cuidado de mantener la compatibilidad con versiones anteriores. Si la quieres utilizar,ponte en contacto con nosotros 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/v2/product/737628064502.json

Ten en cuenta que, si el resultado es demasiado abrumador, puedes filtrarlo, como se describe en la documentación de la API.

Se busca ayuda para 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, enviar un encabezado HTTP con tu llamada API es una buena manera de ponernos en contacto, en caso de que surja algún problema.

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 datos en XML usando .xml

Por 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 lo tenemos, puedes utilizarlo y mejorarlo. En caso contrario, siempre puedes ayudarnos a crearlo.

Te permitirán consumir datos, así como a tus usuarios contribuir 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 tu usuario envíe fotos y datos, que luego serán procesados por Open Food Facts AI y los colaboradores 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 derivados de las fotos.
  • 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 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/iPhone/Flutter

El código de las aplicaciones móviles oficiales de Open Food Facts está disponible en GitHub: Flutter, Kotlin Android, Swift iOS.

Buscamos convertir las bases de código obsoletas de Kotlin y Swift en SDK de Kotlin y Swift. La ayuda siempre es bien recibida. :-)

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

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

SDK

Discusión de datos, API y exportaciones

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

Puedes unirtea la sala de chat de Open Food Facts Slack, que es la mejor forma de hacer preguntas y discutir sobre la API. Por favor, expón 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.