Register for the Open Food Facts Days 2023

Our annual community event Open Food Facts Days 2023 will take place this October in Paris! To be a part of it, REGISTER HERE

close

Dati

Il database di Open Food Facts è disponibile sotto la Licenza Open Database.
I contenuti individuali del database sono disponibili sotto la Licenza Database Contents.
Le immagini dei prodotti sono disponibili sotto la licenza Creative Commons Attribution ShareAlike. Potrebbero contenere elementi grafici soggetti a diritto di copia o altri diritti, che potrebbero in alcuni casi essere riprodotti (diritti di quotazione o fair use).

Si prega di leggere Termini e condizioni d'uso e riutilizzo prima di riutilizzare i dati.

Siamo molto interessati ad apprendere per cosa sono usati i dati Open Food Facts. Non è obbligatorio, ma apprezzeremmo molto se ci parlassi dei tuoi riutilizzi, così che possiamo condividerli con la community di Open Food Facts.

Esportazione dati Open Food Facts

I dump e le importazioni del database sono generati di notte. Il database è molto grande, puoi quindi trovare diversi modi per utilizzare i dati, a seconda dell'esportazione utilizzata.

Informazioni sui differenti campi per il dump di MongoDB e le esportazioni CSV sono disponibili a https://world.openfoodfacts.org/data/data-fields.txt

Dump di MongoDB

Dati per tutti i prodotti sono disponibili un un dump del database di MongoDB.

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

Esportazione Delta

Le esportazioni delta giornaliere sono fornite per i precedenti 14 giorni. L'elenco dei file delta attualmente disponibili può essere trovata a https://static.openfoodfacts.org/data/delta/index.txt. Ogni riga rappresenta un file che è disponibile a https://static.openfoodfacts.org/data/delta/{filename}. Il nome del file contiene un timestamp UNIX della prima e dell'ultima modifica contenuta nel file JSON, così che i file delta possano essere importati (dopo l'estrazione) con mongoimport in ordine alfabetico.

Si prega di notare che a causa della natura di mongoexport, i file delta non possono dirti di prodotti eliminati. Per rimuovere prodotti eliminati dal tuo database, dovrai importare l'intero dump di MongoDB.

Esportazione dati JSONL

L'intero database è anche disponibile in formato JSONL (a volte chiamato LDJSON o NDJSON) dove ogni riga è un oggetto in JSON. Rappresenta gli stessi dati dell'esportazione di MongoDB. Il file è compresso con gzip.

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

Esportazione dati CSV

I dati per tutti i prodotti, o alcuni dei prodotti, si possono scaricare in formato CSV (leggibile con OpenOffice, Excel e molti altri software) tramite il modulo di ricerca avanzata.

Collegamenti
https://static.openfoodfacts.org/data/en.openfoodfacts.org.products.csv (CSV grezzo)
https://static.openfoodfacts.org/data/en.openfoodfacts.org.products.csv.gz (CSV compresso in formato GZIP)

La codifica del file è Unicode UTF-8. Il carattere che separa i campi è <tab> (tabulazione).

Esportazione dei dati RDF

Il database è anche disponibile nel formato RDF. annuncio in francese.

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

Esportazione dei Dati dell'Immagine

Tutte le immagini e i risultati OCS possono essere scaricati dal nostro server o da AWS (tramite il Programma dei Dati Aperti di AWS). Consulta la nostra documentazione per scoprire di più su come scaricare le immagini.

API XML e JSON live

Un API JSON è anche disponibile per leggere i dati per un prodotto. Questa API è in particolare usata nell'app mobile di Open Food Facts per iPhone ed Android.

Miglioriamo l'API nel tempo ma siamo cauti nel mantenere la retrocompatibilità. Sei pregato di contattarci se lo utilizzi, così che possiamo parlarti delle potenziali modifiche.

URL per leggere i dati di un prodotto: https://world.openfoodfacts.org/api/v2/product/[barcode].json

Esempio: https://world.openfoodfacts.org/api/v2/product/737628064502.json

Puoi anche ottenere il risultato in XML usando .xml

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

Sei benvenuto all'uso dell'API per i casi di produzione, finché 1 chiamata dell'API equivale ad una scansione reale da un utente. Ogni tentativo di raschiare il database usando l'API sarà molto probabilmente bloccata, poiché le esportazioni giornaliere complete sono disponibili su questa pagina.

Inoltre, inviare un'intestazione HTTP con la tua chiamata dell'API è un buon modo in cui possiamo metterci in contatto, dovesse sorgere qualsiasi problema.

Se sei insicuro su qualcosa, o hai qualsiasi domanda (non esistono domande sciocche), sentiti libero di chiedere sul canale #api su Slack :-)

App mobile Android ed iPhone

Il codice per l'app mobile di Open Food Facts è disponibile su GitHub (Flutter, Android e iOS). L'app consente agli utenti di scansionare il codice a barre dei prodotti, di visualizzare le informazioni sul prodotto e di scattare e inviare foto e dati per i prodotti mancanti.

L'app classica per Android è sviluppata in Kotlin.

L'app classica per iOS è sviluppata in Swift.

La nuova app multipiattaforma è sviluppata in Dart/Flutter.

Sei il benvenuto per riutilizzare il codice (è open source) ed aiutarci a migliorarla, per tutti, su tutto il pianeta.

Wrapper e SDK

Abbiamo probabilmente un wrapper per il tuo linguaggio di programmazione preferito. Se lo abbiamo, puoi usarlo e migliorarlo. Altrimenti, puoi aiutare a crearlo.

Ti consentiranno di consumare i dati, così come consentiranno ai tuoi utenti di contribuire ai nuovi dati

Principi generali

  • Puoi cercare le informazioni sui prodotti, inclusi molti utili valori calcolati.
  • DART: GitHub
  • È inoltre possibile implementare il flusso completo in modo che ottengano immediatamente il risultato con un certo sforzo da parte loro.

Se i tuoi utenti non si aspettano un risultato immediato (ad es. app per l'inventario)

  • Invia foto (anteriore/nutrizione/ingredienti): la cosa più indolore per i tuoi utenti
  • L' Open Food Facts AI Robotoff genererà alcuni dati derivati dalle foto
  • Col tempo, altre app e la community di Open Food Facts colmeranno le lacune di dati

Se i tuoi utenti si aspettano un risultato immediato (ad es. app sull'alimentazione)

  • Invia valori nutrizionali + categoria > ottieni il Nutri-Score
  • Invia gli ingredienti > ottieni il gruppo NOVA (sull'ultra-trasformazione alimentare), additivi, allergeni, ingredienti normalizzati, vegano, vegetariano…
  • Invia categoria ed etichette > ottieni rapidamente l'Eco-Score (sull'impatto ambientale)

Discussione sui dati, sulle API e sulle esportazioni

Puoi aderire alla chatroom di Slack di Open Food Facts che è il modo preferito per fare domande e discutere delle API.

Puoi aprire una discussione sulla repository della documentazione della nostra API

Contatta

Per qualsiasi domanda riguardante i dati, puoi contattarci a contact@openfoodfacts.org