Data

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.

Vi er meget interesserede i at erfare, hvad Open Food Facts-dataene anvendes til. Det er ikke obligatorisk, men vi vil sætte stor pris på, at du fortæller os om dine genanvendelser, så vi kan dele dem med Open Food Facts-fællesskabet.

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 eksportsmåden.

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.tar.gz
sha256sum
https://static.openfoodfacts.org/data/sha256sum
md5sum
https://static.openfoodfacts.org/data/md5sum

Deltaeksport

Daglig deltaeksporter er tilgængelige for de foregående 14 dage. Listen over de aktuelt tilgængelige deltafiler fremgår via 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-tidsstempler for den første og den sidste ændring i JSON-filen, så deltafilerne kan importeres (efter ekstraktion) 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 et komplet MongoDB-udtræk.

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

RDF-dataeksport

Data for alle produkter, eller nogle heraf, kan downloades i CSV-format (læsbart med OpenOffice, Excel og meget anden software) via den avancerede søgeformular.

Link
https://static.openfoodfacts.org/data/en.openfoodfacts.org.products.csv

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

RDF-dataeksport

Databasen er også tilgængelig i RDF-format. meddelelse på fransk.

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

Live 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 mobil-appen (Android og iPhone).

API'en forbedres over tid, men bagudkompatibilitet tilstræbes bevaret. Fortæl os, hvis du bruger den, så vi kan fortælle dig om potentielle ændringer.

Eksempel: https://world.openfoodfacts.org/api/v0/product/737628064502.json

Eks.: https://world.openfoodfacts.org/api/v0/product/737628064502.json

Yderligere dokumentation er tilgængelig hér. Dokumentationen indeholder produktvisningscases, og lader dine brugere tilføje de nødvendige data for at se Nutri-Score, NOVA-klassificering, tilsætningsstoffer og Øko-Score.

Du er meget velkommen til at bruge API'en til produktionssager, så længe 1 API-kald = 1 reel skanning fra en bruger. Ethvert forsøg på "scrap" af databasen vha. API'en blokeres sandsynligvis, da fuld daglig eksport er tilgængelig fra netop denne side.

Hvis du er usikker på noget eller har spørgsmål (der findes ingen fjollede spørgsmål), er du velkommen til at stille dem på Slack :-)

I tvivlstilfælde (dumme spørgsmål findes ikke) er du velkommen til at spørge i #api-kanalen på Slack :-)

Android- og iPhone-app

Koden til Open Food Facts-apperne er tilgængelig via GitHub (Android og iOS). Appen lader brugerne skanne produktstregkoder, se produktoplysninger samt tage og indsende fotos og data til manglende produkter.

Android-appen er udviklet i Java.

Android-appen er udviklet i Kotlin.

Der er også en løbende Dart/Flutter-bestræbelse.

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

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 kan også deltage i Open Food Facts Slack-chatroom, som er den foretrukne måde at stille spørgsmål på og debattere API'en.

Generelle principper

  • Du kan søge efter produktoplysninger, 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.

Hvis dine brugere ikke forventer et resultat med det samme (f.eks. lager-apps)

  • Indsend fotos (forside/ernæring/ingredienser): Den mest bekvemme måde for dine brugere
  • Open Food Facts AI Robotoff genererer nogle afledte data fra fotoene
  • Over tid vil andre apps og Open Food Facts-fællesskabet udfylde datahullerne

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

  • Indsend ernæringsfakta + kategori > få Nutri-Score
  • Indsend ingredienser > hent NOVA-gruppen (ultraforarbejdning af fødevarer), tilsætningsstoffer, allergener, normaliserede ingredienser, vegan, vegetar…
  • Indsend kategori + etiketter > få snart Øko-Score (miljøpåvirkning)

Debattere data, API og eksport

Du kan deltage i Open Food Facts Slack-chatrum, der er den foretrukne måde til spørgsmål og debat af API'en.

Du kan også komme på mailinglisten mhp. at diskutere API'en og eksporter, fortælle os om dine genbrug og blive underrettet, når der foretages forbedringer eller ændringer i API'en. Send en tom e-mail til api-subscribe@openfoodfacts.org for at abonnere.

Kontakt

For ethvert spørgsmål vedr. dataene kan du kontakte os på contact@openfoodfacts.org