Dati

Condizioni per il riutilizzo

Il database di Open Beauty Facts è disponibile sotto la Licenza Open Database.
I singoli contenuti del database sono disponibili sotto la Licenza dei Contenuti del Database.
Le immagini dei prodotti sono disponibili sotto la Licensa 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).

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 Beauty Facts. Non è obbligatorio, ma apprezzeremmo molto se ci parlassi dei tuoi riutilizzi, così che possiamo condividerli con la community di Open Beauty Facts. Puoi anche compilare questo modulo per avere la possibilità di mettere in primo piano la tua app.

Esportazioni di dati da Open Beauty 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 su https://world.openbeautyfacts.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.openbeautyfacts.org/data/openbeautyfacts-mongodbdump.gz

sha256sum

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

md5sum

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

Esportazione Delta

Le esportazioni delta giornaliere sono fornite per i precedenti 14 giorni. L'elenco di file delta correntemente disponibili si può trovare in https://static.openbeautyfacts.org/data/delta/index.txt.

Ogni riga rappresenta un file disponibile in https://static.openbeautyfacts.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.openbeautyfacts.org/data/openbeautyfacts-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 Beauty 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 ricerche analitiche, ad esempio è possibile selezionare solo le colonne di proprio interesse, ottimizzando le prestazioni delle ricerche 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/beauty.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 alcuni dei prodotti, sono scaricabili nel formato CSV (leggibile con OpenOffice, Excel e molti altri software), tramite il modulo di ricerca avanzata.

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.openbeautyfacts.org/data/en.openbeautyfacts.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, in particolare, è utilizzata nell'app mobile di Open Beauty 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.openbeautyfacts.org/api/v2/product/[barcode].json

Esempio: https://world.openbeautyfacts.org/api/v2/product/3600550578041.json

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

• API V3: Nuova documentazione di OpenAPI - Lavori in Corso

Supporto di OpenAPI desiderato

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.

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.openbeautyfacts.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.
• 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 Beauty 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 (fronte / informazioni nutrizionali / ingredienti): è la cosa più semplice per i tuoi utenti
• L'intelligenza artificiale di Open Beauty Facts - Robotoff - genererà alcuni dati derivati dalle foto
• Col tempo, altre app e la community di Open Beauty Facts colmeranno le lacune di dati

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

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

App mobile per Android/iPhone/Flutter

La nuova app multi-piattaforma è sviluppata in Flutter/Dart.

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

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