Our annual community event Open Food Facts Days 2023 will take place this October in Paris! To be a part of it, REGISTER HERE
Daten
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.
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 Wiederverwendung informieren, damit wir sie mit der Open Food Facts-Gemeinschaft teilen können.
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.tar.gz
- SHA-256-Prüfsummen
- https://static.openfoodfacts.org/data/sha256sum
- MD5-Prüfsummen
- https://static.openfoodfacts.org/data/md5sum
Delta-Export
Tägliche Delta-Exporte werden für die letzten 14 Tage bereitgestellt. Die Liste der aktuell verfügbaren Delta-Dateien 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 letzten in der JSON-Datei enthaltenen Änderung, so dass die Delta-Dateien (nach der Ausleitung) 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 gesamten MongoDB-Datenbankauszug 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.
CSV-Daten-Export
Daten für alle Produkte oder einige der Produkte können im CSV-Format (lesbar mit OpenOffice, Excel und vielen anderen Programmen) über die erweiterte Suchmaske heruntergeladen werden.
- Links
- https://static.openfoodfacts.org/data/en.openfoodfacts.org.products.csv (RohCSV)
- https://static.openfoodfacts.org/data/en.openfoodfacts.org.products.csv.gz (komprimiertes CSV im GZIP-Format)
Als Dateikodierung wird Unicode UTF-8 verwendet. Als Trennzeichen für die Felder wird <tab> (Tabellierung) verwendet.
RDF-Daten-Export
Die Datenbank ist außerdem im RDF-Format verfügbar. Ankündigung in französischer Sprache.
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. In unserer Dokumentation erfahren Sie mehr darüber, wie Sie Bilder herunterladen können.
Live JSON- und XML-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” für iPhone und Android 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 benutzen, damit wir Sie über mögliche Änderungen informieren können.
Beispiel: https://world.openfoodfacts.org/api/v2/product/737628064502.json
Beispiel: https://world.openfoodfacts.org/api/v2/product/737628064502.json
Sie können das Ergebnis auch als XML-Datei erhalten, indem Sie .xml
verwenden
Beispiel: https://world.openfoodfacts.org/api/v2/product/737628064502.xml
- API V1- Alte Dokumentation im Wiki verfügbar (Wichtiger Hinweis: Die Seite ist in Unterseiten für READ und WRITE unterteilt).
- API V2 - Umfassend, aber nicht OpenAPI-konform - Es enthält Anwendungsfälle für die Anzeige eines Produkts und die Möglichkeit für Ihre Benutzer, die erforderlichen Daten hinzuzufügen, um den Nutri-Score, die NOVA-Klassifizierung, Zusatzstoffe und den Eco-Score zu erhalten.
- API V2 - neue OpenAPI-Dokumentation (In Vorbereitung)
- API V3 - neue OpenAPI-Dokumentation (In Vorbereitung)
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.
Wenn Sie unsicher sind oder eine Frage haben (es gibt keine dummen Fragen), können Sie sie im #api-Kanal auf Slack stellen 🙂
Android- und iPhone-App für Mobilgeräte
Der Code für die Open Food Facts Mobile App ist auf GitHub verfügbar (Flutter, Android und iOS). 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.
Die klassische App für iOS wird in Swift entwickelt.
Die klassische App für Android wird in Kotlin entwickelt.
Die neue plattformübergreifende Anwendung ist eine Dart/Flutter-Anwendung.
Sie können den Quellcode (es ist Open Source) gerne wiederverwenden und uns helfen, ihn für alle auf der ganzen Welt zu verbessern.
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 können dem Open Food Facts Chatroom auf Slack beitreten, der unser bevorzugter Weg ist, um Fragen zu stellen und die über die API zu diskutieren.
Allgemeine Grundsätze
- Sie können nach Informationen von Produkten suchen, einschließlich vieler nützlicher Berechnungswerte.
- Wenn Sie die Informationen über ein bestimmtes Produkt nicht abrufen können, können Sie Ihre Nutzer auffordern, Fotos und Daten zu senden, die dann von der künstlichen Intelligenz von Open Food Facts und den Mitwirkenden verarbeitet werden, um das berechnete Ergebnis zu erhalten, das Sie ihnen zeigen möchten.
- Sie können auch den kompletten Fluss implementieren, so dass sie sofort das Ergebnis mit etwas Aufwand auf ihrer Seite bekommen.
Wenn Ihre Benutzer nicht sofort ein Ergebnis erwarten (z. B. Inventarisierungs-Apps)
- Fotos einreichen (Vorderseite/Nährwertangaben/Zutaten): dies ist für Ihre Nutzer am einfachsten
- Die Open Food Facts AI Robotoff generiert abgeleitete Daten aus den Fotos
- Mit der Zeit werden andere Apps und die Open Food Facts-Community die Datenlücken füllen
Wenn Ihre Benutzer sofort ein Ergebnis erwarten (z. B. Ernährungs-Apps)
- Nährwertangaben + Kategorie einreichen ➜ Nutri-Score erhalten
- Zutaten einreichen ➜ die NOVA-Gruppe (über die Ultrahochverarbeitung von Lebensmitteln), Zusatzstoffe, Allergene, normalisierte Zutaten, vegan, vegetarisch erhalten …
- Kategorie + Etiketten einreichen ➜ demnächst den Eco-Score (über die Umweltauswirkungen) erhalten
- Cordova: GitHub (alte offizielle Anwendung von Open Food Facts)
- PHP (Lararel): GitHub
- Elixir: GitHub
- Go: GitHub
- Java: GitHub
- Kotlin: GitHub
- NodeJS: GitHub
- PHP: GitHub
- PHP (Lararel): GitHub
- Python: GitHub
- React Native: GitHub
- Ruby: GitHub
- Rust: GitHub
Über Daten, API und Exportfunktionen diskutieren
Sie können dem Open Food Facts Chatroom auf Slack beitreten, der unser bevorzugter Weg ist, um Fragen zu stellen und die über die API zu diskutieren.
Sie können ein Thema in unserem API-Dokumentations-Repository eröffnen
Kontakt
Wenn Sie Fragen zu den Daten haben, können Sie uns unter contact@openfoodfacts.org kontaktieren.