Auta meitä kertomaan miljoonille kuluttajille eri puolilla maailmaa siitä, mitä he syövät

group photo donation 2024
open food facts logo

Lahjoitathan meidän 2025 varainkeruuseen

Lahjoituksesi rahoittavat voittoa tavoittelemattoman yhdistyksemme päivittäiset toimet:

  • pitäen tietokantamme avoinna & kaikkien saatavilla,
    • tekninen infrastruktuuri (verkkosivusto/mobiilisovellus) & pieni pysyvä tiimi

  • pysyä riippumattomana elintarviketeollisuudesta,

  • saada mukaan sitoutuneiden kansalaisten yhteisö,

  • tukemaan kansanterveystutkimuksen edistämistä.

Jokainen lahjoitus on tärkeä! Arvostamme tukeasi elintarvikkeiden avoimuuden lisäämisessä maailmassa.

Tiedot

Uudelleenkäytön ehdot

Open Beauty Facts -tietokanta on saatavilla Open Database -lisenssillä.
Tietokannan yksittäinen sisältö on saatavilla Tietokannan sisältölisenssillä.
Tuotteen kuvat ovat saatavilla Creative Commons Attribution ShareAlike -lisenssillä. Ne saattavat sisältää tekijänoikeuden tai muun oikeuden alaisia graafisia elementtejä, jotka joissain tapauksissa saa kopioida (lainausoikeudet tai kohtuullinen käyttö).

Lue Käyttöehdot ja uudelleenkäyttö ennen tietojen uudelleenkäyttöä.

Kerro meille uudelleenkäytöstäsi

Olemme erittäin kiinnostuneita oppimaan, mihin Open Beauty Facts -tietoja käytetään. 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 Beauty Facts community. Voit myös täyttää tämän lomakkeen saadaksesi mahdollisuuden saada sovelluksesi esille.

Android- ja iPhone-mobiilisovellus (apua tarvitaan!)

Tietokantavedokset ja -viennit luodaan öisin. Tietokanta on erittäin suuri, joten voit löytää erilaisia tapoja käyttää tietojavientimausta riippuen.

Tietoja MongoDB-vedosten ja CSV-vientien eri kentistä on saatavilla osoitteessa https://world.openbeautyfacts.org/data/data-fields.txt

MongoDB-vedos

Kaikkien tuotteiden tiedot ovat saatavilla MongoDB tietokantavedoksena.

Linkki
https://static.openbeautyfacts.org/data/openbeautyfacts-mongodbdump.gz
sha256sum
https://static.openbeautyfacts.org/data/gz-sha256sum
md5sum
https://static.openbeautyfacts.org/data/gz-md5sum

Muutosten vienti

Päivittäiset muutosten viennit ovat saatavilla viimeiseltä 14:ltä päivältä. The list of currently available delta files can be found at https://static.openbeautyfacts.org/data/delta/index.txt.

Jokainen rivi edustaa tiedostoa, joka on saatavilla osoitteessa https://static.openbeautyfacts.org/data/delta/{filename}.

Tiedostonimi sisältää JSON-tiedoston ensimmäisen ja viimeisen muutoksen UNIX-aikaleiman, jotta delta-tiedostot voidaan tuoda (purkauksen jälkeen) mongoimport :lla aakkosjärjestyksessä.

Huomioi, että mongoexport-komennon luonteen takia muutostiedostot eivät voi kertoa poistetuista tuotteista. Jos haluat poistaa poistetut tuotteet tietokannastasi, sinun on tuotava koko MongoDB-vedos.

Tietojen CSV-vienti

Koko tietokanta on saatavilla myös JSONL-muodossa (joskus kutsutaan nimellä LDJSON tai NDJSON), jossa jokainen rivi on JSON-objekti. Se edustaa samoja tietoja kuin MongoDB-vienti. Tiedosto on pakattu gzip:llä.

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

Voit hyödyntää tietokantaa DuckDB:llä, joka on prosessinsisäinen analyyttinen työkalu, joka on suunniteltu käsittelemään suuria määriä dataa sekunnin murto-osassa. You can read our blog post where we walk you through exploring and processing the Open Beauty Facts database with DuckDB

Tietojen CSV-vienti

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.

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

Find more information in the Wiki, including guidelines for data reuse and example queries to get started.

Tietojen CSV-vienti

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.

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

Tiedoston merkistökoodaus on Unicode UTF-8. Kenttien erottimena on <sarkain>.

Kuvatietojen vienti

Tietokanta on myös saatavilla RDF-muodossa. Voit lukea ilmoituksen ranskaksi.

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

OpenAPI-apua kaivataan

Kaikki kuvat ja OCR-tulokset voidaan ladata joko palvelimeltamme tai AWS:stä (AWS Open Data Program -ohjelman kautta). Tutustu dokumentaatioomme saadaksesi lisätietoja miten ladata kuvia.

OpenAPI Documentation for the JSON API

Myös JSON API on saatavilla tuotteen tietojen lukemiseen. Tätä API:ta käytetään erityisesti Open Beauty Facts -mobiilisovelluksessa iPhonelle ja Androidille.

Parannamme ohjelmointirajapintaa ajan myötä, mutta huolehdimme yhteensopivuudesta aiempien versioiden kanssa. Please get in touch if you use it, so that we can tell you about potential changes.

URL to read data for a product: https://world.openbeautyfacts.org/api/v2/product/[barcode].json

Android-sovellus on kehitetty Kotlinilla.

Tulokset saa myös XML-muodossa päätteellä .xml

Kokeellinen XML API

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.

Voit liittyä Open Food Facts Slack -keskusteluryhmään, joka on ensisijainen tapa kysyä kysymyksiä ja keskustella API:sta.

Yleiset periaatteet käyttäjien ilahduttamiseksi

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

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

Tätä API:ta ei ylläpidetä aktiivisesti, eikä sitä ole dokumentoitu virallisesti.

Kääreet ja SDK

Meillä on todennäköisesti kääre lempiohjelmointikielellesi. Jos on, voit käyttää ja parantaa sitä. Jos ei ole, voit auttaa luomaan sen.

Voit uudelleen käyttää koodia (se on avointa lähdekoodia), ja auttaa meitä parantamaan sitä, kaikille, koko planeetalla.

Yleiset periaatteet käyttäjien ilahduttamiseksi

  • Voit etsiä tietoja tuotteista, mukaan lukien monia hyödyllisiä laskettuja arvoja.
  • Jos et saa tietoa tietystä tuotteesta, voit saada käyttäjäsi lähettämään valokuvia ja dataa, jotka Open Beauty Facts AI ja osallistujat käsittelevät heille näytettävien laskentatulosten saamiseksi.
  • Voit myös toteuttaa koko flown niin, että he saavat heti tuloksen pienellä vaivalla.

Jos käyttäjäsi eivät odota tulosta heti (esim. varastosovellukset)

  • Lähetä valokuvat (etu/ravinto/ainesosat): käyttäjillesi kivuton asia
  • The Open Beauty Facts AI - Robotoff - will generate some derived data from the photos
  • Over time, other apps, and the Open Beauty Facts community will fill the data gaps

If your users expect a result immediately (e.g. Allergy apps)

  • Submit ingredients + category > get Ingredient analysis, additives, allergens, normalized ingredients, vegan, vegetarian…
  • Submit labels for added value

SDK:t

The code for the Open Beauty Facts mobile app is available on GitHub (Flutter, Kotlin Android and Swift iOS).

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

Voit aloittaa viestiketjun ohjelmointirajapintadokumentaatiotietovarastossamme

Jos sinulla on kysyttävää datasta, voit ottaa meihin yhteyttä osoitteeseen reuse@openfoodfacts.org

SDK:t

Keskustelu tiedoista, API:sta ja vienneistä

Voit tarkastella yleisiä API:ta ja tietojen vientiä koskevia FAQ-kysymyksiä ja yleisiä Open Food Facts -kysymystä

You can join the Open Beauty Facts Slack chatroom which is the preferred way to ask questions and discuss the API. Ole hyvä esitä kysymyksesi #api kanavalla

Voit aloittaa viestiketjun ohjelmointirajapintadokumentaatiotietovarastossamme

Jos sinulla on kysyttävää datasta, voit ottaa meihin yhteyttä osoitteeseen reuse@openfoodfacts.org