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 er organiseret efter kolonne snarere end efter række, hvilket sparer lagerplads og fremskynder analyseforespørgsler, dvs. du kan vælge netop de kolonner, du holder af, og optimere forespørgselsydeevnen, selv på standard computere.
• Meget effektiv datakomprimering og dekomprimering, hvilket gør det godt til lagring og deling af store datasæt af enhver art,
• Understøtter komplekse datatyper og avancerede indlejrede datastrukturer.

Datasættet er tilgængeligt på Hugging Face, et kollaborativt økosystem for maskinlæring, hvor udviklere og forskere kan dele modeller og datasæt.

Link

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

Find flere oplysninger i Wikien, herunder retningslinjer for datagenbrug og eksempel på forespørgsler til at komme i gang.

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

• Du kan søge efter oplysninger om produkter, herunder mange nyttige beregnede værdier.
• DART: GitHub
• Det komplette flow kan også implementeres, så resultatet, med en vis indsats på deres side, får straks.

Forventer dine brugere et resultat straks (f.eks. ernærings-apps)

• Indsend billeder (forside/ernæring/ingredienser): det mest smertefrie for dine brugere
• Open Food Facts AI – Robotoff – vil generere nogle afledte data fra billederne
• Over tid vil andre apps og Open Food Facts-fællesskabet udfylde datahullerne

Android/iPhone/Flutter mobile app

• Indsend næringsindhold + kategori > få Nutri-Score
• Indsend ingredienser > få NOVA-gruppen (om ultraforarbejdning af fødevarer), tilsætningsstoffer, allergener, normaliserede ingredienser, vegansk, vegetarisk…
• Det individuelle indhold af databasen er tilgængeligt under <0>Database Contents License.<1/>

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
	NodeJS	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