Datos

Condiciones de reutilización

La base de datos de Open Products Facts está disponible bajo la licencia Open Database License.
El contenido individual de la base de datos está disponible bajo la licencia Database Contents License.
Las imágenes de 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 reutilizar los datos.

Háblanos sobre tu reutilización

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

Exportar datos de Open Products 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.openproductsfacts.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.openproductsfacts.org/data/openproductsfacts-mongodbdump.gz

sha256sum

https://static.openproductsfacts.org/data/gz-sha256sum

md5sum

https://static.openproductsfacts.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.openproductsfacts.org/data/delta/index.txt.

Cada línea representa un archivo que está disponible en https://static.openproductsfacts.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.openproductsfacts.org/data/openproductsfacts-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 blog post 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.

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.

Exportar datos RDF

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.openbeautyfacts.org/data/en.openbeautyfacts.org.products.csv.gz">https://static.openbeautyfacts.org/data/en.openbeautyfacts.org.products.csv.gz (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.openproductsfacts.org/data/en.openproductsfacts.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 Products 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 datos de un producto: https://world.openproductsfacts.org/api/v2/product/[barcode].json

Ejemplo: https://world.openproductsfacts.org/api/v2/product/8710847992063.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.

• API V3:nueva documentación OpenAPI. Trabajo en curso.

Se busca ayuda 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.

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.openproductsfacts.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.
• 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 Products Facts AI y los colaboradores para obtener el resultado calculado que desea mostrarles.
• 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
• La Open Products Facts AI - Robotoff, generará algunos datos derivados de las fotos.
• Con el tiempo, otras aplicaciones y la comunidad Open Products Facts llenarán los vacíos de datos.

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

• Envía los ingredientes + categoría > obtén el análisis de los ingredientes, aditivos, alérgenos, ingredientes normalizados, veganos, vegetarianos…
• Enviar etiquetas para obtener valor añadido
• Enviar información nutricional

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

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 al chat de Slack de Open Products Facts, 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.