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.

Lenke

https://static.openfoodfacts.org/data/openfoodfacts-products.jsonl.gz

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.

Lenke

https://huggingface.co/datasets/openfoodfacts/product-database/resolve/main/food.parquet?download=true

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.

Lenke

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

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 API

Contributing 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

• You can search for information about products, including many useful computed values.
• If you can't get the information on a specific product, you can get your user to send photos and data, that will then be processed by Open Food Facts AI and contributors to get the computed result you want to show them.
• You can also implement the complete flow so that they get immediately the result with some effort on their side.

Hvis brukerne dine forventer et umiddelbart resultat (f.ek.s Ernærings-apper)

• 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 time, other apps, and the Open Food Facts community will fill the data gaps

Android/iPhone/Flutter mobile app

• 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 :-)

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	Ikke aktuelt
	DART	GitHub pub.dev	Ikke aktuelt
	Elixir	GitHub	Slack Channel
	Go	GitHub	Slack Channel
	Java	GitHub	Slack Channel
	Spring Boot	GitHub	Slack Channel
	Kotlin	GitHub	Slack Channel
	JavaScript	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