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.
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.
Filindkodningen er Unicode UTF-8. Skilletegn for felter er <tab> (tabulering).
RDF-dataeksport
Databasen er også tilgængelig i RDF-format. meddelelse på fransk.
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)
- Cordova: GitHub (gamle, officielle Open Food Facts-app)
- DART: GitHub
- Elixir: GitHub
- Go: GitHub
- NodeJS: GitHub
- PHP: GitHub
- PHP (Lararel): GitHub
- Python: GitHub
- React Native: GitHub
- Ruby: GitHub
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