Data
Conditions for reuse
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.
Tell us about your reuse
Vi er meget interesserede i at erfare, hvad Open Food Facts-dataene anvendes til. It is not mandatory, but we would very much appreciate it if you tell us about your re-uses so that we can share them with the Open Food Facts community. You can also fill this form to get a chance to get your app featured.
Open Food Facts-dataekport
Database-dumps og eksporter genereres hver nat. The database is very big, so you can find different ways to use the data, depending on the export flavor.
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. The list of currently available delta files can be found at 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}
.
The filename contains UNIX timestamp of the first and the last change contained in the JSON file, so that the delta files can be imported (after extraction) with mongoimport
in alphabetical order.
Bemærk, at grundet funktionaliteten af mongoexport
kan deltafilerne ikke oplyse dig om slettede produkter. To remove deleted products from your database, you will need to import the full 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.
CSV-dataeksport
Data for all products, or some of the products, can be downloaded in the CSV format (readable with LibreOffice, Excel and many other spreadsheet software) through the advanced search form.
- Links
- https://static.openfoodfacts.org/data/en.openfoodfacts.org.products.csv.gz (compressed CSV in GZIP format: ~ 0.9 Gb, uncompressed: ~ 9 Gb)
Filindkodningen er Unicode UTF-8. Skilletegn for felter er <tab> (tabulering).
RDF-dataeksport
Databasen er også tilgængelig i RDF-format. You can read the announcement in French.
Billeddataeksport
All images and OCR results can either be downloaded from our server or from AWS (through the AWS Open Data Program). Tjek dokumentationen for at læse mere om, hvordan billeder downloades.
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 mobil-appen (Android og iPhone).
API'en forbedres over tid samtidig med, at bagudkompatibiliteten bevares. Please get in touch if you use it, so that we can tell you about potential changes.
Eksempel: https://world.openfoodfacts.org/api/v2/product/737628064502.json
Example: https://world.openfoodfacts.org/api/v3/product/737628064502.json
Note that if the output is too overwhelming, you can filter it - as described in the API documentation.
OpenAPI help wanted
We're eager to finish the documentation of the API, add use-cases, and automate SDK generation. If you are an OpenAPI connoisseur, you are very welcome to help.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 eller ved spørgsmål (dumme af slagsen findes ikke), så tøv ikke med at spørge i #api-kanalen på Slack :-)
Experimental XML API
Resultatet kan også fås i XML ved at bruge .xml
Eksempel: https://world.openfoodfacts.org/api/v2/product/737628064502.xml
This API is not actively maintained, and not officially documented.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.
General principles to make your users happy
- You can search for information about products, including many useful computed values.
- 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)
- 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 tid vil andre apps og Open Food Facts-fællesskabet udfylde datahullerne
Forventer dine brugere et resultat straks (f.eks. ernærings-apps)
- 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
We look to turn the deprecated Kotlin and Swift codebases into Kotlin and Swift SDKs, help welcome :-)
Apperne lader brugere skanne produktstregkoder, se produktoplysninger samt tage og indsende fotos og data for manglende produkter.
Du er velkommen til at genbruge kildekoderne (de er open-source) og hjælpe os med at forbedre dem for alle på hele planeten.
SDKs
- Cordova: GitHub (gamle, officielle Open Food Facts-app)
- DART: GitHub
- Elixir: GitHub - Discussion channel
- Go: GitHub - Discussion channel
- Java: GitHub - Discussion channel
- Kotlin: GitHub - Discussion channel
- NodeJS: GitHub - Discussion channel
- PHP: GitHub - Discussion channel
- PHP (Laravel): GitHub - Discussion channel
- Python: GitHub - Discussion channel
- React Native: GitHub - Discussion channel
- Ruby: GitHub - Discussion channel
- Rust: GitHub - Discussion channel
- R: GitHub - Discussion channel
- Swift: GitHub - Discussion channel
- .NET/C#: GitHub - Discussion channel
Debattere data, API og eksport
You can look at common FAQ questions about the API and Data Exports and common Open Food Facts questions
You can join the Open Food Facts Slack chatroom which is the preferred way to ask questions and discuss the API. Please ask your questions in the #api channel
Du kan åbne en tråd på vores API-dokumentationsrepo
For any question regarding the data, you can contact us at reuse@openfoodfacts.org