Данни

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

Моля, прочети Общи условия за използване и повторна употреба преди да използваш повторно данните.

Ние сме много заинтересовани да научим за какво се използват данните от Open Food Facts. Не е задължително, но ще бъдем много благодарни, ако ни кажеш за твоите повторни употреби, за да можем да ги споделим с общността на Open Food Facts.

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.

Линк
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. Всеки ред представлява файл, който е достъпен на адрес 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. Файлът се компресира с gzip.

Линк
https://static.openfoodfacts.org/data/openfoodfacts-products.jsonl.gz

Експорт на CSV данни

Данните за всички продукти или някои от продуктите могат да бъдат изтеглени във CSV формат (четим с OpenOffice, Excel и други софтуери) чрез формуляра за разширено търсене.

Линк
https://static.openfoodfacts.org/data/en.openfoodfacts.org.products.csv

Кодирането на файла е Unicode UTF-8. Знакът, който разделя полетата, е <tab> (таблица).

Експорт на RDF данни

Базата данни е достъпна и в RDF формат. съобщение на френски.

Линк
https://world.openfoodfacts.org/data/en.openfoodfacts.org.products.rdf

Live JSON 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.

Подобряваме API с течение на времето, но внимаваме да запазим обратната съвместимост. Моля, кажи ни дали го използваш, за да можем да ти кажем за потенциални промени.

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

Пример: https://world.openfoodfacts.org/api/v0/product/737628064502.json

Допълнителна документация е налична тук. 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.

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.

Ако не си сигурен за нещо или имаш някакъв въпрос (няма глупав въпрос), не се колебай да го зададеш в канала #api в Slack :-)

Приложение за Android и iPhone

Кодът за мобилното приложение Open Food Facts е наличен в GitHub (Android и iOS). Приложението позволява на потребителите да сканират баркода на продуктите, да преглеждат информацията, да правят и изпращат снимки и данни за липсващи продукти.

The app for iOS is developed in Swift.

Приложението за Android е разработено в Kotlin.

We also have an on-going Dart/Flutter effort.

Можеш да използваш повторно кода (той е с отворен код) и да ни помогнеш да го подобрим за всички, на цялата планета.

Wrappers and SDKs

We probably have a wrapper for your favorite programming language. Ако го направим, можеш да го използваш и подобриш. Ако не го направим, можеш да помогнеш за създаването му.

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

Основни принципи

  • Можеш да търсиш информация за продукти, включително много полезни изчислени стойности.
  • If you can't get the information on a specific product, you can get your user to send photos and data, that will then be processed by Open Food Facts AI and contributors to get the computed result you want to show them.
  • 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
  • Open Food Facts AI Robotoff ще генерира някои извлечени данни от снимките
  • С времето, други приложения и общността на Open Food Facts ще запълнят пропуските в данните

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.

You can also join the mailing list to discuss the API and exports, tell us about your re-uses, and be notified when improvements or changes are made to the API. Изпрати празен имейл на api-subscribe@openfoodfacts.org за да се абонираш.

За контакти

За всякакви въпроси относно данните, можеш да се свържеш с нас на contact@openfoodfacts.org