Register for the Open Food Facts Days 2023

Our annual community event Open Food Facts Days 2023 will take place this October in Paris! To be a part of it, REGISTER HERE

close

Duomenys

The Open Food Facts database is available under the Open Database License.
The individual contents of the database are available under the Database Contents License.
Products images are available under the Creative Commons Attribution ShareAlike licence. They may contain graphical elements subject to copyright or other rights, that may in some cases be reproduced (quotation rights or fair use).

Please read Terms and conditions of use and re-use before re-using the data.

We are very interested in learning what the Open Food Facts data is used for. 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.

Open Food Facts data exports

Database dumps and exports are generated nightly. The database is very big, so you can find different ways to use the data, depending on the export flavor.

Information on the different fields for the MongoDB dump and CSV exports is available at https://world.openfoodfacts.org/data/data-fields.txt

MongoDB dump

Data for all products is available in a MongoDB database dump.

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

Delta Export

Daily delta exports are provided for the previous 14 days. The list of currently available delta files can be found at https://static.openfoodfacts.org/data/delta/index.txt. Each line represents a file that is available at 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.

Please note that due to the nature of mongoexport, the delta files cannot tell you about deleted products. 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.

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

CSV Data Export

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

Links
https://static.openfoodfacts.org/data/en.openfoodfacts.org.products.csv (raw CSV)
https://static.openfoodfacts.org/data/en.openfoodfacts.org.products.csv.gz (compressed CSV in GZIP format)

The file encoding is Unicode UTF-8. The character that separates fields is <tab> (tabulation).

RDF Data Export

The database is also available in the RDF format. announcement in French.

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

Vaizdo duomenų eksportas

Visus vaizdus ir OCR rezultatus galima arba atsisiųsti iš mūsų serverio, arba iš AWS (per AWS atvirųjų duomenų programą). Peržiūrėkite mūsų dokumentus, kad sužinotumėte daugiau, kaip atsisiųsti vaizdus.

Live JSON and XML API

A JSON API is also available to read the data for a product. This API is in particular used in the Open Food Facts mobile app for iPhone and Android.

Laikui bėgant tobuliname API, tačiau stengiamės išlaikyti atgalinį suderinamumą. Jei naudojate, susisiekite , kad galėtume pranešti jums apie galimus pakeitimus.

URL adresas produkto duomenis skaityti: https://world.openfoodfacts.org/api/v2/product/[barcode].json

Pavyzdys: https://world.openfoodfacts.org/api/v2/product/737628064502.json

Be to, galite gauti rezultatą XML formatu naudodami .xml

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

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.

Jei dėl ko nors nesate tikri arba turite klausimų (nėra kvailo klausimo), nedvejodami užduokite jį #api kanale „Slack“ :-)

Android and iPhone mobile app

Mobiliosios programėlės „Open Food Facts“ kodas pasiekiamas „GitHub“ („Flutter“, „Android“ ir iOS“). Programėlė leidžia vartotojams nuskaityti produktų brūkšninį kodą, peržiūrėti produkto informaciją, fotografuoti ir pateikti trūkstamų produktų nuotraukas bei duomenis.

Klasikinė „iOS“ programėlė sukurta „Swift“.

Klasikinė „Android“ programėlė sukurta „Kotlin“.

Nauja kelių platformų programėlė yra „Dart“ / „Flutter“ programėlė.

You are welcome to reuse the code (it's open source) and help us improve it, for everyone, on all the planet.

Wrappers and SDKs

We probably have a wrapper for your favorite programming language. If we do, you can use it and improve it. If we don't, you can help create it.

They will let you consume data, as well as let your users contribute new data

General principles

  • 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)

Discussing data, API and exports

You can join the Open Food Facts Slack chatroom which is the preferred way to ask questions and discuss the API.

Galite atidaryti giją mūsų API dokumentų saugykloje

Contact

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