Daten

Bedingungen für die Weiterverwendung

Die Datenbank von „Open Food Facts” ist unter der Open Database License verfügbar.
Die einzelnen Inhalte der Datenbank stehen unter dem Menüpunkt Database Contents License (Lizenz für Datenbankinhalte) zur Verfügung.
Die Produktfotos sind unter der Creative Commons Attribution ShareAlike Lizenz verfügbar. Sie könnten grafische Elemente enthalten, die dem Urheberrecht oder anderen Rechten unterliegen, die in einigen Fällen vervielfältigt werden können (Zitierrechte oder Fair Use).

Bitte lesen Sie Nutzungsbedingungen und Wiederverwendung bevor Sie die Daten wiederverwenden.

Erzählen Sie uns von Ihrer Weiterverwendung

Wir sind sehr daran interessiert zu erfahren, wofür die Daten von Open Food Facts verwendet werden. Es ist nicht verpflichtend, aber wir würden es sehr begrüßen, wenn Sie uns über Ihre Weiterverwendung informieren, damit wir sie mit der Open Food Facts Gemeinschaft teilen können. Sie können auch das Formular ausfüllen, um eine Gelegenheit zu bekommen, dass Ihre App vorgestellt wird.

Open Food Facts - Datenexporte

Datenbank-Abbildungen und -Exporte werden nächtlich generiert. Die Datenbank ist sehr groß, so dass Sie je nach Exportvariante verschiedene Möglichkeiten zur Nutzung der Daten finden können.

Informationen zu den verschiedenen Feldern für den MongoDB-Abbildung und CSV-Export finden Sie unter https://world.openfoodfacts.org/data/data-fields.txt

MongoDB-Datenbankauszug

Die Daten für alle Produkte sind in einem MongoDB-Datenbankdump verfügbar.

Herunterladen

https://static.openfoodfacts.org/data/openfoodfacts-mongodbdump.gz

SHA-256-Prüfsummen

https://static.openfoodfacts.org/data/gz-sha256sum

MD5-Prüfsummen

https://static.openfoodfacts.org/data/gz-md5sum

Delta-Export

Tägliche Delta-Exporte werden für die letzten 14 Tage bereitgestellt. Die Liste der derzeit verfügbaren Deltadateien finden Sie unter https://static.openfoodfacts.org/data/delta/index.txt.

Jede Zeile repräsentiert eine Datei, die unter https://static.openfoodfacts.org/data/delta/{filename} verfügbar ist.

Der Dateiname enthält den UNIX-Zeitstempel der ersten und der letzten in der JSON-Datei enthaltenen Änderung, so dass die Deltadateien (nach der Extraktion) mit mongoimport in alphabetischer Reihenfolge importiert werden können.

Bitte beachten Sie, dass die Delta-Dateien aufgrund der Natur von mongoexport nicht über gelöschte Produkte informieren können. Um gelöschte Produkte aus Ihrer Datenbank zu entfernen, müssen Sie den vollständigen MongoDB-Dump importieren.

CSV-Datenexport

Die gesamte Datenbank ist auch im Format JSONL (manchmal auch LDJSON oder NDJSON genannt) verfügbar, wobei jede Zeile ein JSON-Objekt entspricht. Dies entspricht den gleichen Daten wie der MongoDB-Export. Die Datei wird mit gzip komprimiert.

Herunterladen

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

Ein geeigneter Weg, die Datenbank zu nutzen, ist die Verwendung von DuckDB, einem prozessbegleitenden Analysetool, das große Datenmengen in Sekundenbruchteilen verarbeiten kann. Lesen Sie unseren Blogpost, in dem wir Sie durch die Erkundung und Verarbeitung der Open Food Facts-Datenbank mit DuckDB führen

Parquet-Datenexport auf Hugging Face

Eine vereinfachte Version des JSONL-Dumps ist auch im Parquet-Format verfügbar. Bei der Konvertierung wurden Spalten herausgefiltert, die doppelte Informationen enthalten, für die interne Fehlersuche verwendet werden oder für die Benutzer einfach irrelevant sind.

Das Parquet-Format hat sich als praktisch erwiesen:

• Die Daten sind spaltenorientiert statt zeilenorientiert organisiert. Dies spart Speicherplatz und beschleunigt Analyse-Abfragen, da gezielt nur die relevanten Spalten auswählen können. So wird die Abfrageleistung selbst auf Einsteiger-Rechnern optimiert.
• Hocheffiziente Datenkomprimierung und -dekomprimierung, die sich für die Speicherung und gemeinsame Nutzung großer Datenmengen jeder Art eignet,
• Unterstützt komplexe Datentypen und tief verschachtelte Datenstrukturen.

Der Datensatz ist auf Hugging Face verfügbar, einem kollaborativen Ökosystem für maschinelles Lernen, in dem Entwickler und Forscher Modelle und Datensätze austauschen können.

Herunterladen

https://huggingface.co/datasets/openfoodfacts/product-database/resolve/main/food.parquet?download=true

Weitere Informationen finden Sie im Wiki, einschließlich Leitlinien für die Wiederverwendung von Daten und Beispielabfragen für den Einstieg.

CSV-Daten-Export

Die Daten für alle oder einige der Produkte können im CSV-Format (lesbar mit LibreOffice, Excel und vielen anderen Tabellenkalkulationsprogrammen) über das Formular Erweiterte Suche heruntergeladen werden.

Links

Essen: https://static.openfoodfacts.org/data/en.openfoodfacts.org.products.csv.gz (komprimierte CSV im GZIP-Format: ≈ 0,9 GB, unkomprimiert: ≈ 9 GB)

Kosmetika: https://static.openbeautyfacts.org/data/en.openbeautyfacts.org.products.csv.gz

Tiernahrung: https://static.openpetfoodfacts.org/data/en.openpetfoodfacts.org.products.csv.gz

Alle anderen Produkte: https://static.openproductsfacts.org/data/en.openproductsfacts.org.products.csv.gz

Als Dateikodierung wird Unicode UTF-8 verwendet. Als Trennzeichen für die Felder wird <tab> (Tabellierung) verwendet.

Export von Bilddaten

Die Datenbank ist auch im RDF-Format verfügbar (dies ist ein Experiment und wird nicht mehr aktiv gepflegt). Sie können die Ankündigung auf Französisch lesen.

Herunterladen

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

Export von Bilddaten

Alle Bilder und OCR-Ergebnisse können entweder von unserem Server oder von AWS (über das AWS Open Data Program) heruntergeladen werden. Lesen Sie unsere Dokumentation, um mehr über das Herunterladen von Bildern zu erfahren

OpenAPI-Dokumentation für die JSON-API

Eine JSON-API ist ebenfalls verfügbar, um die Daten für ein Produkt auszulesen. Diese API wird insbesondere in der mobilen App Open Food Facts verwendet.

Wir verbessern die API im Laufe der Zeit, achten aber darauf, die Rückwärtskompatibilität zu wahren. Bitte melden Sie sich, wenn Sie es verwenden, damit wir Sie über mögliche Änderungen informieren können.

Entdecken Sie unsere API

Mitwirken an der Verbesserung unserer API- und OpenAPI-Dokumentation

Wir sind bestrebt, die Dokumentation der API fertigzustellen, Anwendungsfälle hinzuzufügen und die SDK-Generierung zu automatisieren. Wenn Sie ein OpenAPI-Kenner sind, sind Sie herzlich eingeladen, uns zu unterstützen.

Sie können die API gerne für Produktionsabläufe verwenden, sofern 1 API-Aufruf = 1 realer Scan durch einen Benutzer entspricht. Jeder Versuch, die Datenbank auf diese Weise abzuschöpfen, wird sehr wahrscheinlich verhindert, da vollständige tägliche Exporte auf dieser Seite verfügbar sind.

Auch das Senden eines HTTP-Headers mit Ihrem API-Aufruf ist eine gute Möglichkeit, mit uns in Kontakt zu treten, falls irgendwelche Probleme auftreten sollten.

XML-API (wird nicht unterstützt)

Sie können das Ergebnis auch als XML-Datei erhalten, indem Sie .xml verwenden

Beispiel: https://world.openfoodfacts.org/api/v2/product/737628064502.xml

Diese API wird nicht aktiv gepflegt und ist nicht offiziell dokumentiert.

Wrappers und SDKs

Wir haben wahrscheinlich einen Wrapper für Ihre bevorzugte Programmiersprache. Wenn wir dies tun, können Sie es nutzen und verbessern. Wenn wir es nicht tun, können Sie uns helfen, ihn zu erstellen.

Sie ermöglichen Ihnen den Verbrauch von Daten und lassen Ihre Nutzer neue Daten beitragen

Allgemeine Grundsätze, um Ihre Nutzer zufrieden zu stellen

• Sie können nach Informationen von Produkten suchen, einschließlich vieler nützlicher Berechnungswerte.
• Sollten keine Informationen zu einem bestimmten Produkt vorliegen, können Sie Ihre Nutzer bitten, Fotos und Daten zu senden; diese werden anschließend von der Open Food Facts KI sowie von Mitwirkenden verarbeitet, um das gewünschte Ergebnis zu ermitteln.
• Sie können zudem den vollständigen Prozess so implementieren, dass die Nutzer trotz eines gewissen Eigenaufwands sofort ein Ergebnis erhalten.

Wenn Ihre Benutzer nicht sofort ein Ergebnis erwarten (z. B. Inventarisierungs-Apps)

• Fotos hochladen (Vorderseite, Nährwerte, Inhaltsstoffe): am einfachsten für Ihre Nutzer
• Die Open Food Facts KI - Robotoff - extrahiert die Daten aus den Fotos aus
• Mit der Zeit werden die fehlenden Daten von anderen Apps und der Open Food Facts Community ergänzt

Wenn Ihre Benutzer sofort ein Ergebnis erwarten (z. B. Ernährungs-Apps)

• Nährwertangaben + Kategorie eingeben ➜ Nutri-Score erhalten
• Zutaten eingeben ➜ die NOVA-Gruppe (über die Ultrahochverarbeitung von Lebensmitteln), Zusatzstoffe, Allergene, normalisierte Zutaten, vegan, vegetarisch erhalten …
• Kategorie + Etiketten eingeben ➜ bald den Eco-Score (über die Umweltauswirkungen) erhalten

Mobile Anwendung für Android/iPhone/Flutter

Der Code für die Open Food Facts-App für Mobilgeräte ist auf GitHub verfügbar (Flutter, Kotlin Android und Swift iOS).

Wir wollen die veralteten Kotlin- und Swift-Codebasen in Kotlin- und Swift-SDKs umwandeln, Hilfe ist willkommen 🙂

Die App ermöglicht es den Nutzern, den Barcode von Produkten zu erfassen, die Produktinformationen einzusehen und Bilder und Daten zu fehlenden Produkten aufzunehmen und zu übermitteln.

Sie können den Quellcode (es ist Open Source) gerne wiederverwenden und uns helfen, ihn für alle auf der ganzen Welt zu verbessern.

SDKs

Symbol	Sprache / Framework	Ressourcen	Diskussion
	Cordova (alte App)	GitHub	Keine Angaben
	DART	GitHub pub.dev	Keine Angaben
	Elixir	GitHub	Slack-Kanal
	Los	GitHub	Slack-Kanal
	Java	GitHub	Slack-Kanal
	Spring Boot	GitHub	Slack-Kanal
	Kotlin	GitHub	Slack-Kanal
	JavaScript	GitHub	Slack-Kanal
	PHP	GitHub	Slack-Kanal
	PHP (Laravel)	GitHub	Slack-Kanal
	Python	GitHub	Slack-Kanal
	React Native	GitHub	Slack-Kanal
	Ruby	GitHub	Slack-Kanal
	Rostbraun	GitHub	Slack-Kanal
	R	GitHub	Slack-Kanal
	Swift	GitHub	Slack-Kanal
	.NET/C#	GitHub	Slack-Kanal

Über Daten, API und Exportfunktionen diskutieren

Sie können sich allgemeine FAQ-Fragen zur API und zum Datenexport und allgemeine Fragen zu Open Food Facts ansehen

Sie können dem Open Food Facts Slack-Chatroom beitreten, der der bevorzugte Weg ist, um Fragen zu stellen und die API zu diskutieren. Bitte stellen Sie Ihre Fragen im #api channel

Sie können ein Thema in unserem API-Dokumentations-Repository eröffnen

Bei Fragen zu den Daten können Sie sich unter reuse@openfoodfacts.org an uns wenden