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 2025

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 Pet Food Facts è disponibile sotto la Licenza Open Database.
I singoli contenuti 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).

Sei pregato di leggere i Termini e le condizioni di utilizzo e riutilizzo, prima di riutilizzare i dati.

Parlaci del tuo riutilizzo

Siamo molto interessati a scoprire per cosa sono utilizzati i dati di Open Pet Food Facts. Non è obbligatorio, ma apprezzeremmo molto se ci parlassi dei tuoi riutilizzi, così che possiamo condividerli con la community di Open Pet Food Facts. Puoi anche compilare questo modulo per avere la possibilità di mettere in primo piano la tua app.

Esportazioni di dati da Open Pet 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.

Le informazioni sui diversi campi per il dump di MongoDB e le esportazioni CSV, sono disponibili a https://world.openpetfoodfacts.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.openpetfoodfacts.org/data/openpetfoodfacts-mongodbdump.gz
sha256sum
https://static.openpetfoodfacts.org/data/gz-sha256sum
md5sum
https://static.openpetfoodfacts.org/data/gz-md5sum

Esportazione Delta

Le esportazioni delta giornaliere sono fornite per i precedenti 14 giorni. Puoi trovare l'elenco di file delta attualmente disponibili su https://static.openbeautyfacts.org/data/delta/index.txt.

Ogni riga rappresenta un file disponibile in https://static.openpetfoodfacts.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.openpetfoodfacts.org/data/openpetfoodfacts-products.jsonl.gz

A suitable way to exploit the database is to use DuckDB, an in-processs analytical tool designed to process large amount of data in a fraction of seconds. Puoi leggere il nostro articolo sul blog con il quale ti guidiamo attraverso l'esplorazione e l'elaborazione del database di Open Pet Food Facts con DuckDB

Esportazione dati CSV

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

Collegamenti
L'app classica per iOS non è mai stata adattata né distribuita per gli alimenti per animali domestici.

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.openpetfoodfacts.org/data/en.openpetfoodfacts.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. Quest'API, in particolare, è utilizzata nell'app mobile di Open Pet Food Facts per iPhone e 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.

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

Esempio: https://world.openpetfoodfacts.org/api/v0/product/3600550578041.json

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

Supporto di OpenAPI desiderato

We're eager to finish the documentation of the API, add use-cases, and automate SDK generation. If you are an OpenAPI connoisseur, you are very welcome to help.

You are very welcome to use the API for production cases, as long as 1 API call = 1 real scan by a user. Any attempt to scrape the database using the API will very likely be blocked, as full daily exports are available on this very page.

Also, sending an HTTP header with your API call is a good way we can get in touch, should any issue arise.

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

API V2: Nuova documentazione di OpenAPI - Lavori in Corso

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.
  • Se non riesci a ottenere informazioni su un prodotto specifico, puoi chiedere all'utente di inviare foto e dati, che verranno poi elaborati dall'intelligenza artificiale di Open Pet Food Facts e dai collaboratori per ottenere il risultato che desideri mostrare loro.
  • È 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'intelligenza artificiale di Open Pet Food Facts - Robotoff - genererà alcuni dati derivati dalle foto
  • Col tempo, altre app e la community di Open Pet Food Facts colmeranno le lacune di dati

Se i tuoi utenti si aspettano un risultato immediato (ad es. app di allergie e alimentazione)

  • Invia ingredienti + categoria > ottieni analisi degli ingredienti, additivi, allergeni, ingredienti normalizzati, vegani, vegetariani…
  • Invia etichette per maggiori informazioni
  • Invia valori nutrizionali

App mobile per Android/iPhone/Flutter

The code for the current universal app called Open Food Facts is available on GitHub (Flutter. It can scan and add pet food. The legacy Open Pet Food Facts mobile app, still available for Android is built on Kotlin. The plan is to update it to a Open Pet Food Facts branded flavor of the Flutter app.

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

Kotlin Android and Swift 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.

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 Slack di Open Pet 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