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.
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.
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.
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 APIBidrage 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 License0>.<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