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

group photo donation 2024
open food facts logo

Pyydän teitä antamaan meidän 2025 varainkeruulle

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 Food Facts -tietokanta on Open Database License -lisenssin alaisuudessa.
Tietokannan yksilöllinen sisältö on Database Contents License -lisenssin alaisuudessa.
Tuotekuvat ovat Creative Commons Attribution ShareAlike licence -lisenssin alaisuudessa. Ne saattavat sisältää tekijänoikeuden tai muun oikeuden alaisia graafisia elementtejä, jotka joissain tapauksissa saa kopioida (lainausoikeudet tai kohtuullinen käyttö).

Lue Käytön ja uudelleenkäytön ehdot ja edellytykset ennen kuin uudelleen käytät tietoja.

Kerro meille uudelleenkäytöstäsi

Olemme erittäin kiinnostuneita oppimaan mihin Open Food Facts -tietoja käytetään. Se ei ole pakollista, mutta olisimme erittäin kiitollisia, jos kerrot meille uudelleenkäytöstäsi jotta voimme jakaa ne Open Food Facts -yhteisön kanssa. Voit myös täyttää tämän lomakkeen saadaksesi mahdollisuuden saada sovelluksesi esille.

Open Food Facts -tietojen viennit

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

Tietoa MongoDB-vedoksen ja CSV-vientien eri kentistä on saatavilla osoitteesta https://world.openfoodfacts.org/data/data-fields.txt

MongoDB-vedos

Kaikkien tuotteiden tiedot ovat saatavilla MongoDB tietokantavedoksena.

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

Muutosten vienti

Päivittäiset muutosten viennit ovat saatavilla viimeiseltä 14:ltä päivältä. Luettelo tällä hetkellä saatavilla olevista deltatiedostoista löytyy osoitteesta https://static.openfoodfacts.org/data/delta/index.txt.

Jokainen rivi vastaa tiedostoa, joka on saatavilla osoitteesta https://static.openfoodfacts.org/data/delta/{tiedostonnimi}.

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.openfoodfacts.org/data/openfoodfacts-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. Blogipostauksessamme kerrotaan, miten Open Food Factsin tietokantaa voi käyttää DuckDB:n avulla

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/food.parquet?download=true

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

Tietojen CSV-vienti

Kaikkien tuotteiden tai joidenkin tuotteiden tiedot voidaan ladata CSV-muodossa (luettavissa LibreOfficella, Excelillä ja monilla muilla taulukkolaskentaohjelmilla) tarkennetun hakulomakkeenkautta.

Linkki
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

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

Kuvatietojen vienti

The database is also available in the RDF format (this is an experiment, not actively maintained anymore). Voit lukea ilmoituksen ranskaksi.

Linkki
https://world.openfoodfacts.org/data/en.openfoodfacts.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). Check out our documentation to learn more about how to download images

OpenAPI Documentation for the JSON API

Myös JSON API on saatavilla tuotteen tietojen lukemiseen. This API is in particular used in the Open Food Facts mobile app.

Parannamme ohjelmointirajapintaa ajan myötä, mutta huolehdimme yhteensopivuudesta aiempien versioiden kanssa. ota yhteyttä jos käytät sitä, jotta voimme kertoa sinulle mahdollisista muutoksista.

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

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 tietoja tietystä tuotteesta, voit pyytää käyttäjää lähettämään valokuvia ja tietoja, jotka sitten Open Food Facts AI ja avustajat käsittelevät saadakseen lasketun tuloksen, jonka haluat näyttää heille.
  • 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
  • Open Food Facts AI - Robotoff - tuottaa valokuvista johdettuja tietoja
  • Ajan myötä muut sovellukset ja Open Food Facts -yhteisö täyttävät tietoaukot

Android/iPhone/Flutter mobile app

  • Lähetä ravitsemustiedot + kategoria > saat Nutri-Scoren
  • Ilmoita ainesosat > hanki NOVA-ryhmä (ruoan ultraprosessoinnista), lisäaineet, allergeenit, normalisoidut ainesosat, vegaani, vegetaari…
  • Lähetä luokka + tunnisteet > saat pian Eco-Scoren (ympäristövaikutuksista)

SDK:t

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

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

Icon Language / Framework Resursseja 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
Ruosteenvärinen GitHub Slack Channel
R GitHub Slack Channel
Swift GitHub Slack Channel
.NET/C# GitHub Slack Channel

Keskustelu tiedoista, API:sta ja vienneistä

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

Voit Open Food Facts Slack -keskusteluhuoneeseen, joka on suositeltu tapa esittää kysymyksiä ja keskustella API:sta. Ole hyvä esitä kysymyksesi #api kanavalla

You can open a thread on our API documentation repository

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