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.

Хранителната революция започва с теб!

Дари
close

Данни

Conditions for reuse

Базата данни Open Food Facts е достъпна под лицензът Open Database.
Индивидуалното съдържание на базата данни е достъпно под Лиценз за съдържание на база данни.
Изображенията на продуктите са достъпни под лиценза Creative Commons Attribution ShareAlike. Те могат да съдържат графични елементи, обект на авторско право или други права, които в някои случаи могат да бъдат възпроизведени (право на цитиране или честна употреба).

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

Tell us about your reuse

Ние сме много заинтересовани да научим за какво се използват данните от 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. You can also fill this form to get a chance to get your app featured.

Износ на данни от Open Food Facts

Копията и износите на базата данни се създават всяка вечер. Базата данни е много голяма, така че можете да намерите различни начина за използване на данните, в зависимост от варианта на изнасяне.

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

Дъмп на MongoDB

Данните за всички продукти са налични в база данни на MongoDB.

Връзка
https://static.openfoodfacts.org/data/openfoodfacts-mongodbdump.gz
sha256sum
https://static.openfoodfacts.org/data/gz-sha256sum
md5sum
https://static.openfoodfacts.org/data/gz-md5sum

Делта Износ

Предоставят се ежедневни делта износи за предходните 14 дни. 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.

Моля, обърнете внимание, че поради естеството на mongoexport, делта файловете не могат да ви кажат за изтрити продукти. To remove deleted products from your database, you will need to import the full MongoDB dump.

Износ на данни в JSONL

Цялата база данни също е достъпна в JSONL формат (понякога наричан LDJSON или NDJSON), където всеки ред е JSON обект. Той представлява същите данни като износа на MongoDB. Файлът се компресира с gzip.

Връзка
https://static.openfoodfacts.org/data/openfoodfacts-products.jsonl.gz

Износ на 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.

Връзки
https://static.openfoodfacts.org/data/en.openfoodfacts.org.products.csv.gz (compressed CSV in GZIP format: ~ 0.9 Gb, uncompressed: ~ 9 Gb)

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

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

Базата данни е достъпна и в RDF формат. You can read the announcement in French.

Връзка
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

Наличен е и JSON API за четене на данните за продукт. Този API се използва по-специално в мобилното приложение Open Food Facts за iPhone и 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 за четене на данни за продукт: 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.

Добре дошли сте да използвате API за производствени случаи, стига 1 API извикване да е = на 1 реално сканиране от потребител. Всеки опит за сканиране на базата данни с помощта на API много вероятно ще бъде блокиран, тъй като пълните ежедневни износи са достъпни точно на тази страница.

Освен това изпращането на HTTP хедър с вашето API извикване е добър начин да се свържем, ако възникне някакъв проблем.

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.

Обвивки и SDK

Вероятно имаме обвивка за любимия ви език за програмиране. Ако го направим, можеш да го използваш и подобриш. Ако не го направим, можеш да помогнеш за създаването му.

Те ще ви позволят да консумирате данни, както и ще позволят на вашите потребители да предоставят нови данни

General principles to make your users happy

  • Можеш да търсиш информация за продукти, включително много полезни изчислени стойности.
  • Ако не можете да получите информацията за конкретен продукт, можете да накарате вашия потребител да изпрати снимки и данни, които след това ще бъдат обработени от Open Food Facts AI и сътрудници, за да получите изчисления резултат, който искате да им покажете.
  • Можете също така да приложите пълния поток, така че те да получат незабавно резултата с известно усилие от тяхна страна.

Ако вашите потребители не очакват резултат веднага (напр. приложения за инвентар)

  • Изпратете снимки (отпред/храна/съставки): най-безболезненото нещо за вашите потребители
  • The Open Food Facts AI - Robotoff - will generate some derived data from the photos
  • С времето, други приложения и общността на Open Food Facts ще запълнят пропуските в данните

Ако вашите потребители очакват резултат незабавно (напр. приложения за хранене)

  • Изпратете хранителни факти + категория >, получете Nutri-Score
  • Изпратете съставките > вземете групата NOVA (относно ултрапреработената храна), добавки, алергени, нормализирани съставки, веган, вегетарианец…
  • Изпратете категория + етикети > скоро получете еко-оценка (относно въздействието върху околната среда)

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.

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

SDKs

Обсъждане на данни, API и износ

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