Our annual community event Open Food Facts Days 2023 will take place this October in Paris! To be a part of it, REGISTER HERE
Informació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, lea los Términos y condiciones de uso y reutilización antes de reutilizar los datos.
Estamos muy interesados en saber para qué se utilizan los datos de Open Food Facts. No es obligatorio, pero le agradeceríamos mucho que nos cuente sobre sus reutilizacionespara que podamos compartirlas con la comunidad de Open Food Facts.
Exportación de datos de Open Food Facts
Los volcados de bases 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 del sabor de 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
Descarga 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
Exportar Delta
Las exportaciones deltas diarias son proporcionadas para los 14 días previos. La lista de archivos delta disponibles 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 una marca de tiempo UNIX del primer y último cambio que contiene el archivo JSON, por lo que los archivos delta pueden ser importados (después de la extracción) con mongoimport
en orden alfabético.
Tenga en cuenta que debido a la naturaleza de mongoexport
, los archivos delta no pueden informarle sobre productos eliminados. Para borrar
productos eliminados de su base de datos, deberá importar el volcado completo de MongoDB.
Exportar datos en formato CSV
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.
Exportar datos en formato CSV
Los datos para todos los productos, o algunos de los productos, pueden ser descargados en formato CSV (legibles con OpenOffice, Excel y muchos otros programas) a través del formulario de búsqueda avanzada.
- Enlaces
- https://static.openfoodfacts.org/data/en.openfoodfacts.org.products.csv (CSV crudo)
- 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. anuncio en francés.
Exportación de datos de imágenes
Todas las imágenes y los resultados del ROC (Reconocimiento Óptico de Caracteres) puede ser descargado de nuestro servidor o del programa de código abierto AWS (Amazon Web Services). Échale un vistazo a nuestra documentación para saber más sobre cómo descargar imágenes.
API Live JSON y XML
También está disponible una API en formato 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 nuestra API con el tiempo, pero nos aseguramos de que sea compatible con versiones anteriores. Por favor, contáctanos si la utilizas para poder mantenerte al tanto sobre potenciales cambios.
Ejemplo: https://world.openfoodfacts.org/api/v2/product/737628064502.json
Ejemplo: https://world.openfoodfacts.org/api/v2/product/737628064502.json
También puedes obtenerlo en XML usando .xml
Por ejemplo: https://world.openfoodfacts.org/api/v2/product/737628064502.xml
- API V1- Documentación antigua disponible en Wiki (Nota importante: esta página está dividida en subpáginas para LEER y ESCRIBIR).
- API V2 - completo, pero no compatible con OpenAPI - Contiene casos de uso para mostrar un producto y permitir que los usuarios agreguen la información necesaria para obtener el Nutri-Score, la clasificación NOVA, aditivos y el Eco-Score.
- API V2 - nueva documentación de OpenAPI - Trabajo en progreso
- API V3 - nueva documentación OpenAPI - Trabajo en progreso
Te invitamos a utilizar la API para casos de producción, siempre que 1 llamada de API = 1 exploración real por parte de un usuario. Cualquier intento de eliminar la base de datos usando la API será muy probablemente bloqueado, ya que todas las exportaciones diarias 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, si surge cualquier problema.
Si no estás seguro sobre algo, o tienes alguna pregunta (no hay preguntas tontas), siéntete libre de consultarnos a través del canal #api en Slack :-)
Aplicación móvil para Android e iPhone
El código para la aplicación móvil de Open Food Facts está disponible en GitHub (Flutter, Android e iOS). La aplicación permite que los usuarios puedan escanear los códigos de barra de los productos, ver la información de éstos, y subir imágenes y datos de productos faltantes.
La aplicacón clásica para iOS es desarrollada en Swift.
La aplicacón clásica para Android es desarrollada en Kotlin.
La nueva aplicación multiplataforma es una aplicación de Dart/Flutter.
Te invitamos a reutilizar el código (es código abierto) y ayudarnos a mejorarlo, para todos, en todo el planeta.
Wrappers y SDKs
Probablemente tengamos un contenedor para su lenguaje de programación favorito. Si lo hacemos, puedes utilizarlo y mejorarlo. Si no, puedes ayudar a crearlo.
Le permitirán consumir datos, así como a sus usuarios contribuir con nuevos datos
Principios generales
- Puedes buscar información sobre productos, incluso muchos valores computados útiles.
- DART: GitHub
- También puede implementar el flujo completo para que obtengan inmediatamente el resultado con un esfuerzo de tu parte.
Si tus usuarios no esperan un resultado inmediatamente (por ejemplo, aplicaciones de inventario)
- Sube imágenes (del frente/información nutricional/ingredientes): de la manera más comprensible para tus usuarios
- El Robotoff de IA Open Food Facts generará algunos datos derivados de las fotos
- Con el tiempo, otras aplicaciones, y la comunidad Open Food Facts llenarán las espacios vacíos de datos
Si tus usuarios esperan un resultado inmediatamente (por ejemplo, aplicaciones de nutrición)
- Sube la información nutricional + la categoria > para conseguir Nutri-Score
- Enviar ingredientes > para obtener el grupo NOVA (sobre alimentos ultraprocesados) aditivos, alérgenos, ingredientes normalizados, vegano, vegetariano…
- Envia la categoría + etiquetas > para obtener el Eco-Score pronto (sobre el impacto ambiental)
- Cordoba: GitHub (antigua aplicación oficial de Open Food Facts)
- DART: GitHub
- Elixir: GitHub
- Go: GitHub
- Java: GitHub
- Kotlin: GitHub
- NodeJS: GitHub
- PHP: GitHub
- PHP (Lararel): GitHub
- Python: GitHub
- React Native: GitHub
- Ruby: GitHub
- Rust: GitHub
Discusión de datos, API y exportaciones
También puedes unirte al Slack de Open Food Facts, que es la forma preferida de hacer preguntas y discutir la API.
Puedes iniciar un hilo en nuestro repositorio de documentación API
Contacto
Para cualquier pregunta relacionada con los datos puede contactar con nosotros en contact@openfoodfacts.org