Aidez-nous à informer des millions de consommateurs à travers le monde sur ce qu'ils mangent

group photo donation 2024
open food facts logo

Merci de contribuer à notre collecte de fonds 2024

Vos dons financent le fonctionnement quotidien de notre association à but non lucratif :

  • garder notre base de données ouverte et accessible à tous,
    • infrastructure technique (site web/application mobile) et une petite équipe permanente

  • rester indépendant de l'industrie alimentaire,

  • mobiliser une communauté de citoyens engagés,

  • soutenir l’avancement de la recherche en santé publique.

(déductible à 66 % de vos impôts: ex. un don de 20€ vous reviendra à 6,80€)

Données

Conditions de réutilisation

La base de données Open Pet Food Facts est disponible sous licence Open Database License.
Les contenus individuels de la base de données sont disponibles sous licence Database Contents License.
Les images des produits sont disponibles sous licence Creative Commons Attribution ShareAlike licence. 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.

Merci de prendre connaissance des Conditions d'utilisation, de contribution et de réutilisation avant de réutiliser les données.

Informez-nous de la manière dont vous utilisez ces données

Nous aimerions savoir comment sont utilisées les données Open Pet Food Facts. Ce n'est pas obligatoire mais nous apprécierions grandement si vous pouviez nous évoquer ce que vous en faites afin de le partager avec la communauté Open Pet Food Facts. Vous avez aussi la possibilité de remplir ce formulaire pour avoir l'opportunité de voir votre application mise en avant.

Exports de données Open Pet 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.

Des informations sur les différents champs des exports MongoDB et CSV sont disponibles sur https://world.openpetfoodfacts.org/data/data-fields.txt

Export MongoDB

Les données concernant tous les produits sont disponibles à travers l'export MongoDB.

Lien
https://static.openpetfoodfacts.org/data/openpetfoodfacts-mongodbdump.gz
sha256sum
https://static.openpetfoodfacts.org/data/gz-sha256sum
md5sum
https://static.openpetfoodfacts.org/data/gz-md5sum

Export Delta

Des exports delta journaliers sont fournis pour les 14 jours précédents. The list of currently available delta files can be found at https://static.openpetfoodfacts.org/data/delta/index.txt.

Chaque ligne représente un fichier disponible à l'adresse https://static.openpetfoodfacts.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.

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

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 Pet Food Facts avec DuckDB

Export CSV

Les données de tous les produits, ou seulement certains, peuvent être téléchargées au format CSV (utilisables dans OpenOffice, Excel et de nombreux logiciels) via le formulaire de recherche avancée.

Liens
L'application classique pour iOS n'a jamais été déployée ni adaptée aux produits pour animaux.

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. Vous pouvez lire l'annonce en français.

Lien
https://world.openpetfoodfacts.org/data/en.openpetfoodfacts.org.products.rdf.gz

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). Consultez notre documentation pour en savoir plus sur le téléchargement d'images.

API Live JSON et XML

Une API JSON est également disponible pour accéder aux données d'un produit. L'API est utilisée en particulier pour les applications mobiles Android et iPhone Open Pet Food Facts.

Nous améliorons l'API au fil du temps mais nous veillons à conserver une rétrocompatibilité. Veuillez nous contacter si vous l'utilisez, afin que nous puissions vous informer des changements potentiels.

L'URL pour lire les données d'un produit : https://world.openpetfoodfacts.org/api/v0/product/[code barre].json

Exemple : https://world.openpetfoodfacts.org/api/v0/product/3600550578041.json

Notez que si les résultats sont trop nombreux, vous pouvez les filtrer, comme décrit dans la documentation de l'API.

Assistance recherchée pour OpenAPI

Nous sommes enthousiastes à l'idée de terminer la documentation de l'API, d'ajouter des cas d'utilisation, et d'automatiser la génération du SDK. Si vous avez des connaissances relatives à OpenAPI, n'hésitez pas à apporter votre aide.

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 :-)

API XML expérimental

Vous pouvez également obtenir le résultat en XML en utilisant .xml

API V2 - Complète mais non conforme à OpenAPI - Elle contient des cas d'utilisation pour afficher un produit et permettre à vos utilisateurs d'ajouter les données nécessaires pour obtenir le Nutri-Score, la classification NOVA, les additifs et l'Eco-Score.

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.
  • If you can't get the information on a specific product, you can get your user to send photos and data, that will then be processed by Open Pet Food Facts AI and contributors to get the computed result you want to show them.
  • 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
  • The Open Pet Food Facts AI - Robotoff - will generate some derived data from the photos
  • Over time, other apps, and the Open Pet Food Facts community will fill the data gaps

If your users expect a result immediately (e.g. Nutrition or Allergy apps)

  • Envoyez les ingrédients + la catégorie > obtenez l'analyse des ingrédients, les additifs, les allergènes, les ingrédients normalisés, végétalien, végétarien…
  • Envoyez des étiquettes pour obtenir plus d'infos
  • Submit nutrition

Application mobile Android et iPhone

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

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 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

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

You can join the Open Pet Food Facts Slack chatroom which is the preferred way to ask questions and discuss the API. Veuillez poser vos questions dans le canal #api

Vous pouvez ouvrir un fil de discussion sur notre dépôt de documentation API

Pour toute question concernant les données, vous pouvez nous contacter à reuse@openfoodfacts.org