Допоможіть нам зробити прозорість їжі нормою!

Як некомерційна організація ми покладаємося на ваші пожертви, щоб продовжувати інформувати споживачів у всьому світі про те, що вони їдять.

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

Підтримати проект
close

Дані

Умови повторного використання

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

Будь ласка прочитайте Умови використання та повторного використання перед поаторним використанням даних.

Розкажіть про свою проблему

Ми дуже зацікавлені у вивченні того для чого дані Open Food Facts використовуються. Це не є обов'язковим, але ми будемо дуже вдячні, якщо ви розповісте нам про своє повторне використання, щоб ми могли поділитися ними зі спільнотою Open Food Facts. Ви також можете заповнити цю форму, щоб отримати можливість представити свою програму.

Експорт даних 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 днів. Список нині доступних дельта-файлів можна знайти за адресою https://static.openfoodfacts.org/data/delta/index.txt.

Кожний рядок представляє файл, який є наявним на https://static.openfoodfacts.org/data/delta/{filename}.

Ім'я файлу містить UNIX-мітку часу першої та останньої зміни, що міститься у JSON-файлі, так що дельта-файли можна імпортувати (після вилучення) за допомогою mongoimport в алфавітному порядку.

Будь ласка зауважте, що через природу mongoexport, дельти файлів не можуть розповісти вам про видалені продукти. Щоб вилучити видалені продути з вашої бази даних, вам буде потрібно імпортувати повний дамп MongoDB.

Експорт даних JSONL

Повна база даних є також наявною в форматі JSONL (ще назвають LDJSON чи NDJSON) де кожний рядок є об'єктом JSON. Вона представляє такі ж самі дані як експорт MongoDB. Файл стискається за допомогою gzip.

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

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

Дані про всі про всі продукти, або деякі з них, можна завантажити у форматі CSV (читається за допомогою LibreOffice, Excel та багатьох інших програм для роботи з електронними таблицями) через форму розширеного пошуку.

Посилання
https://static.openfoodfacts.org/data/en.openfoodfacts.org.products.csv.gz (compressed CSV in GZIP format: ~ 0.9 Gb, uncompressed: ~ 9 Gb)

Кодування файлу є юнікодом UTF-8. Символ, що розділяє поля є <tab> (табуляція).

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

База даних також наявна у форматі RDF. Ви можете прочитати оголошення французькою.

Силка
https://world.openfoodfacts.org/data/en.openfoodfacts.org.products.rdf.gz

Експорт даних зображення

Усі зображення та результати OCR можна завантажити з нашого сервера або з AWS (через програму відкритих даних AWS). Перегляньте нашу документацію, щоб дізнатися більше про те, як завантажувати зображення.

OpenAPI Documentation for the JSON API

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

Ми постійно вдосконалюємо API, але намагаємося підтримувати зворотну сумісність. Будь ласка, зв'яжіться з нами якщо ви використовуєте його, щоб ми могли повідомити вам про потенційні зміни.

URL для зчитування даних про товар: https://world.openfoodfacts.org/api/v2/product/[barcode].json

Наприклад: https://world.openfoodfacts.org/api/v3/product/737628064502.json

Зауважте, що якщо результат занадто великий, його можна відфільтрувати - як описано в документації до API.

Потрібна допомога OpenAPI

Ми прагнемо закінчити документування API, додати кейси використання та автоматизувати генерацію SDK. Якщо ви знавець OpenAPI, ми будемо раді вашій допомозі.

Ми дуже охочі до використання API для виробничих кейсів, доки 1 API = 1 справжньому скануванню користувача. Будь-яка спроба здерти базу даних використовуючи API буде ймовірно заблокованою, так як повний щоденний експорт саме на цій сторінці.

Також, надсилання HTTP заголовку з вашим викликом API є хорошим способом для нашого зв'язку, якщо виникне будь-яке питання.

Якщо ви в чомусь не впевнені, або маєте якесь питання (дурних питань не буває), не соромтеся задавати його на каналі #api в Slack :-)

Експериментальний XML API

Ви також можете отримати результат у форматі XML за допомогою .xml

Приклад: https://world.openfoodfacts.org/api/v2/product/737628064502.xml

Цей API активно не підтримується та офіційно не задокументований.

Обкладинки та SDK

Ми можливо маємо обкладинку для вашої улюбленої мови програмування. Якщо так, то ви можете використовувати її та покращувати. Якщо ні, ви можете допомогти створити її.

Вони дозволять вам споживати дані, так само і дозволять іншим користувачам вносити нові дані

Загальні користувачі, щоб зробити ваших користувачів щасливими

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

Якщо ваші користувачі не очікують результат одразу (на приклад додатки для інвентиризації)

  • Надсилайте фото (передня частина/харчування/інгредієнти): найбезболісніша річ для ваших користувачів
  • Штучний інтелект Open Food Facts - Robotoff, згенерує деякі похідні дані з фотографій
  • З часом, інші додатки та спільнота Open Food Facts заповнить прогалини даних

Якщо ваші користувачі очікують результат одразу (на приклад програми щодо харчування)

  • Надішліть інформацію про поживні речовини + категорію; отримайте Nutri-Score
  • Надішліть інгредієнти; отримайте групу NOVA (про ультраобробку продуктів), добавки, алергени, нормалізовані інгредієнти, веганські, вегетаріанські
  • Надішліть категорію + етикетки; незабаром отримайте Eco-Score (про вплив на навколишнє середовище)

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

Додаток дозволяє користувачам сканувати штрих-коди товарів, переглядати інформацію про товар, а також фотографувати й надсилати фотографії та дані про відсутні товари.

Вітається повторне використання вами коду (це відкрите джерело) та допомога нам у його покращенні, для кожного, по всій планеті.

SDK

Обговорення дати, API та експортів

Ви можете переглянути поширені запитання щодо API та експорту данихтапоширені запитання щодо Open Food Facts

Ви можете приєднатися до чату Open Food Facts у Slack який є найкращим способом поставити запитання та обговорити API. Будь ласка, ставте свої запитання на каналі #api

Ви можете відкрити потік у нашому репозиторії документації до API

З будь-яких питань щодо даних, з нами можна зв'язатися за адресою reuse@openfoodfacts.org