Aiutaci a informare milioni di consumatori in tutto il mondo su ciò che mangiano

group photo donation 2024
open food facts logo

Dona alla raccolta fondi 2024

Le tue donazioni finanziano le attività quotidiane della nostra associazione senza scopo di lucro:

  • mantenere il nostro database aperto e disponibile a tutti,
    • infrastruttura tecnica (sito web/app mobile) e un piccolo team permanente

  • rimanere indipendenti dall'industria alimentare,

  • coinvolgere la comunità di cittadini attivi,

  • sostenere il progresso della ricerca sulla salute pubblica.

Ogni donazione conta! Apprezziamo il tuo supporto nel portare maggiore trasparenza alimentare nel mondo.

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 fair use).

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

Parlaci del tuo riutilizzo

Siamo molto interessati ad apprendere per cosa sono usati i dati Open Food Facts. Non è obbligatorio, ma apprezzeremmo davvero tanto se ci parlassi dei tuoi riutilizzi, così che possiamo condividerli 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 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
https://static.openfoodfacts.org/data/en.openfoodfacts.org.products.csv.gz (CSV compresso in formato GZIP: ~ 0.9 Gb, decompresso: ~ 9 Gb)

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. 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 scoprire 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 è 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à. Ti preghiamo di contattarci se la utilizzi, così che possiamo comunicarti le 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/v3/product/737628064502.json

Nota che, se il risultato è troppo travolgente, puoi filtraarlo: come descritto nella documentazione dell'API.

Supporto di OpenAPI desiderato

Siamo impazienti 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.

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

API XML sperimentale

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

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

Cerchiamo di trasformare i sorgenti Kotlin e Swift deprecati in SDK Kotlin e Swift, un aiuto è ben accetto :-) L'app permette agli utenti di scansionare il codice a barre dei prodotti, per visualizzare le informazioni del prodotto e per scattare e inviare immagini e dati per i prodotti mancanti.

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

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 una discussione sulla repository della documentazione della nostra API

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