Données
Conditions de réutilisation
La base de données Open Food Facts est disponible sous licence Open Database Licence (Odbl).
Les contenus individuels de la base de données sous disponibles sous licence Database Contents License (DbCL).
Les images de produits sont disponibles sous licence Creative Commons Attribution ShareAlike - CC BY-SA.
Les licences sont des licences libres qui autorisent l'utilisation et la reproduction du contenu à toutes fins, y compris l'utilisation commerciale, sous certaines conditions,
en particulier l'attribution et le partage sous la même condition d'œuvres dérivées.
Nous vous invitons à lire les Conditions d'utilisation et de ré-utilisation avant de ré-utiliser les données.
Informez-nous de la manière dont vous utilisez ces données
Nous sommes vraiment très intéressé par la façon dont vous allez utiliser les données Open Food Facts. Ce n'est pas obligatoire, mais nous vous serions très reconnaissants de nous faire part de la manière dont vous utilisez ces données afin que nous puissions les partager avec la communauté Open Food Facts. Vous avez aussi la possibilité de remplir ce formulaire pour avoir l'opportunité de voir votre application mise en avant.
Export de données Open Food Facts
Les exports de base de données et fichiers de données sont réalisés quotidiennement, chaque nuit. Notre base de données est énorme, vous pourrez donc trouver diverses façons d'utiliser nos données, selon l'export que vous voulez.
Les informations sur les différents champs et colonnes des exports CSV et MongoDB sont disponibles au lien suivant : https://world.openfoodfacts.org/data/data-fields.txt
Export MongoDB
Les données concernant tous les produits sont disponibles à travers l'export MongoDB.
- Lien
- https://static.openfoodfacts.org/data/openfoodfacts-mongodbdump.gz
- sha256sum
- https://static.openfoodfacts.org/data/gz-sha256sum
- md5sum
- https://static.openfoodfacts.org/data/gz-md5sum
Export Delta
Des exports delta journaliers sont fournis pour les 14 jours précédents. La liste des fichiers delta actuellement disponibles se trouve sur https://static.openfoodfacts.org/data/delta/index.txt.
Chaque ligne représente un fichier disponible sur https://static.openfoodfacts.org/data/delta/{filename}
.
Le nom du fichier contient le timestamp UNIX du premier et du dernier changement inclus dans le fichier JSON, afin que les fichiers delta puissent être importés (après extraction) avec mongoimport
dans un ordre alphabétique.
Veuillez noter qu'en raison de la nature de mongoexport
, les fichiers delta ne peuvent pas vous renseigner sur les produits supprimés. Pour supprimer les produits supprimés de votre base de données, vous devrez importer l'intégralité du dump MongoDB.
Export de données JSONL
L'intégralité de notre base de données est aussi disponible au format JSONL (parfois appelé LDJSON ou NDJSON) où chaque ligne est un objet JSON. Ce sont exactement les mêmes données que l'export MongoDB. Ce ficher est compressé avec gzip.
Un moyen approprié d'exploiter la base de données est d'utiliser DuckDB, un outil analytique intégré conçu pour traiter de grandes quantités de données en une fraction de seconde. Vous pouvez lire notre article de blog dans lequel nous vous expliquons comment explorer et utiliser la base de données Open Food Facts avec DuckDB
Export des données Parquet sur Hugging Face
Une version simplifiée du dump JSONL est aussi disponible dans le format Parquet. Lors de la conversion, nous avons filtré les colonnes qui contiennent des informations dupliquées, qui sont utilisées pour le débogage interne ou qui ne sont tout simplement pas pertinentes pour les utilisateurs.
Le format Parquet s'est avéré pratique :
- Les données sont organisées par colonne plutôt que par ligne, ce qui permet d'économiser de l'espace de stockage et d'accélérer les requêtes d'analyse, c'est-à-dire que vous pouvez sélectionner uniquement les colonnes qui vous intéressent, optimisant ainsi les performances des requêtes, même sur les ordinateurs d'entrée de gamme.
- Compression et décompression de données hautement efficaces, ce qui le rend idéal pour le stockage et le partage de grands ensembles de données de toute nature,
- Prend en charge les types de données complexes et les structures de données imbriquées avancées.
L'ensemble de données est disponible sur Hugging Face, un écosystème collaboratif d'apprentissage automatique où les développeurs et les chercheurs peuvent partager des modèles et des ensembles de données.
Trouvez plus d'informations dans le Wiki, y compris les directives pour la réutilisation des données et des exemples de requêtes pour commencer.Export CSV
Les données relatives à tous les produits ou à certains d'entre eux peuvent être téléchargées au format CSV (lisible avec LibreOffice, Excel et de nombreux autres tableurs) via le formulaire de recherche avancée.
- Liens
- Food: https://static.openfoodfacts.org/data/en.openfoodfacts.org.products.csv.gz (compressed CSV in GZIP format: ~ 0.9 Gb, uncompressed: ~ 9 Gb)
- Cosmetics: https://static.openbeautyfacts.org/data/en.openbeautyfacts.org.products.csv.gz
- Pet Food: https://static.openpetfoodfacts.org/data/en.openpetfoodfacts.org.products.csv.gz
- All other products: https://static.openproductsfacts.org/data/en.openproductsfacts.org.products.csv.gz
Le fichier utilise l'encodage Unicode UTF-8. Le caractère de séparation des champs est <tab> (tabulation).
Export RDF
The database is also available in the RDF format (this is an experiment, not actively maintained anymore). Vous pouvez lire l'annonce en français.
Export des images
Les images et les résultats OCR peuvent être récupérés soit à partir de notre serveur, soit via AWS (grâce au programme AWS Open Data). Check out our documentation to learn more about how to download images
API Live JSON et XML
Une API JSON est également disponible pour accéder aux données d'un produit. This API is in particular used in the Open Food Facts mobile app.
Nous améliorons l'API au fil du temps mais nous veillons à conserver une rétrocompatibilité. Veuillez prendre contact si vous l'utilisez, afin que nous puissions vous informer des changements éventuels.
Discover our APIContributing to improving our API and OpenAPI documentation
We're eager to finish the documentation of the API, add use-cases, and automate SDK generation. If you are an OpenAPI connoisseur, you are very welcome to help.
You are very welcome to use the API for production cases, as long as 1 API call = 1 real scan by a user. Any attempt to scrape the database using the API will very likely be blocked, as full daily exports are available on this very page.
Also, sending an HTTP header with your API call is a good way we can get in touch, should any issue arise.
XML API (unsupported)
Vous pouvez également obtenir le résultat en XML en utilisant .xml
Exemple : https://world.openfoodfacts.org/api/v2/product/737628064502.xml
Cette API n'est pas activement maintenue et n'est pas officiellement documentée.Wrappers et SDKs
Nous avons probablement un wrapper pour votre langage de programmation préféré. Si nous l'avons, vous pouvez l'utiliser et l'améliorer. Sinon, vous pouvez aider à le créer.
Ils vous permettront de consommer des données et permettront à vos utilisateurs de créer de nouvelles données.
Principes généraux pour satisfaire vos utilisateurs
- Vous pouvez rechercher des informations sur les produits, y compris de nombreuses valeurs calculées utiles.
- DART : GitHub
- Elixir : GitHub
Si vos utilisateurs attendent un résultat immédiat (par exemple applications de nutrition)
- Envoyer des photos (face/nutrition/ingrédients) : chose la moins pénible pour vos utilisateurs
- L'IA d'Open Food Facts - Robotoff - générera des données dérivées à partir des photos
- Par la suite, d'autres applis, ainsi que la communauté Open Food Facts, rempliront les données manquantes
Si vos utilisateurs n'attendent pas de résultat immédiat (par exemple, application d'inventaire)
- Envoyer les valeurs nutritionnelles + la catégorie > obtention du Nutri-Score
- Envoyez les ingrédients, obtenez le groupe NOVA (à propos de l'ultra transformation des aliments), les additifs, les allergènes, les ingrédients normalisés, des informations végans et végétariennes
- Envoyez la catégorie + les labels, bientôt obtenez l'Éco-Score (à propos de l'impact environnemental)
Application mobile Android et iPhone
Le code des applications mobiles officielles d'Open Food Facts est disponible sur GitHub (Flutter, Android Kotlin et iOS Swift).
Nous cherchons à transformer les bases de code obsolètes Kotlin et Swift en SDK Kotlin et Swift, une aide est bienvenue :-)
L'application permet aux utilisateurs de scanner le code-barres des produits, d'afficher des informations sur les produits, de prendre et d'envoyer des photos et des données sur les produits manquants.
Vous êtes invités à réutiliser le code (il est open source) et à nous aider à l'améliorer, pour tous, sur toute la planète.
Kits de développement logiciel
Icon | Language / Framework | Ressources | Discussion |
---|---|---|---|
Cordova (Old App) | GitHub | N/A | |
DART | GitHub pub.dev | N/A | |
Elixir | GitHub | Slack Channel | |
Aller | GitHub | Slack Channel | |
Java | GitHub | Slack Channel | |
Spring Boot | GitHub | Slack Channel | |
Kotlin | GitHub | Slack Channel | |
NodeJS | GitHub | Slack Channel | |
PHP | GitHub | Slack Channel | |
PHP (Laravel) | GitHub | Slack Channel | |
Python | GitHub | Slack Channel | |
React Native | GitHub | Slack Channel | |
Ruby | GitHub | Slack Channel | |
Rouille | GitHub | Slack Channel | |
R | GitHub | Slack Channel | |
Swift | GitHub | Slack Channel | |
.NET/C# | GitHub | Slack Channel |
Discuter des données, de l'API et des exports
Vous pouvez consulter les FAQ concernant l'API et les exportations de données ainsi que les questions courantes sur Open Food Facts
Vous pouvez rejoindre le chatroom Slack d'Open Food Facts qui est le moyen privilégié pour poser des questions et discuter de l'API. Veuillez poser vos questions dans le canal #api
You can open a thread on our API documentation repository
Pour toute question concernant les données, vous pouvez nous contacter à reuse@openfoodfacts.org