Hjælp os med at informere millioner af forbrugere rundt om i verden om, hvad de spiser

group photo donation 2024
Open Food Facts logo

Giv venligst til vores 2026 Fundraiser

Dine donationer finansierer den daglige drift af vores non-profit forening:

  • holde vores database åben og tilgængelig for alle,
    • teknisk infrastruktur (hjemmeside/mobilapp) & et lille fast team

  • forblive uafhængig af fødevareindustrien,

  • engagere et fællesskab af engagerede borgere,

  • støtte forskning inden for folkesundhed.

Hver donation tæller! Vi sætter pris på din støtte til at bringe yderligere fødevaregennemsigtighed i verden.

Data

Betingelser for genbrug

Open Beauty Facts-databasen er tilgængelig under Open Database-licensen.
Det enkelte indhold i databasen er tilgængeligt under Database Contents-licensen.
Produktbilleder 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 du genbruger dataene.

Fortæl os om dit genbrug

Vi er meget interesserede i at lære, hvad Open Beauty Facts-data bruges til. Det er ikke et krav, men vi vil sætte stor pris på, hvis du fortæller os om dine genbrug, så vi kan dele dem med Open Beauty Facts-fællesskabet. Du kan også udfylde denne formular for at få en chance for at få din app fremhævet.

Open Beauty Facts-dataeksport

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-dump og CSV-eksport er tilgængelige på https://world.openbeautyfacts.org/data/data-fields.txt

MongoDB-udtræk

Data til alle produkter er tilgængelig i et MongoDB-databaseudtræk.

Link
https://static.openbeautyfacts.org/data/openbeautyfacts-mongodbdump.gz
sha256sum
https://static.openbeautyfacts.org/data/gz-sha256sum
md5sum
https://static.openbeautyfacts.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.openbeautyfacts.org/data/delta/index.txt.

Hver linje repræsenterer en fil, der er tilgængelig på https://static.openbeautyfacts.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.

Link
https://static.openbeautyfacts.org/data/openbeautyfacts-products.jsonl.gz

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

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

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
https://static.openbeautyfacts.org/data/en.openbeautyfacts.org.products.csv.gz (komprimeret CSV i GZIP-format: ~ 0,9 Gb, ukomprimeret: ~ 9 Gb)

Filindkodningen er Unicode UTF-8. Skilletegn for felter er <tab> (tabulering).

Billeddataeksport

Databasen er også tilgængelig i RDF-format. Du kan læse meddelelsen på fransk.

Link
https://world.openbeautyfacts.org/data/en.openbeautyfacts.org.products.rdf.gz

Billeddataeksport

Alle billeder og OCR-resultater kan enten hentes fra vores server eller fra AWS (via 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 Beauty Facts-mobilappen til iPhone og Android.

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.

URL til datalæsning for et produkt: https://world.openbeautyfacts.org/api/v2/product/[stregkode].json

The app for Android is developed in Kotlin.

Bemærk, at hvis outputtet er for overvældende, kan du filtrere det – som beskrevet i API-dokumentationen.

Hjælp til OpenAPI søges

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.

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.

Eksperimentel XML-API

The code for the official Open Food Facts mobile apps is available on GitHub Flutter Kotlin Android Swift iOS

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

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 (Open Food Facts only at the moment)
  • 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 Beauty Facts AI – Robotoff – vil generere nogle afledte data fra billederne
  • Over tid vil andre apps og Open Beauty Facts-fællesskabet udfylde datahullerne

Hvis dine brugere forventer et resultat med det samme (f.eks. allergiapps)

  • Indsend ingredienser + kategori > få ingrediensanalyse, tilsætningsstoffer, allergener, normaliserede ingredienser, vegansk, vegetarisk…
  • Indsend etiketter for at få merværdi

Android/iPhone/Flutter mobile app

Koden til Open Beauty Facts-mobilappen er tilgængelig på GitHub (Flutter, Kotlin Android og Swift iOS).

We look to turn the deprecated Kotlin and Swift codebases into Kotlin and Swift SDKs, help welcome :-)

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

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 Beauty 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-dokumentationsrepo

Hvis du har spørgsmål vedrørende dataene, kan du kontakte os på reuse@openfoodfacts.org