Dati

Condizioni per il riutilizzo

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 diritti d'autore).

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

Parlaci del tuo riutilizzo

Siamo molto interessati a sapere come sono usati i dati Open Food Facts. Non è obbligatorio, ma apprezzeremmo davvero tanto se ci parlassi dei tuoi riutilizzi, così da poterli condividere con la community di Open Food Facts. Puoi anche compilare questo modulo per avere la possibilità di mettere in primo piano la tua app.

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.gz

sha256sum

https://static.openfoodfacts.org/data/gz-sha256sum

md5sum

https://static.openfoodfacts.org/data/gz-md5sum

Esportazione Delta

Le esportazioni delta giornaliere sono fornite per i precedenti 14 giorni. L'elenco dei file delta correntemente disponibili si può trovare su 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 la marca oraria UNIX della prima e dell'ultima modifica contenute 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 i prodotti eliminati dal tuo database, dovrai importare il dump completo 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

Un modo adatto per utilizzare il database è DuckDB, uno strumento analitico in-process progettato per elaborare grandi quantità di dati in una frazione di secondi. Puoi leggere il nostro articolo sul blog con il quale ti guidiamo attraverso l'esplorazione e l'elaborazione del database di Open Food Facts con DuckDB

Esportazione dati Parquet su Hugging Face

Una versione semplificata dell'esportazione JSONL è disponibile anche nel formato Parquet. Durante la conversione, abbiamo filtrato le colonne che contengono informazioni duplicate, che vengono utilizzate per le verifiche interne o che semplicemente non sono rilevanti per gli utenti.

Il formato Parquet ha dimostrato di essere utile:

• I dati sono organizzati per colonna anziché per riga, il che consente di risparmiare spazio di archiviazione e velocizzare le query analitiche, ad esempio è possibile selezionare solo le colonne di proprio interesse, ottimizzando le prestazioni delle query anche su computer meno performanti.
• Compressione e decompressione dei dati altamente efficiente, il che lo rende adatto per l'archiviazione e la condivisione di grandi quantità di dati di qualsiasi tipo,
• Supporta tipi di dati complessi e strutture dati nidificate avanzate.

Il dati sono disponibili su Hugging Face, un ecosistema collaborativo per l'apprendimento automatico in cui sviluppatori e ricercatori possono condividere modelli e dati.

Collegamenti

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

Trova maggiori informazioni nella Wiki, comprese le linee guida per il riutilizzo dei dati e le query di esempio per iniziare.

Esportazione dati CSV

I dati per tutti i prodotti, o per alcuni dei prodotti, sono scaricabili nel formato CSV (leggibile con LibreOffice, Excel e molti altri software di fogli di calcolo), tramite il modulo di ricerca avanzato.

Collegamenti

Cibi: https://static.openfoodfacts.org/data/en.openfoodfacts.org.products.csv.gz (CSV compresso in formato GZIP: ~ 0.9 Gb, Non compresso: ~ 9 Gb)

Cosmetici: https://static.openbeautyfacts.org/data/en.openbeautyfacts.org.products.csv.gz

Cibo per animali: https://static.openpetfoodfacts.org/data/en.openpetfoodfacts.org.products.csv.gz

Ogni altro prodotto: https://static.openproductsfacts.org/data/en.openproductsfacts.org.products.csv.gz

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

Esportazione dei dati RDF

Il database è disponibile anche nel formato RDF (si tratta di un esperimento, non più gestito attivamente). Puoi leggere l'annuncio in francese.

Collegamenti

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

Esportazione dei Dati dell'Immagine

Tutte le immagini e i risultati OCR sono scaricabili dal nostro server o da AWS (tramite il Programma Open Data di AWS). Consulta la nostra documentazione per saperne di più su come scaricare le immagini

Documentazione di OpenAPI per l'API di JSON

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

Miglioriamo l'API nel tempo ma siamo cauti nel mantenere la retrocompatibilità. Ti preghiamo di contattarci se la utilizzi, così che possiamo comunicarti le potenziali modifiche.

Scopri la nostra API

Contribuendo a migliorare la nostra documentazione API e OpenAPI

Non vediamo l'ora di terminare la documentazione dell'API, aggiungere i casi d'uso e automatizzare la generazione di SDK. Se sei un conoscitore di OpenAPI, sei benvenuto ad aiutare.

L'API può essere utilizzata anche per casi di produzione, a patto che 1 chiamata API = 1 scansione reale da parte di un utente. Qualsiasi tentativo di estrarre i dati dal database tramite l'API verrà molto probabilmente bloccato, poiché le esportazioni giornaliere complete sono disponibili proprio 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.

API XML (non supportata)

Puoi anche ottenere il risultato in XML usando .xml

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

Quest'API non è mantenuta attivamente e non è documentata ufficialmente.

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 per rendere felici gli utenti

• 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 si aspettano un risultato immediato (ad es. app sull'alimentazione)

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

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

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

App mobile per Android/iPhone/Flutter

Il codice per le app mobili ufficiali di Open Food Facts è disponibile su GitHub Flutter Kotlin Android Swift iOS

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

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.

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

SDK

Icona	Lingua/schermata	Risorse	Discussione
	Cordova (vecchia applicazione)	GitHub	N/D
	DART	GitHub pub.dev	N/D
	Elisir	GitHub	Canale Slack
	Vai	GitHub	Canale Slack
	Java	GitHub	Canale Slack
	Avvio Primavera	GitHub	Canale Slack
	Kotlin	GitHub	Canale Slack
	JavaScript	GitHub	Canale Slack
	PHP	GitHub	Canale Slack
	PHP (Laravel)	GitHub	Canale Slack
	Python	GitHub	Canale Slack
	React Native	GitHub	Canale Slack
	Ruby	GitHub	Canale Slack
	Ruggine	GitHub	Canale Slack
	R	GitHub	Canale Slack
	Swift	GitHub	Canale Slack
	.NET/C#	GitHub	Canale Slack

Discussione sui dati, sulle API e sulle esportazioni

Puoi consultare le Domande frequenti comuni sull'APi e le Esportazioni di dati e le domande comuni su Open Food Facts

Puoi unirti alla chatroom di Slack di Open Food Facts, il metodo preferito per porre domande e discutere dell'API. Ti preghiamo di porre le tue domande nel canale #api

Puoi aprire un thread sul nostro repository di documentazione API

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