Data

Basis data Open Food Facts tersedia di bawah Lisensi Basis Data Terbuka.
Konten individual basis data tersedia di bawah Lisensi Konten Basis Data.
Gambar - gambar produk tersedia di bawah Lisensi Creative Commons Attribution ShareAlike. Mereka mungkin berisi unsur - unsur grafis yang tunduk pada hak cipta atau hak lainnya, yang mungkin dalam kasus tertentu direproduksi (hak kutipan atau penggunaan wajar).

Harap baca Persyaratan dan ketentuan penggunaan dan penggunaan kembali sebelum menggunakan kembali datanya.

Kami sangat tertarik untuk mempelajari untuk apa data Open Food Facts digunakan. Ini tidak wajib, tapi kami akan sangat menghargainya jika Anda memberi tahu kami tentang penggunaan kembali Anda sehingga kami dapat membagikannya dengan komunitas Open Food Facts.

Ekspor data Open Food Facts

Dump dan ekspor basis data dibuat setiap malam. Basis data ini sangat besar, jadi Anda akan menemukan berbagai cara untuk menggunakan data, tergantung dari jenis ekspor.

Informasi tentang berbagai field berbeda untuk dump MongoDB dan ekspor CSV tersedia di https://world.openfoodfacts.org/data/data-fields.txt

Dump MongoDB

Data untuk semua produk tersedia di dump basis data MongoDB.

Tautan
https://static.openfoodfacts.org/data/openfoodfacts-mongodbdump.tar.gz
sha256sum
https://static.openfoodfacts.org/data/sha256sum
md5sum
https://static.openfoodfacts.org/data/md5sum

Ekspor Delta

Ekspor delta harian disediakan selama periode 14 hari sebelumnya. Daftar berkas delta yang tersedia saat ini dapat ditemukan di https://static.openfoodfacts.org/data/delta/index.txt. Tiap baris mewakili berkas yang tersedia di https://static.openfoodfacts.org/data/delta/{filename}. Nama berkas berisi stempel waktu UNIX mengenai perubahan pertama dan terakhir yang terdapat dalam berkas JSON, sehingga berkas delta dapat diimpor (setelah ekstrasi) dengan mongoimport dalam urutan abjad.

Harap dicatat bahwa karena sifat mongoexport, berkas delta tidak dapat memberi tahu Anda tentang produk - produk yang dihapus. Untuk menghilangkan produk - produk yang dihapus dari basis data Anda, Anda akan harus mengimpor dump MongoDB lengkap.

Ekspor data JSONL

Seluruh basis data juga tersedia dalam bentuk format JSONL (terkadang disebut juga dengan LDJSON atau NDJSON) di mana setiap baris adalah objek JSON. Ini mewakili data yang sama seperti data ekspor MongoDB. Berkas dikompres dengan gzip.

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

Ekspor Data CSV

Data untuk semua produk, atau beberapa produk, dapat diunduh dalam format CSV (dapat dibaca dengan OpenOffice, Excel, dan banyak perangkat lunak lainnya) melalui formulir pencarian lanjutan.

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

Pengodean berkas berbasis Unicode UTF-8. Karakter yang memisahkan field adalah <tab> (tabulation).

Eksor Data RDF

Basis data juga tersedia dalam format RDF. pengumuman dalam bahasa Perancis.

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

API JSON langsung

API JSON juga tersedia untuk membaca data suatu produk. API ini secara khusus digunakan dalam aplikasi seluler Open Food Facts untuk iPhone dan Android.

Kami meningkatkan API dari waktu ke waktu, tapi kami berhati - hati untuk menjaga kompatibilitas ke belakangnya. Harap memberitahu kami jika Anda menggunakannya, sehingga kami dapat memberi tahu Anda tentang kemungkinan perubahannya.

URL untuk membaca data dari sebuah produk: https://world.openfoodfacts.org/api/v0/product/[barcode].json

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

Untuk dokumentasi lebih lanjut tersedia di sini. It contains uses cases for displaying a product, and letting your users add the data required to get the Nutri-Score, the NOVA classification, additives, and the Eco-Score.

Anda dipersilahkan untuk menggunakan API untuk kasus - kasus produksi, selama 1 pemanggilan API = 1 pemindaian nyata oleh pengguna. Upaya apapun untuk mengikis basis data menggunakan API akan sangat mungkin diblokir, karena ekspor harian lengkap tersedia di halaman ini.

Juga, mengirim header HTTP dengan pemanggilan API Anda adalah cara yang baik untuk menghubungi kami, jika ada masalah yang muncul.

Jika Anda tidak yakin tentang apapun, atau memiliki pertanyaan (tidak ada pertanyaan konyol), jangan ragu untuk menanyakannya di kanal #api di Slack :-)

Aplikasi seluler Android dan iPhone

Kode untuk aplikasi seluler Open Food Facts tersedia di GitHub (Android dan iOS). Aplikasi ini memungkinkan pengguna untuk memindai kode batang produk, untuk melihat informasi produk, dan untuk mengambil dan mengirimkan gambar dan data dari produk yang hilang.

Aplikasi untuk iOS dikembangkan di Swift.

Aplikasi untuk Android dikembangkan di Kotlin.

Kami juga memiliki upaya Dart/Flutter yang sedang berlangsung.

Anda dipersilahkan untuk menggunakan kodenya kembali (ini bersifat sumber terbuka) dan membantu kami meningkatkannya, untuk semua orang, di seluruh planet ini.

Pembungkus dan SDK

Kami mungkin memiliki pembungkus untuk bahasa pemrograman favorit Anda. Jika kami memilikinya, Anda dapat menggunakan dan meningkatkannya. Jika tidak, Anda dapat membantu kami membuatnya.

Pembungkus akan membiarkan Anda menggunakan data, serta membiarkan para pengguna Anda menyumbangkan data baru

Prinsip - prinsip umum

  • Anda dapat mencari informasi tentang produk - produk, termasuk banyak nilai komputasi yang berguna.
  • Jika Anda tidak bisa mendapatkan informasi tentang suatu produk yang spesifik, Anda dapat meminta para pengguna Anda untuk mengirimkan foto dan data, yang akan kemudian diproses oleh AI Open Food Facts dan para kontributor untuk mendapatkan hasil terkomputasi yang ingin Anda tunjukkan kepada mereka.
  • Anda juga dapat mengimplementasikan alur lengkapnya sehingga mereka segera mendapatkan hasilnya dengan beberapa usaha dari pihak mereka.

Jika para pengguna Anda tidak mengharapkan hasil segera (misalnya aplikasi Inventori)

  • Kirimkan foto (depan/nutrisi/kandungan bahan): hal yang paling tidak menyakitkan bagi pengguna Anda
  • AI Robotoff Open Food Facts akan menghasilkan beberapa data turunan dari foto
  • Seiring waktu, aplikasi lain, dan komunitas Open Food Facts akan mengisi kesenjangan datanya

Jika para pengguna Anda mengharapkan hasil yang cepat (misalnya aplikasi Nutrisi)

  • Kirimkan informasi nilai gizi + kategori > dapatkan Nutri-Score
  • Kirimkan kandungan bahan > dapatkan grup NOVA (tentang pemrosesan ultra makanan), zat aditif, alergen, kandungan bahan yang dinormalisasi, vegan, vegetarian…
  • Kirimkan kategori + label > segera dapatkan Eco-Score (tentang dampak lingkungan)

Membahas data, API, dan eskpor

Anda dapat bergabung dalam ruang obrolan Slack Open Food Facts yang merupakan cara yang lebih disukai untuk mengajukan pertanyaan dan mendiskusikan API.

Anda juga dapat bergabung dengan daftar surel untuk mendiskusikan API dan ekspor, memberi tahu kami tentang penggunaan kembali Anda, dan mendapat pemberitahuan ketika peningkatan atau perubahan dilakukan pada API. Kirimkan surel kosong ke api-subscribe@openfoodfacts.org untuk berlangganan.

Kontak

Untuk pertanyaan apapun mengenai datanya, Anda dapat menghubungi kami di contact@openfoodfacts.org