Данные

База данных Open Food Facts доступна под Open Database License.
Отдельное содержимое базы данных доступно под Database Contents License.
Изображения продуктов доступны под Creative Commons Attribution ShareAlike licence. Они могут содержать графические элементы, на которые распространяются авторские или иные права, которые в некоторых случаях могут быть растиражированы (права на цитирование или добросовестное использование).

Пожалуйста, прочитайте Условия использования и повторного использования перед повторным использованием данных.

Мы очень заинтересованы в изучении целей использования данных Open Food Facts. 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

Дампы базы данных и экспорт генерируются каждую ночь. The database is very big, so you can find different ways to use the data, depending on the export flavor.

Информация о различных полях для дампа MongoDB и экспорта CSV доступна по адресу https://world.openfoodfacts.org/data/data-fields.txt

Дамп MongoDB

Данные для всех продуктов доступны в дампе базы данных MongoDB.

Ссылка
https://static.openfoodfacts.org/data/openfoodfacts-mongodbdump.tar.gz
sha256sum
https://static.openfoodfacts.org/data/sha256sum
md5sum
https://static.openfoodfacts.org/data/md5sum

Экспорт дельты

Ежедневный экспорт дельты предоставляется за предыдущие 14 дней. Список доступных в настоящее время дельта-файлов можно найти по адресу https://static.openfoodfacts.org/data/delta/index.txt. Каждая строка представляет файл, который доступен по адресу https://static.openfoodfacts.org/data/delta/{filename}. Имя файла содержит метку времени UNIX первого и последнего изменения, содержащуюся в файле JSON, так что дельта-файлы могут быть импортированы (после извлечения) с помощью mongoimport в алфавитном порядке.

Обратите внимание, что из-за природы mongoexport, дельта-файлы не смогут рассказать вам об удаленных продуктах. Чтобы убрать удаленные товары из вашей базы данных, вам необходимо импортировать полный дамп MongoDB.

Экспорт данных CSV

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.

Ссылка
https://static.openfoodfacts.org/data/openfoodfacts-products.jsonl.gz

Экспорт данных RDF

Данные для всех продуктов или некоторых продуктов можно загрузить в формате 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

JSON API также доступен для чтения данных о продукте. Этот API, в частности, используется в мобильном приложении Open Food Facts для iPhone и Android.

We improve the API over-time but we are careful to keep backwards compatibility. Пожалуйста, сообщите нам, если вы используете его, чтобы мы могли рассказать вам о возможных изменениях.

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

URL для чтения данных о продукте: https://world.openfoodfacts.org/api/v0/product/[barcode].json

Further documentation is available here. 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.

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

Мобильное приложение для Android и iPhone

The code for the Open Food Facts mobile app is available on GitHub (Android and iOS). 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.

The app for iOS is developed in Swift.

The app for Android is developed in Kotlin.

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

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.

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. Send an empty e-mail to api-subscribe@openfoodfacts.org to subscribe.

Связаться с нами

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