Help us make food transparency the norm!

As a non-profit organization, we depend on your donations to continue informing consumers around the world about what they eat.

The food revolution starts with you!

Donate
close

Data

Conditions for reuse

Pangkalan data Open Food Facts telah tersedia di bawah Open Database License .
Kandungan-kandungan pangkalan data secara individu tersedia di bawah Database Contents License .
Imej-imej produk puls tersedia di bawah Creative Commons Attribution ShareAlike License. Ia mungkin mengandungi unsur-unsur bergrafik yang tertakluk kepada hak cipta atau lain-lain hak, yang mungkin dalam beberapa kes boleh dihasilkan semula (hak sebutan atau penggunaan adil).

Sila baca Terma-terma dan syarat-syarat penggunaan dan penggunaan-semula sebelum menggunakan semula data.

Tell us about your reuse

Kami amat berminat mengetahui bagaimanakah data Open Food Food Facts digunakan. It is not mandatory, but we would very much appreciate it if you tell us about your re-uses so that we can share them with the Open Food Facts community. You can also fill this form to get a chance to get your app featured.

Eksport data Open Food Facts

Longgok pangkalan data dan eksport dijana setiap malam. The database is very big, so you can find different ways to use the data, depending on the export flavor.

Maklumat mengenai medan-medan berbeza untuk longgok MongoDB dan eksport CSV telah tersedia di https://world.openfoodfacts.org/data/data-fields.txt

Longgok MongoDB

Data untuk semua produk telah tersedia dalam longgok pangkalan data MongoDB.

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

Eksport Delta

Eksport delta harian disediakan selama 14 hari sebelumnya. The list of currently available delta files can be found at https://static.openfoodfacts.org/data/delta/index.txt.

Setiap baris mewakili satu fail yang tersedia di https://static.openfoodfacts.org/data/delta/{filename}.

The filename contains UNIX timestamp of the first and the last change contained in the JSON file, so that the delta files can be imported (after extraction) with mongoimport in alphabetical order.

Harap maklum, disebabkan sifat mongoexport, fail-fail delta tidak dapat memberitahu anda berkenaan produk-produk yang terpadam. To remove deleted products from your database, you will need to import the full MongoDB dump.

JSONL data export

The whole database is also available in JSONL format (sometimes called LDJSON or NDJSON) where each line is a JSON object. It represents the same data as the MongoDB export. The file is compressed with gzip.

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

Eksport Data CSV

Data for all products, or some of the products, can be downloaded in the CSV format (readable with LibreOffice, Excel and many other spreadsheet software) through the advanced search form.

Links
https://static.openfoodfacts.org/data/en.openfoodfacts.org.products.csv.gz (compressed CSV in GZIP format: ~ 0.9 Gb, uncompressed: ~ 9 Gb)

Pengekodan fail ialah Unicode UTF-8. Aksara yang memisahkan medan-medan ialah <tab> (penjadualan).

Eksport Data RDF

Pangkalan data juga telah tersedia dalam format RDF. You can read the announcement in French.

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

Image Data Export

All images and OCR results can either be downloaded from our server or from AWS (through the AWS Open Data Program). Check out our documentation to learn more about how to download images.

OpenAPI Documentation for the JSON API

Satu API JSON juga tersedia untuk membaca data sesebuah produk. API ini khususnya digunakan dalam aplikasi mudah alih Open Food Facts untuk iPhone dan Android.

We improve the API over-time but we are careful to keep backwards compatibility. Please get in touch if you use it, so that we can tell you about potential changes.

URL to read data for a product: https://world.openfoodfacts.org/api/v2/product/[barcode].json

Example: https://world.openfoodfacts.org/api/v3/product/737628064502.json

Note that if the output is too overwhelming, you can filter it - as described in the API documentation.

OpenAPI help wanted

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.

Anda sangat dialu-alukan menggunakan API untuk tujuan-tujuan pengeluaran, asalkan 1 panggilan API = 1 imbasan sebenar oleh seorang pengguna. Sebarang percubaan untuk mengikis pangkalan data menggunakan API berkemungkinan akan disekat, kerana eksport harian penuh tersedia dalam halaman ini.

Dan juga, penghantaran satu tajuk HTTP dengan panggilan API anda adalah cara yang baik untuk kita berhubung, jika ada masalah.

If you are unsure about anything, or have any question (there is no silly question), feel free to ask it on the #api channel on Slack :-)

Experimental XML API

You can also get the result in XML by using .xml

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

This API is not actively maintained, and not officially documented.

Pembalut dan SDK

Kami mungkin mempunyai satu pembalut untuk bahasa pengaturcaraan kegemaran anda. Sekiranya ada, anda boleh menggunakan dan menambahbaiknya. Sekiranya tiada, anda boleh bantu membuatnya.

Ia membolehkan anda guna data tersebut, dan pengguna anda dapat menyumbang data baharu

General principles to make your users happy

  • You can search for information about products, including many useful computed values.
  • DART: GitHub
  • You can also implement the complete flow so that they get immediately the result with some effort on their side.

If your users do not expect a result immediately (e.g. Inventory apps)

  • Submit photos (front/nutrition/ingredients): most painless thing for your users
  • The Open Food Facts AI - Robotoff - will generate some derived data from the photos
  • Over time, other apps, and the Open Food Facts community will fill the data gaps

If your users expect a result immediately (e.g. Nutrition apps)

  • Submit nutrition facts + category > get Nutri-Score
  • Submit ingredients > get the NOVA group (about food ultra-processing), additives, allergens, normalized ingredients, vegan, vegetarian…
  • Submit category + labels > soon get the Eco-Score (about environmental impact)

Android/iPhone/Flutter mobile app

The code for the official Open Food Facts mobile apps is available on GitHub Flutter Kotlin Android Swift iOS

We look to turn the deprecated Kotlin and Swift codebases into Kotlin and Swift SDKs, help welcome :-)

The app allows users to scan the barcode of products, to view the product information, and to take and submit pictures and data for missing products.

Anda dialu-alukan untuk mengguna-semula kod (ia sumber terbuka) dan bantu kami menambahbaiknya, untuk semua orang, di planet ini.

SDKs

Perbincangan data, API dan eksport

You can look at common FAQ questions about the API and Data Exports and common Open Food Facts questions

You can join the Open Food Facts Slack chatroom which is the preferred way to ask questions and discuss the API. Please ask your questions in the #api channel

You can open a thread on our API documentation repository

For any question regarding the data, you can contact us at reuse@openfoodfacts.org