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.
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 berdasarkan baris, yang menghemat ruang penyimpanan dan mempercepat kueri analitik, yaitu Anda dapat memilih kolom yang Anda pedulikan, mengoptimalkan kinerja kueri, bahkan pada komputer tingkat pemula.
- Kompresi dan dekompresi data yang sangat efisien, sehingga cocok untuk menyimpan dan berbagi kumpulan data besar dalam bentuk apa pun,
- Mendukung tipe data yang kompleks dan struktur data bersarang tingkat lanjut.
Dataset ini tersedia di Hugging Face, sebuah ekosistem Machine Learning kolaboratif di mana para pengembang dan peneliti dapat berbagi model dan dataset.
Temukan informasi lebih lanjut di Wiki, termasuk panduan untuk 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
- Food: https://static.openfoodfacts.org/data/en.openfoodfacts.org.products.csv.gz (compressed CSV in GZIP format: ~ 0.9 Gb, uncompressed: ~ 9 Gb)
- Cosmetics: https://static.openbeautyfacts.org/data/en.openbeautyfacts.org.products.csv.gz
- Pet Food: https://static.openpetfoodfacts.org/data/en.openpetfoodfacts.org.products.csv.gz
- All other products: 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
The database is also available in the RDF format (this is an experiment, not actively maintained anymore). Anda dapat membaca pengumuman dalam bahasa Prancis.
Dibutuhkan bantuan OpenAPI
Semua gambar dan hasil OCR bisa diunduh dari server kami atau dari AWS (melalui Program Data Terbuka AWS). Check out our documentation to learn more about how to download images
Dokumentasi OpenAPI untuk API JSON
API JSON juga tersedia untuk membaca data suatu produk. This API is in particular used in the Open Food Facts mobile app.
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.
Discover our APIContributing to improving our API and OpenAPI documentation
We're eager to finish the documentation of the API, add use-cases, and automate SDK generation. If you are an OpenAPI connoisseur, you are very welcome to help.
You are very welcome to use the API for production cases, as long as 1 API call = 1 real scan by a user. Any attempt to scrape the database using the API will very likely be blocked, as full daily exports are available on this very page.
Also, sending an HTTP header with your API call is a good way we can get in touch, should any issue arise.
XML API (unsupported)
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)
- 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 mengharapkan hasil yang cepat (misalnya aplikasi Nutrisi)
- Kirimkan foto (depan/nutrisi/kandungan bahan): hal yang paling tidak menyakitkan bagi pengguna Anda
- Open Food Facts AI - Robotoff - akan menghasilkan beberapa data turunan dari foto
- Seiring waktu, aplikasi lain, dan komunitas Open Food Facts akan mengisi kesenjangan datanya
Aplikasi seluler Android/iPhone/Flutter
- 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)
SDK
Anda dapat melihat pertanyaan umum yang sering ditanyakan tentang API dan Ekspor Data dan pertanyaan umum tentang Open Food Facts
We look to turn the deprecated Kotlin and Swift codebases into Kotlin and Swift SDKs, help welcome :-)
Anda dapat membuka utas di repositori dokumentasi API kami
Untuk pertanyaan apa pun terkait data, Anda dapat menghubungi kami di reuse@openfoodfacts.org
SDK
Icon | Language / Framework | Sumber daya | Discussion |
---|---|---|---|
Cordova (Old App) | GitHub | T/A | |
DART | GitHub pub.dev | T/A | |
Elixir | GitHub | Slack Channel | |
Go | GitHub | Slack Channel | |
Java | GitHub | Slack Channel | |
Spring Boot | GitHub | Slack Channel | |
Kotlin | GitHub | Slack Channel | |
NodeJS | GitHub | Slack Channel | |
PHP | GitHub | Slack Channel | |
PHP (Laravel) | GitHub | Slack Channel | |
Python | GitHub | Slack Channel | |
React Native | GitHub | Slack Channel | |
Ruby | GitHub | Slack Channel | |
Karat | GitHub | Slack Channel | |
R | GitHub | Slack Channel | |
Swift | GitHub | Slack Channel | |
.NET/C# | GitHub | Slack Channel |
Membahas data, API, dan eskpor
Anda dapat melihat pertanyaan umum yang sering ditanyakan tentang API dan Ekspor Data dan pertanyaan umum tentang Open Food Facts
Anda dapat bergabung dalam ruang obrolan Slack Open Food Facts yang merupakan cara yang lebih disukai untuk mengajukan pertanyaan dan mendiskusikan API. Silakan ajukan pertanyaan Anda di saluran #api
You can open a thread on our API documentation repository
Untuk pertanyaan apa pun terkait data, Anda dapat menghubungi kami di reuse@openfoodfacts.org