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 saremmo molto lieti se ci dicessi dei tuoi usi in modo da poterli condividere con la comunità Open Food Facts.

Esportazione dati Open Food Facts

I dump e le importazioni del database sono generati di notte. Il database è molto grande, quindi puoi trovare diversi modi per usare i dati, in base al tipo di esportazione.

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 dei dati in 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 dei dati in 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

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

Esportazione dei dati in RDF

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

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

API 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à. Per favore, dicci se lo usi, così che possiamo dirti di potenziali cambiamenti.

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

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

Ulteriore documentazione è disponibile qui. Contiene i casi d'uso per mostrare un prodotto e consentire agli utenti di aggiungere i dati necessari per ottenere il Nutri-Score, la classificazione NOVA, gli additivi e l'Eco-Score.

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 qualsiasi cosa, o hai qualche domanda (non esistono domande sciocche), sentiti libero di farle sul canale #api su Slack :-)

App mobile Android ed iPhone

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

L'app per iOS è disponibile in Swift.

L'app per Android è sviluppata in Kotlin.

Abbiamo anche uno sforzo continuativo di 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 (parte anteriore/nutrienti/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 i valori nutrizionali e la categoria > ottieni il Nutri-Score
  • Invia gli ingredienti > ottieni il gruppo NOVA (sull'ultra trasformazione alimentare), additivi, allergeni, ingredienti normalizzati, vegani, vegetariani…
  • Invia la categoria e le etichette > ottieni presto l'Eco-Score (sull'impatto ambientale)

Discutere di dati, API ed esportazioni

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

Puoi anche aderire alla mailing list per discutere dell'API e delle esportazioni, dirci dei tuoi riutilizzi ed essere notificato quando sono fatti miglioramenti o modifiche all'API. Invia un'email vuota a api-subscribe@openfoodfacts.org per iscriverti.

Contatta

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