Data

Ketentuan untuk penggunaan kembali

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.

Ceritakan kepada kami tentang penggunaan ulang Anda

Kami sangat tertarik untuk mempelajari untuk apa data Open Food Facts digunakan. Hal ini tidak wajib, namun kami akan sangat menghargai jika Anda memberitahukan kepada kami tentang penggunaan ulang yang Anda lakukan agar kami dapat membagikannya kepada komunitas Open Food Facts. Anda juga dapat mengisi formulir ini untuk mendapatkan kesempatan agar aplikasi Anda ditampilkan.

Ekspor data Open Food Facts

Dump dan ekspor basis data dibuat setiap malam. Basis data ini sangat besar, sehingga Anda dapat menemukan berbagai cara berbeda untuk menggunakan data, tergantung pada rasa ekspornya.

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.gz
sha256sum: https://static.openfoodfacts.org/data/gz-sha256sum
md5sum: https://static.openfoodfacts.org/data/gz-md5sum

Ekspor Delta

Ekspor delta harian disediakan selama periode 14 hari sebelumnya. Daftar file delta yang saat ini tersedia 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

Cara yang cocok untuk mengeksploitasi basis data adalah dengan menggunakan DuckDB, alat analisis dalam proses yang dirancang untuk memproses data dalam jumlah besar dalam waktu sepersekian detik. Anda dapat membaca postingan blog kami di mana kami memandu Anda menjelajahi dan memproses basis data Open Food Facts dengan DuckDB

Ekspor Data CSV

Versi sederhana dari dump JSONL juga tersedia dalam format Parquet. Selama konversi, kami memfilter kolom yang berisi informasi yang diduplikasi, digunakan untuk debugging internal, atau tidak relevan bagi pengguna.

Format Parket telah terbukti praktis:

Data disusun berdasarkan kolom, bukan baris, sehingga menghemat ruang penyimpanan dan mempercepat proses analisis; dengan kata lain, Anda dapat memilih hanya kolom-kolom yang Anda butuhkan, sehingga mengoptimalkan kinerja kueri, bahkan pada komputer dengan spesifikasi dasar.
Kompresi dan dekompresi data yang sangat efisien, sehingga cocok untuk menyimpan dan berbagi kumpulan data besar dalam bentuk apa pun,
Mendukung tipe data kompleks dan struktur data bersarang tingkat lanjut.

Kumpulan data tersebut tersedia di Hugging Face, sebuah ekosistem Pembelajaran Mesin kolaboratif tempat para pengembang dan peneliti dapat berbagi model dan kumpulan data.

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

Temukan informasi lebih lanjut di Wiki, termasuk panduan penggunaan ulang data dan contoh kueri untuk memulai.

Eksor Data RDF

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

Tautan: Makanan: https://static.openfoodfacts.org/data/en.openfoodfacts.org.products.csv.gz (berkas CSV terkompresi dalam format GZIP: ~ 0,9 Gb, tidak terkompresi: ~ 9 Gb); Kosmetik: https://static.openbeautyfacts.org/data/en.openbeautyfacts.org.products.csv.gz; Makanan Hewan Peliharaan: https://static.openpetfoodfacts.org/data/en.openpetfoodfacts.org.products.csv.gz; Produk lainnya: https://static.openproductsfacts.org/data/en.openproductsfacts.org.products.csv.gz

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

Ekspor Data Gambar

Database ini juga tersedia dalam format RDF (ini adalah eksperimen, tidak lagi dipelihara secara aktif). Anda dapat membaca pengumuman dalam bahasa Prancis.

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

Dibutuhkan bantuan OpenAPI

Semua gambar dan hasil OCR bisa diunduh dari server kami atau dari AWS (melalui Program Data Terbuka AWS). Lihat dokumentasi kami untuk mengetahui cara mengunduh gambar

Dokumentasi OpenAPI untuk API JSON

API JSON juga tersedia untuk membaca data suatu produk. API ini khususnya digunakan dalam aplikasi seluler Open Food Facts.

Kami meningkatkan API dari waktu ke waktu, tapi kami berhati - hati untuk menjaga kompatibilitas mundur. Silakan menghubungi kami jika Anda menggunakannya, sehingga kami dapat memberi tahu Anda tentang kemungkinan perubahan.

Temukan API kami

Berpartisipasi dalam meningkatkan dokumentasi API dan OpenAPI kami

Kami ingin sekali menyelesaikan dokumentasi API, menambahkan kasus penggunaan, dan mengotomatiskan pembuatan SDK. Jika Anda adalah seorang ahli OpenAPI, Anda sangat dipersilakan untuk membantu.

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.

XML API (tidak didukung)

Kode untuk aplikasi seluler resmi Open Food Facts tersedia di GitHub Flutter Kotlin Android Swift iOS

Kami ingin mengubah basis kode Kotlin dan Swift yang sudah tidak digunakan lagi menjadi Kotlin dan Swift SDK, mohon bantuannya :-)

API ini tidak dipelihara secara aktif, dan tidak didokumentasikan secara resmi.

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.

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

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

Kamu bisa cari info produk, termasuk banyak nilai hitungan yang berguna.
Kalau kamu nggak bisa dapet info produk tertentu, kamu bisa minta pengguna kirim foto dan data, nanti diproses sama AI Open Food Facts dan kontributor buat ngasih hasil hitungan yang mau ditunjukin.
Anda juga dapat menerapkan alur lengkap sehingga mereka segera mendapatkan hasil, dengan sedikit usaha dari pihak mereka.

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

Kirim foto (depan/nutrisi/bahan): cara paling mudah untuk pengguna Anda
AI Open Food Facts – Robotoff – bakal bikin data turunan dari foto
Lama‑lama, aplikasi lain sama komunitas Open Food Facts bakal nutupin kekurangan data

Aplikasi seluler Android/iPhone/Flutter

Kirim informasi gizi + kategori > dapatkan Nutri-Score
Upload bahan > dapet grup NOVA (soal tingkat pemrosesan makanan), aditif, alergen, bahan yang udah dinormalisasi, vegan, vegetarian…
Kirim kategori + label > segera dapatkan Eco-Score (tentang dampak lingkungan)

SDK

Anda dapat melihat pertanyaan umum yang sering ditanyakan tentang API dan Ekspor Data dan pertanyaan umum tentang Open Food Facts