Pomozte nám informovat miliony spotřebitelů po celém světě o tom, co jedí

Prosím, přispějte na naši sbírku 2026

Vaše dary financují každodenní provoz našeho neziskového sdružení:

udržovat naši databázi otevřenou a přístupnou všem,
- technická infrastruktura (web/mobilní aplikace) a malý stálý tým
zůstat nezávislí na potravinářském průmyslu,
zapojit komunitu angažovaných občanů,
podporovat pokrok ve výzkumu veřejného zdraví.

Každý dar se počítá! Vážíme si vaší podpory při zavádění další transparentnosti potravin ve světě.

Údaje

Podmínky pro opětovné použití

Databáze Open Pet Food Facts je dostupná pod licencí Open Database License.
Jednotlivé obsahy databáze jsou dostupné pod licencí Database Contents License.
Obrázky produktů jsou dostupné pod Creative Commons Attribution ShareAlike. Mohou obsahovat grafické prvky podléhající autorským právům nebo jiným právům, které mohou být v některých případech reprodukovány (práva na nabídky nebo fair use).

Před opětovným použitím dat si prosím přečtěte Podmínky použití a opětovného použití.

Řekněte nám o svém opětovném použití

Velmi nás zajímá zjištění, k čemu jsou využívány údaje Open Pet Food Fakt. Není to povinné, ale velmi bychom ocenili, kdybyste nás informovali o svých opakovaných použitích, abychom je mohli sdílet s komunitou Open Pet Food Facts. Můžete také vyplnit tento formulář a získat tak šanci, aby byla vaše aplikace doporučena.

Mobilní aplikace pro Android a iPhone (potřebujeme pomoc!)

Výpisy a exporty databáze se generují každou noc. Databáze je velmi velká, takže můžete najít různé způsoby, jak použít datav závislosti na variantě exportu.

Informace o různých polích pro výpis MongoDB a exporty CSV jsou k dispozici na adrese https://world.openpetfoodfacts.org/data/data-fields.txt

Výpis MongoDB

Data pro všechny produkty jsou k dispozici ve výpisu databáze MongoDB.

Odkaz: https://static.openpetfoodfacts.org/data/openpetfoodfacts-mongodbdump.gz
sha256sum: https://static.openpetfoodfacts.org/data/gz-sha256sum
md5sum: https://static.openpetfoodfacts.org/data/gz-md5sum

Delta Export

Denní delta exporty jsou poskytovány za předchozích 14 dní. Seznam aktuálně dostupných delta souborů naleznete na adrese https://static.openpetfoodfacts.org/data/delta/index.txt.

Každý řádek představuje soubor, který je k dispozici na adrese https://static.openpetfoodfacts.org/data/delta/{filename}.

Název souboru obsahuje UNIX časové razítko prvního a poslední změny obsažené v souboru JSON, aby delta soubory mohly být importovány (po extrakci) pomocí mongoimport v abecedním pořadí.

Vezměte prosím na vědomí, že vzhledem k povaze mongoexportvám delta soubory nemohou říci o smazaných produktech. Chcete-li odebrat odstraněné produkty z databáze, musíte importovat celý výpis MongoDB.

Export dat JSONL

Celá databáze je k dispozici také ve formátu JSONL (někdy nazývaném LDJSON nebo NDJSON), kde je každý řádek objektem JSON. Představuje stejná data jako export MongoDB. Soubor je komprimován pomocí gzip.

Odkaz: https://static.openpetfoodfacts.org/data/openpetfoodfacts-products.jsonl.gz

Vhodným způsobem využití databáze je použití DuckDB, analytického nástroje v procesu, který je navržen tak, aby zpracoval velké množství dat během zlomku sekundy. Můžete si přečíst náš příspěvek na blogu, kde vás provedeme průzkumem a zpracováním databáze Open Pet Food Facts pomocí DuckDB

Export dat RDF

Data pro všechny produkty nebo některé z nich lze stáhnout ve formátu CSV (čitelném v LibreOffice, Excelu a mnoha dalších tabulkových procesorech) prostřednictvím rozšířeného vyhledávacího formuláře.

Odkaz: https://static.openpetfoodfacts.org/data/en.openpetfoodfacts.org.products.csv.gz (komprimovaný CSV ve formátu GZIP: ~ 0,9 Gb, nekomprimovaný: ~ 9 Gb)

Kódování souboru je Unicode UTF-8. Znak, který odděluje pole, je <tab> (tabulka).

Export obrazových dat

Databáze je dostupná také ve formátu RDF. Můžete si přečíst oznámení ve francouzštině.

Odkaz: https://world.openpetfoodfacts.org/data/en.openpetfoodfacts.org.products.rdf.gz

Hledáme pomoc s OpenAPI

Všechny obrázky a výsledky OCR lze stáhnout z našeho serveru nebo z AWS (prostřednictvím AWS Open Data Program). Podívejte se na naši dokumentaci a zjistěte více o tom, jak stahovat obrázky.

Dokumentace OpenAPI pro JSON API

K dispozici je také JSON API pro čtení dat pro produkt. Toto rozhraní API se používá zejména v mobilní aplikaci Open Pet Food Facts pro iPhone a Android.

API v průběhu času vylepšujeme, ale dbáme na zachování zpětné kompatibility. Pokud ji používáte, ozvěte se nám, abychom vás mohli informovat o případných změnách.

Pokud si s něčím nevíte rady, nebo máte nějaký dotaz (není to žádná hloupá otázka), klidně se zeptejte na Slacku :-)

Příklad: https://world.openpetfoodfacts.org/api/v3/product/737628064502.json

Výsledek můžete také získat v XML pomocí .xml

API V3 - nová dokumentace OpenAPI - Work in Progress

Experimentální XML API

Těšíme se na dokončení dokumentace k API, přidání případů užití a automatizaci generování SDK. Pokud jste znalci OpenAPI, rádi si necháme pomoct.

API můžete používat i v produkčních aplikacích, pokud 1 volání API = 1 skutečné skenování uživatelem. Jakýkoli pokus o scraping databáze pomocí API bude s největší pravděpodobností zablokován, protože kompletní denní exporty jsou k dispozici na této stránce.

Také odeslání HTTP hlavičky s voláním API je dobrý způsob, jak se s vámi můžeme spojit, pokud by nastal jakýkoli problém.

Umožní vám spotřebovávat data a také umožní vašim uživatelům přispívat novými daty

Obecné zásady, aby byli vaši uživatelé spokojeni

Kódy pro oficiální mobilní aplikace Open Food Facts jsou dostupné na GitHubu: Flutter, Kotlin Android a Swift iOS

Umožní vám spotřebovávat data a také umožní vašim uživatelům přispívat novými daty

Toto API není aktivně udržováno a není oficiálně zdokumentováno.

Obaly a sady SDK

Pravděpodobně máme wrapper pro váš oblíbený programovací jazyk. Pokud ano, můžete to využít a vylepšit. Pokud ne, můžete pomoci s jeho vytvořením.

Můžete znovu použít kód (je to open source) a pomoci nám jej vylepšit, pro každého na celé planetě.

Obecné zásady, aby byli vaši uživatelé spokojeni

Můžete vyhledávat informace o produktech, včetně mnoha užitečných vypočtených hodnot.
DART: GitHub (zatím pouze Open Food Facts)
Můžete také implementovat kompletní tok tak, aby okamžitě získali výsledek s určitým úsilím na jejich straně.

Pokud vaši uživatelé neočekávají výsledek okamžitě (např. aplikace Inventory)

Odešlete fotografie (přední strana/výživa/ingredience): pro vaše uživatele naprosto bezbolestná věc
Umělá inteligence Open Pet Food Facts - Robotoff - vygeneruje z fotografií některé odvozené údaje
Postupem času doplní chybějící data další aplikace a komunita Open Pet Food Facts

Pokud uživatelé očekávají výsledek okamžitě (např. aplikace Výživa nebo Alergie)

Odeslat ingredience + kategorii > získat analýzu ingrediencí, aditiva, alergeny, normalizované ingredience, veganské, vegetariánské…
Odešlete štítky pro přidanou hodnotu
Odeslat výživu

SDK

Kód současné univerzální aplikace s názvem Open Food Facts je k dispozici na GitHubu (Flutter. Dokáže skenovat a přidávat krmivo pro domácí zvířata. Starší mobilní aplikace Open Pet Food Facts, která je stále k dispozici pro systém Android, je postavena na jazyce Kotlin. V plánu je aktualizovat ji na verzi aplikace Flutter pod značkou Open Pet Food Facts.

Snažíme se z deprecated Kotlin a Swift codebases udělat Kotlin a Swift SDK, pomoc vítána :-)

Kotlin Android a Swift iOS

Můžete otevřít vlákno v našem úložišti dokumentace API

V případě jakýchkoli dotazů ohledně údajů nás můžete kontaktovat na reuse@openfoodfacts.org