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

CSV 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.

Lenker
https://static.openfoodfacts.org/data/en.openfoodfacts.org.products.csv.gz (compressed CSV in GZIP format: ~ 0.9 Gb, uncompressed: ~ 9 Gb)

Filkodingen er Unicode UTF-8. Karakteren som skiller felt er <tab> (tabulering).

RDF dataeksport

Databasen er også tilgjengelig i RDF-format. Du kan lese kunngjøringen på fransk.

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

Bildedataeksport

Alle bilder og OCR-resultater kan enten bli lastet ned fra vår server eller fra AWS (gjennom AWS Open Data Program). Sjekk ut vår dokumentasjon for å lære mer om hvordan du laster ned bilder.

OpenAPI Documentation for the JSON API

En JSON API er også tilgjengelig for å lese dataene til et produkt. Denne API-en brukes spesielt i Open Food Facts sin mobilapp for iPhone og Android.

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.

URL for å lese data for et produkt: https://world.openfoodfacts.org/api/v2/product/[barcode].json

Example: https://world.openfoodfacts.org/api/v3/product/737628064502.json

Merk at hvis utdataene er for overveldende, kan du filtrere den - som beskrevet i API-dokumentasjonen.

OpenAPI-hjelp ønskes

Vi er ivrige etter å fullføre dokumentasjonen av API-en, legge til bruksmønster, og automatisere SDK-generering. Hvis du er en OpenAI-kjenner, er du velkommen til å hjelpe til.

Du er velkommen til å bruke API-en for produksjonssaker, så lenge ett API-anrop = en reell skanning av en bruker. Ethvert forsøk på å skrape databasen ved hjelp av API-en vil sannsynligvis bli blokkert, siden komplette daglie eksporter er tilgjengelige på denne siden.

Det å sende en HTTP-header med API-anropet ditt er også en god måte å komme i kontakt, skulle det oppstå noen problemer.

Hvis du er usikker på noe, eller har noen spørsmål (det finnes ikke dumme spørsmål), er du velkommen til å spørre oss på #api kanalen på Slack :-)

Eksperimental XML API

Du kan også få resultatet i XML ved å bruke .xml

Eksempel: https://world.openfoodfacts.org/api/v2/product/737628064502.xml

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 ikke forventer et ummidelbart resultat (f.eks. Inventory-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

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

  • 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

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