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.
Certaines données peuvent contenir des éléments graphiques soumis au droit d'auteur ou à d'autres droits, qui peuvent dans certains cas être reproduits (droits de citation, usage loyal).
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.
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
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é.
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.
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 les API avec le temps, mais nous veillons à préserver la compatibilité avec les versions antérieures. N'hésitez pas à nous contacter si vous souhaitez certaines améliorations pour faciliter vos usages.
URL à utiliser pour accéder aux données d'un produit : https://world.openfoodfacts.org/api/v0/product/[code-barre].json
Exemple : https://world.openfoodfacts.org/api/v0/product/737628064502.json
Une documentation plus compète est disponible sur le Wiki. (IMPORTANT : la page est divisée en sous-pages pour READ et WRITE). Nous sommes en train de développer une meilleure documentation, comprenant les "uses cases" pour afficher un produit, et permettant à vos utilisateurs d'ajouter les données nécessaires pour produire le Nutri-Score, les groupes NOVA et les additifs. Vous pouvez y accéder ici.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 avez un quelconque doute, ou avez une question (il n'y a pas de question bête !), sentez-vous libre de nous demander sur 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-barre d'un produit pour pour accéder à ses informations mais aussi de compléter les informations et les photos pour des produits manquants.
L'application pour iOS est développée en Swift.
L'application pour Android est développée en Java.
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.
- Cordova : GitHub (ancienne appli officielle Open Food Facts)
- DART : GitHub
- Elixir : GitHub
- Go : GitHub
- NodeJS : GitHub
- PHP : GitHub
- PHP (Lararel) : GitHub
- Python : GitHub
- React Native : GitHub
- Ruby : GitHub
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 email vide à l'adresse mail 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