Données

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.

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 c'est un vrai plus pour nous si vous nous partagez vos réutilisations. Nous pourrons les diffuser au sein de la communauté Open Food Facts.

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.tar.gz
sha256sum
https://static.openfoodfacts.org/data/sha256sum
md5sum
https://static.openfoodfacts.org/data/md5sum

Export Delta

Des exports delta journaliers sont fournis pour les 14 jours précédents. La liste des fichiers delta actuellement disponibles peut être trouvée dans 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 un horodatage UNIX du premier et du dernier changement apporté au fichier JSON, afin que les fichiers delta puissent être importés (après extraction) avec mongoimport par 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 effacer les produits supprimés de votre base de données, vous devez importer l'entièreté du dépôt / dump MongoDB.

Export CSV

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.

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

Export CSV

Les données pour tous les produits, ou une sélection de produits, peuvent être téléchargés au format CSV (utilisable avec les logiciels OpenOffice, Excel par exemple parmi l'offre importante de logiciels de tableur existants) en utilisant le formulaire de recherche avancé.

Lien
https://static.openfoodfacts.org/data/en.openfoodfacts.org.products.csv

Le fichier utilise l'encodage Unicode UTF-8. Le caractère de séparation des champs est <tab> (tabulation).

Export RDF

Les données sont également disponibles au format RDF. Voir l'annonce.

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

API JSON Live

Une API JSON est également disponible pour accéder aux données d'un produit. Cette API est notamment utilisée au sein des applications Open Food Facts Android et iPhone.

Nous améliorons l'API au fil du temps mais nous veillons à conserver une rétrocompatibilité. N'hésitez pas à nous contacter si vous souhaitez certaines améliorations pour faciliter vos usages.

Exemple : https://world.openfoodfacts.org/api/v0/product/737628064502.json

Exemple : https://world.openfoodfacts.org/api/v0/product/737628064502.json

Plus de documentation est disponible ici. Elle contient des exemples de cas d'utilisation pour expliquer comment afficher un produit et ajouter les données nécessaires pour obtenir le Nutri-Score, la classification NOVA, les additifs et l'Éco-Score.

Vous avez parfaitement le droit d'utiliser l'API pour des programmes en production, tant qu'1 appel API = 1 scan par un utilisateur réel. Toute tentative de "scraper" la base de données en utilisant l'API sera très probablement bloquée, car des exports journaliers complets sont disponibles sur cette page.

En outre, l'envoi d'un en-tête HTTP avec votre appel d'API est un moyen efficace pour que l'on puisse vous contacter, en cas de problème.

Si vous n'êtes pas sûr de quelque chose, ou si vous avez une question (il n'y a pas de question bête), n'hésitez pas à la poser sur le canal #api de Slack :-)

Application Android et iPhone

Le code de l'application mobile Open Food Facts est disponible sur GitHub (Android et iOS). 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.

L'application pour iOS est développée en Swift.

L'application pour Android est développée en Kotlin.

Nous avons aussi un projet Dart/Flutter en cours.

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.

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

  • Vous pouvez rechercher des informations sur les produits, y compris de nombreuses valeurs calculées utiles.
  • DART : GitHub
  • Elixir : GitHub

Si vos utilisateurs n'attendent pas de résultat immédiat (par exemple, application d'inventaire)

  • Soumettre des photos (face avant/valeurs nutritionnelles/ingrédients) : la chose la plus facile pour vos utilisateurs
  • L'IA Robotoff d'Open Food Facts 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 attendent un résultat immédiat (par exemple applications de nutrition)

  • Envoyer les valeurs nutritionnelles + la catégorie > obtention du Nutri-Score
  • Envoyer les ingrédients > obtention du groupe NOVA (ultra-transformation des aliments), des additifs, des allergènes, des ingrédients normalisés, des informations véganes et végétariennes…
  • Envoyer la catégorie + les labels > obtention sous peu de l'Éco-Score (impact environnemental)

Discuter des données, de l'API et des exports

Vous pouvez rejoindre le Slack Open Food Facts qui est le moyen privilégié pour poser des questions et discuter de l'API.

Vous pouvez vous joindre à la liste de diffusion de l'API et des exports. Partagez nous vos réutilisations et soyez informés lorsque des améliorations ou des changements sont effectués sur l'API. Envoyez un courriel vide à l'adresse électronique api-subscribe@openfoodfacts.org pour vous inscrire.

Contact

Pour toute question sur les données, vous pouvez nous contacter à l'adresse email contact@openfoodfacts.org