Data
Vilkår for gjenbruk
Open Food Facts-databsen er tilgjengelig under Open Database License.
Det enkelte innholdet i databasen er også tilgjengelig under Database Contents License.
Produktbilder er tilgjengelige under Creative Commons Attribution ShareAlike-lisensen.
De kan inneholde grafiske elementer som er underlagt opphavsrett eller andre rettigheter, som i noen tilfeller kan bli reprodusert (sitatrettigheter eller rimelig bruk).
Vennligst les Vilkår og betingelser for bruk og gjenbruk før du gjenbruker dataene.
Fortell oss om gjenbruken din
Vi er veldig interessert i å lære om hva Open Food Facts-dataene brukes til. Det er ikke obligatorisk, men vi vil sette stor pris på det om du forteller oss om dine gjenbruk sånn at vi kan dele dem med Open Food Facts-fellesskapet. Du kan også fylle ut dette skjemaet for en sjanse til å få appen din fremhevet.
Open Food Facts dataeksport
Databasedumper og eksporter genereres hver natt. Databasen er svært stor, så du kan finne forskjellige måter å bruke dataene, avhengig av eksporttypen.
Informasjon om de forskjellige feltene for MongoDB-dumpen og CSV-eksporter er tilgjengelig på https://world.openfoodfacts.org/data/data-fields.txt
MongoDB dump
Data for alle produkter er tilgjengelige i en MongoDB database-dump.
- Lenke
- https://static.openfoodfacts.org/data/openfoodfacts-mongodbdump.gz
- sha256sum
- https://static.openfoodfacts.org/data/gz-sha256sum
- md5sum
- https://static.openfoodfacts.org/data/gz-md5sum
Delta Export
Daglige deltaeksporter blir gitt for de foregående 14 dagene. Listen over foreløpig tilgjengelige deltafiler finner du på https://static.openfoodfacts.org/data/delta/index.txt.
Hver linje representerer en fil som er tilgjengelig på https://static.openfoodfacts.org/data/delta/{filename}.
Filnavnet inneholder et UNIX-tidsstempel for den første og siste endringen som JSON-filen inneholder, sånn at deltafilene kan bli importert (etter utpakning) med mongoimport i alfabetisk rekkefølge.
Vær oppmerksom på at på grunn av karakteren til mongoexport, kan ikke deltafilene fortelle deg om slettede produkter. For å fjerne slettede produkter fra databasen din, må du importere hele MongoDB-dumpen.
JSONL dataeksport
Hele databasen er også tilgjengelig i JSONL-format (noen ganger kalt LDJSON eller NDJSON) hvor hver linje er et JSON-objekt. Det representerer samme data som MongoDB-eksporten. Filen er komprimert med gzip.
A suitable way to exploit the database is to use DuckDB, an in-process analytical tool designed to process large amount of data in a fraction of seconds. You can read our blog post where we walk you through exploring and processing the Open Food Facts database with DuckDB
CSV dataeksport
A simplified version of the JSONL dump is also available in the Parquet format. During the conversion, we filtered columns that contains duplicated information, are used for internal debugging, or are simply irrelevant for users.
The Parquet format has proved to be handy:
- Data is organized by column, rather than by row, which saves storage space and speeds up analytics queries, i.e. you can select just the columns you care about, optimizing query performances, even on entry-level computers.
- Highly efficient data compression and decompression, making it good for storing and sharing big datasets of any kind,
- Supports complex data types and advanced nested data structures.
The dataset is available on Hugging Face, a collaborative Machine Learning ecosystem where developers and researchers can share models and datasets.
Find more information in the Wiki, including guidelines for data reuse and example queries to get started.RDF dataeksport
Data for alle produkter, eller noen av produktene, kan bli lastet ned i CSV-format (leselig med LibreOffice, Excel og mange andre regnearkprogrammer) gjennom det avanserte søkeskjemaet.
- Lenke
- Food: https://static.openfoodfacts.org/data/en.openfoodfacts.org.products.csv.gz (compressed CSV in GZIP format: ~ 0.9 Gb, uncompressed: ~ 9 Gb)
- Cosmetics: https://static.openbeautyfacts.org/data/en.openbeautyfacts.org.products.csv.gz
- Pet Food: https://static.openpetfoodfacts.org/data/en.openpetfoodfacts.org.products.csv.gz
- All other products: https://static.openproductsfacts.org/data/en.openproductsfacts.org.products.csv.gz
Filkodingen er Unicode UTF-8. Karakteren som skiller felt er <tab> (tabulering).
Bildedataeksport
The database is also available in the RDF format (this is an experiment, not actively maintained anymore). Du kan lese kunngjøringen på fransk.
OpenAPI-hjelp ønskes
Alle bilder og OCR-resultater kan enten bli lastet ned fra vår server eller fra AWS (gjennom AWS Open Data Program). Check out our documentation to learn more about how to download images
OpenAPI Documentation for the JSON API
En JSON API er også tilgjengelig for å lese dataene til et produkt. This API is in particular used in the Open Food Facts mobile app.
Vi forbedrer API-en over tid, men vi er nøye med å beholde bakoverkompatibilitet. Vennligst ta kontakt hvis du bruker den, sånn at vi kan fortelle deg om eventuelle endringer.
Discover our APIContributing to improving our API and OpenAPI documentation
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.
You are very welcome to use the API for production cases, as long as 1 API call = 1 real scan by a user. Any attempt to scrape the database using the API will very likely be blocked, as full daily exports are available on this very page.
Also, sending an HTTP header with your API call is a good way we can get in touch, should any issue arise.
XML API (unsupported)
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-en blir ikke aktivt vedlikeholdt, og er ikke offisielt dokumentert.Wrappers og SDK-er
Vi har sannsynligvis en wrapper for ditt favorittprogrammeringsspråk. Hvis vi har det, så kan du bruke den og forbedre den. Hvis vi ikke har det, kan du hjelpe oss med å lage den.
De lar deg forbruke data, samt at de lar brukerne dine bidra med nye data
Generelle prinsipper for å gjøre brukerne dine fornøyde
- Du kan søke etter informasjon om produkter, inkludert mange nyttige beregnede verdier.
- DART: GitHub
- Du kan også implementere hele flowen slik at de får resultatet med en gang med litt innsats fra deres side.
Hvis brukerne dine forventer et umiddelbart resultat (f.ek.s Ernærings-apper)
- Send inn bilder (forside/ernæring/ingredienser): det mest plagefrie for brukerne dine
- Open Food Facts KI - Robotoff - vil generere noen avledede data fra bildene
- Over tid vil andre apper og Open Food Facts-fellesskapet fylle inn datahullene
Android/iPhone/Flutter mobile app
- Send inn ernæringsfakta + kategori > få Nutri-Score
- Send inn ingredienser > få NOVA-gruppa (om ultrabearbeiding av mat), tilsetningsstoffer, allergener, normaliserte ingredienser, vegansk, vegetariansk…
- Send inn kategori + etiketter > få Eco-Scoren (om miljømessig påvirkning) snart
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 :-)
The app allows users to scan the barcode of products, to view the product information, and to take and submit pictures and data for missing products.
You are welcome to reuse the code (it's open source) and help us improve it, for everyone, on all the planet.
SDKs
| Icon | Language / Framework | Ressurser | Discussion |
|---|---|---|---|
| Cordova (Old App) | GitHub | N/A | |
| DART | GitHub pub.dev | N/A | |
| Elixir | GitHub | Slack Channel | |
| Go | GitHub | Slack Channel | |
| Java | GitHub | Slack Channel | |
| Spring Boot | GitHub | Slack Channel | |
| Kotlin | GitHub | Slack Channel | |
| NodeJS | GitHub | Slack Channel | |
| PHP | GitHub | Slack Channel | |
| PHP (Laravel) | GitHub | Slack Channel | |
| Python | GitHub | Slack Channel | |
| React Native | GitHub | Slack Channel | |
| Ruby | GitHub | Slack Channel | |
| Rust | GitHub | Slack Channel | |
| R | GitHub | Slack Channel | |
| Swift | GitHub | Slack Channel | |
| .NET/C# | GitHub | Slack Channel |
Discussing data, API and exports
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
You can open a thread on our API documentation repository
For any question regarding the data, you can contact us at reuse@openfoodfacts.org