OBF:Translations/Data/English

From Open Food Facts wiki
Revision as of 19:06, 2 June 2016 by obf>Teolemon (courtesy of @lucaa)
Jump to navigation Jump to search

<< Back to OBF:Translations/Data


<h1>Data</h1>

<p>The Open Beauty Facts database is available under the <a href="http://opendatacommons.org/licenses/odbl/1.0/">Open Database License</a>.<br>
The individual contents of the database are available under the <a href="http://opendatacommons.org/licenses/dbcl/1.0/">Database Contents License</a>.<br>
Products images are available under the <a href="http://creativecommons.org/licenses/by-sa/3.0/deed.en">Creative Commons Attribution ShareAlike licence</a>.
They may contain graphical elements subject to copyright or other rights, that may in some cases be reproduced (quotation rights or fair use).</p>

<p>Please read <a href="http://world.openbeautyfacts.org/terms-of-use">Terms and conditions of use and re-use</a> before re-using the data.</p> 


<p>We are very interested in learning what the Open Beauty Facts data is used for. It is not mandatory, but we would very much appreciate it if you tell us about your re-uses so that we can share them
with the Open Beauty Facts community.</p>

<h2>Open Beauty Facts data exports</h2>

<p>Database dumps and exports are generated nightly.</p>

<p>Information on the different fields for the MongoDB dump and CSV exports is available at <a href="http://world.openbeautyfacts.org/data/data-fields.txt">http://world.openbeautyfacts.org/data/data-fields.txt</a></p>


<h3>MongoDB dump</h3>

<p>Data for all products is available in a MongoDB database dump.</p>

<p>Link : <a href="http://world.openbeautyfacts.org/data/openbeautyfacts-mongodbdump.tar.gz">http://world.openbeautyfacts.org/data/openbeautyfacts-mongodbdump.tar.gz</a>
</p><p>sha256sum : <a href="http://world.openbeautyfacts.org/data/sha256sum">http://world.openbeautyfacts.org/data/sha256sum</a>
</p><p>md5sum : <a href="http://world.openbeautyfacts.org/data/md5sum">http://world.openbeautyfacts.org/data/md5sum</a>

</p><h3>CSV Data Export</h3>

<p>Data for all products, or some of the products, can be downloaded in CSV format (readable with OpenOffice, Excel and many other software)
 through the <a href="http://world.openbeautyfacts.org/cgi/search.pl">advanced search form</a>.</p>
 
<p>Link : <a href="http://world.openbeautyfacts.org/data/en.openbeautyfacts.org.products.csv">http://world.openbeautyfacts.org/data/en.openbeautyfacts.org.products.csv</a>


</p><p>The file encoding is Unicode UTF-8. The character that separates fields is <tab> (tabulation).</p>



<h3>RDF Data Export</h3>

<p>The database is also available in the RDF format. <a href="http://fr.blog.openfoodfacts.org/news/des-donnees-libres-et-liees-export-rdf-des-donnees">announcement in French</a>.</p>

<p>Link: <a href="http://world.openbeautyfacts.org/data/en.openbeautyfacts.org.products.rdf">http://world.openbeautyfacts.org/data/en.openbeautyfacts.org.products.rdf</a>

</p><h2>Experimental JSON API</h2>

<p>A JSON API is also available to read the data for a product. This API is in particular used in the Open Beauty Facts mobile app for iPhone and Android.</p>

<p>This API is experimental and can change. Please tell us if you use it, so that we can tell you about potential changes.</p>

<p>URL to read data for a product: http://world.openbeautyfacts.org/api/v0/product/<i>[barcode]</i>.json</p>

<p>Example: <a href="http://world.openbeautyfacts.org/api/v0/product/3600550578041.json">http://world.openbeautyfacts.org/api/v0/product/3600550578041.json</a></p>

<h2>Android and iPhone mobile app </h2>

<p>The code for the Open Beauty Facts mobile app is available on <a href="https://github.com/openfoodfacts/openfoodfacts-android/tree/master/phonegap/Open%20Food%20Facts">github</a>.
The app allows users to scan the barcode of products, to view the product information, and to take and send pictures and data for missing products.</p>

<p>The app is developed in HTML and Javascript thanks to Phonegap (Cordova) which enables to use the same code for all mobile platforms.</p>

<h2>Mailing list for data, API and exports</h2>

<p>You can also join the mailing list to discuss the API and exports, tell us about your re-uses, and be notified when improvements or changes are made to the API. Send an empty e-mail to
<a href="mailto:api-subscribe@openbeautyfacts.org">api-subscribe@openbeautyfacts.org</a> to subscribe.</p>

<h2>Contact</h2>

<p>For any question regarding the data, you can contact us at <a href="mailto:contact@openbeautyfacts.org">contact@openbeautyfacts.org</a></p>