Data

Betingelser for genbrug

OFF-databasen er tilgængelig under Open Database License.
Databasens individuelle indhold er tilgængeligt under Database Content License.
Produktfotos er tilgængelige under Creative Commons Attribution ShareAlike-licensen. De kan indeholde grafiske elementer underlagt ophavsret eller andre rettigheder, som i visse tilfælde må reproduceres (citatrettigheder eller fair brug).

Læs venligst Vilkår og betingelser for brug og genbrug før genbrug af ​​dataene.

Fortæl os om dit genbrug

Vi er meget interesserede i at erfare, hvad Open Food Facts-dataene anvendes til. Det er ikke et krav, men vi ville sætte stor pris på, hvis du fortæller os om dine genanvendelser, så vi kan dele dem med Open Food Facts-fællesskabet. Du kan også udfylde denne formular for at få en chance for at få din app fremhævet.

Open Food Facts-dataekport

Database-dumps og eksporter genereres hver nat. Databasen er meget stor, så du kan finde forskellige måder at bruge dataene på, afhængigt af eksporttypen.

Oplysninger om de forskellige felter til MongoDB-udtræk og CSV-eksport er tilgængelig via https://world.openfoodfacts.org/data/data-fields.txt

MongoDB-udtræk

Data til alle produkter er tilgængelig i et MongoDB-databaseudtræk.

Link

https://static.openfoodfacts.org/data/openfoodfacts-mongodbdump.gz

sha256sum

https://static.openfoodfacts.org/data/gz-sha256sum

md5sum

https://static.openfoodfacts.org/data/gz-md5sum

Deltaeksport

Daglig deltaeksporter er tilgængelige for de foregående 14 dage. Listen over aktuelt tilgængelige deltafiler kan findes på https://static.openfoodfacts.org/data/delta/index.txt.

Hver linje repræsenterer en fil, der er tilgængelig via https://static.openfoodfacts.org/data/delta/{filename}.

Filnavnet indeholder UNIX-tidsstempel for den første og sidste ændring i JSON-filen, så deltafilerne kan importeres (efter udtrækning) med mongoimport i alfabetisk rækkefølge.

Bemærk, at grundet funktionaliteten af ​​mongoexport kan deltafilerne ikke oplyse dig om slettede produkter. For at fjerne slettede produkter fra din database skal du importere det fulde MongoDB-dump.

CSV-dataeksport

Hele databasen er også tilgængelig i JSONL-format (undertiden betegnet LDJSON eller NDJSON), hvor hver linje er et JSON-objekt. Det repræsenterer de samme data som MongoDB-eksporten. Filen komprimeres med gzip.

Link

https://static.openfoodfacts.org/data/openfoodfacts-products.jsonl.gz

En passende måde at udnytte databasen på er at bruge DuckDB, et analyseværktøj designet til at behandle store mængder data på en brøkdel af et sekund. Du kan læse vores blogindlæg, hvor vi guider dig gennem udforskning og behandling af Open Food Facts-databasen med DuckDB

CSV-dataeksport

En forenklet version af JSONL-dumpen er også tilgængelig i Parquet-formatet. Under konverteringen filtrerede vi kolonner med duplikerede oplysninger, kolonner til intern fejlfinding eller kolonner, der var irrelevante for brugerne.

Parquet-formatet viser sig at være praktisk:

• Data is organized by column, rather than by row, which saves storage space and speeds up analytics queries, i.e. you can select just the columns you care about, optimizing query performances, even on entry-level computers.
• Highly efficient data compression and decompression, making it good for storing and sharing big datasets of any kind,
• Supports complex data types and advanced nested data structures.

The dataset is available on Hugging Face, a collaborative Machine Learning ecosystem where developers and researchers can share models and datasets.

Link

https://huggingface.co/datasets/openfoodfacts/product-database/resolve/main/food.parquet?download=true

Find more information in the Wiki, including guidelines for data reuse and example queries to get started.

CSV-dataeksport

Data for alle produkter, eller nogle af produkterne, kan hentes i CSV-format (kan læses med LibreOffice, Excel og mange andre regnearksprogrammer) via avanceret søgeformular.

Links

Fødevarer: https://static.openfoodfacts.org/data/en.openfoodfacts.org.products.csv.gz (komprimeret CSV i GZIP-format: ~ 0,9 Gb, ukomprimeret: ~ 9 Gb)

Kosmetik: https://static.openbeautyfacts.org/data/en.openbeautyfacts.org.products.csv.gz

Dyrefoder: https://static.openpetfoodfacts.org/data/en.openpetfoodfacts.org.products.csv.gz

Alle andre produkter: https://static.openproductsfacts.org/data/en.openproductsfacts.org.products.csv.gz

Filindkodningen er Unicode UTF-8. Skilletegn for felter er <tab> (tabulering).

Billeddataeksport

Databasen er også tilgængelig i RDF-formatet (dette er et eksperiment, der ikke længere vedligeholdes aktivt). Du kan læse meddelelsen på fransk.

Link

https://world.openfoodfacts.org/data/en.openfoodfacts.org.products.rdf.gz

Billeddataeksport

Alle billeder og OCR-resultater kan enten hentes fra vores server eller fra AWS (via AWS Open Data Program). Se vores dokumentation for at få mere at vide om, hvordan du henter billeder

OpenAPI Documentation for the JSON API

En JSON API er også tilgængelig til læsning af et produkts data. Denne API bruges især i Open Food Facts-mobilappen.

API'en forbedres over tid samtidig med, at bagudkompatibiliteten bevares. Kontakt os venligst, hvis du bruger det, så vi kan fortælle dig om eventuelle ændringer.

Oplev vores API

Bidrage til at forbedre vores API- og OpenAPI-dokumentation

Vi er ivrige efter at færdiggøre API-dokumentationen, tilføje brugsscenarier og automatisere SDK-generering. Hvis du har forstand på OpenAPI, er du meget velkommen til at hjælpe.

Du er meget velkommen til at bruge API'en til produktionsformål, så længe 1 API-kald = 1 rigtig scanning af en bruger. Ethvert forsøg på at skrabe databasen ved hjælp af API'et bliver højst sandsynligt blokeret, da fuld daglig eksport er tilgængelig på netop denne side.

At sende en HTTP-header med dit API-kald er også en god måde, hvorpå vi kan komme i kontakt, hvis der opstår problemer.

XML-API (understøttes ikke)

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

Denne API vedligeholdes ikke aktivt og er ikke officielt dokumenteret.

Wrappers og SDK'er

Vi har sandsynligvis en wrapper til dit yndlingsprogrammeringssprog. Har vi det, kan du bruge og forbedre den. Har vi ikke det, kan du hjælpe med at kreere den.

Du er velkommen til at genbruge kildekoderne (de er open-source) og hjælpe os med at forbedre dem for alle på hele planeten.

Generelle principper for at gøre dine brugere glade

• You can search for information about products, including many useful computed values.
• 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.

Forventer dine brugere et resultat straks (f.eks. ernærings-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

Android/iPhone/Flutter mobile app

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

Android/iPhone/Flutter mobile app

The code for the official Open Food Facts mobile apps is available on GitHub Flutter Kotlin Android Swift iOS

Vi ønsker at omdanne de forældede Kotlin- og Swift-kodebaser til Kotlin- og Swift-SDK'er. Hjælp er velkommen :-)

Du kan åbne en tråd på vores API-dokumentationsrepo

Du er velkommen til at genbruge kildekoderne (de er open-source) og hjælpe os med at forbedre dem for alle på hele planeten.

SDK'er

Ikon	Sprog / Framework	Ressourcer	Diskussion
	Cordova (gammel app)	GitHub	Ikke tilgængelig
	DART	GitHub pub.dev	Ikke tilgængelig
	Elixir	GitHub	Slack-kanal
	Gå	GitHub	Slack-kanal
	Java	GitHub	Slack-kanal
	Spring Boot	GitHub	Slack-kanal
	Kotlin	GitHub	Slack-kanal
	JavaScript	GitHub	Slack-kanal
	PHP	GitHub	Slack-kanal
	PHP (Laravel)	GitHub	Slack-kanal
	Python	GitHub	Slack-kanal
	React Native	GitHub	Slack-kanal
	Ruby	GitHub	Slack-kanal
	Rustfarvet	GitHub	Slack-kanal
	R	GitHub	Slack-kanal
	Swift	GitHub	Slack-kanal
	.NET/C#	GitHub	Slack-kanal

Debattere data, API og eksport

Du kan se på almindelige FAQ-spørgsmål om API og dataeksport og almindelige spørgsmål om Open Food Facts

Du kan deltage i Open Food Facts Slack-chatrummet, som er den foretrukne måde at stille spørgsmål og diskutere API. Stil venligst dine spørgsmål i #api-kanalen

Du kan åbne en tråd på vores API-dokumentationsrepository

Hvis du har spørgsmål vedrørende dataene, kan du kontakte os på reuse@openfoodfacts.org