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.
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.
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.
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.
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
Example: 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
- 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 Products 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.
- 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 nutrición
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
- Cordoba: GitHub (antigua aplicación oficial de Open Products Facts)
- DART: GitHub - Paquete en pub.dev
- Elixir: GitHub - Canal de discusión
- Go: GitHub - Canal de discusión
- Java: GitHub - Canal de discusión
- Spring Boot: GitHub - Canal de debate
- Kotlin: GitHub - Canal de discusión
- NodeJS: GitHub - Canal de discusión
- PHP: GitHub - Canal de discusión
- PHP (Laravel): GitHub - Canal de discusión
- Python: GitHub - Canal de discusión
- React Native: GitHub - Canal de discusión
- Ruby: GitHub - Canal de discusión
- Rust: GitHub - Canal de discusión
- Swift: GitHub - Canal de discusión
- Exportar datos en formato CSV
- Kotlin: GitHub - Canal de discusión
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 Products 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.