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

Le esportazioni ed i dump del database sono generati di notte.

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 CSV

Dati per tutti i prodotti o alcuni dei prodotti, possono essere scaricati in formato CSV (leggibile con OpenOffice, Excel ed alcuni altri software) tramite il modulo di ricerca avanzata.

Collegamenti

https://static.openfoodfacts.org/data/en.openfoodfacts.org.products.csv

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

Esportazione dati 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.

Modifichiamo l'API nel tempo, ma stiamo attenti a mantenere la compatibilità con le versioni precedenti. Per favore, dicci se lo usi, così che possiamo dirti di potenziali cambiamenti.

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

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

Ulteriore documentazione è disponibile sulla Wiki. (Nota importante: la pagina è divisa in sottopagine per READ e WRITE). Una migliore documentazione è stata sviluppata, con l'uso di casi per mostrare un prodotto, e lasciando aggiungere i dati richiesti ai tuoi utenti, per ottenere il Nutri-Score, i gruppi NOVA e gli additivi. Puoi accedervi qui.

Sei il benvenuto ad utilizzare l'API per prodotti in produzione, finchè ogni richiesta sia stata prodotta da una scansione di un utente. Ogni tentativo di raschiare il database usando l'API sarà molto probabilmente bloccato, essendo le esportazioni giornaliere complete disponibili su questa pagina.

Inoltre, l'invio di un header HTTP con la tua chiamata API è un buon modo di contattarci, se si verificano problemi.

Se non sei sicuro di qualcosa o hai domande (non esistono domande stupide) sentiti libero di parlarne su Slack :-)

App mobile Android ed iPhone

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

L'app per iOS è sviluppata in Swift.

L'app per Android è sviluppata in Java.

Sei libero di riutilizzare il codice (è open source) e aiutarci a migliorarlo, per tutti, su tutto il pianeta.

Wrapper e SDK

Probabilmente abbiamo un wrapper per il tuo linguaggio di programmazione preferito. Se lo facciamo, puoi usarlo e migliorarlo. In caso contrario, puoi aiutarti a crearlo.

Ti permetteranno di utilizzare i dati, oltre a consentire ai tuoi utenti di fornire nuovi dati

• Cordova: GitHub (la vecchia app ufficiale di Open Food Facts)
• DART: GitHub
• Elixir: GitHub
• Go: GitHub
• NodeJS: GitHub
• PHP: GitHub
• PHP (Lararel): GitHub
• Python: GitHub
• React Native: GitHub
• Ruby: GitHub

Discutere di dati, API ed esportazioni

Puoi entrare nella chat room di Open Food Facts su Slack, la piattaforma consigliata per porre domande e discutere l'API.

Puoi anche unirti alla mailing list per discutere le API e le esportazioni, informarci sul tuo riutilizzo e essere avvisato quando vengono apportati miglioramenti o modifiche all'API. Invia un'e-mail vuota a api-subscribe@openfoodfacts.org per iscriverti.

Contatta

Per qualsiasi domanda relativa ai dati, puoi contattarci a contact@openfoodfacts.org