Dades

The Open Beauty Facts database is available under the Open Database License.
The individual contents of the database are available under the Database Contents License.
Products images are available under the Creative Commons Attribution ShareAlike licence. Poden contenir elements gràfics subjectes a drets d'autor o altres drets, que en alguns casos es poden reproduir (drets de cotització o ús raonable).

Please read Terms and conditions of use and re-use before re-using the data.

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.

Open Beauty Facts data exports

Els abocaments de bases de dades i les exportacions es generen cada nit.

Information on the different fields for the MongoDB dump and CSV exports is available at https://world.openbeautyfacts.org/data/data-fields.txt

Abocador de MongoDB

Les dades de tots els productes estan disponibles en un bolcat de base de dades a MongoDB.

Enllaç

https://static.openbeautyfacts.org/data/openbeautyfacts-mongodbdump.tar.gz

sha256sum

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

md5sum

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

Exportació Delta

Les exportacions delta diàries es proporcionen durant els 14 dies anteriors. The list of currently available delta files can be found at https://static.openbeautyfacts.org/data/delta/index.txt. Each line represents a file that is available at https://static.openbeautyfacts.org/data/delta/{filename}. El nom del fitxer conté la marca de temps UNIX del primer i de l'últim canvi continguts al fitxer JSON, de manera que els fitxers delta es poden importar (després de l'extracció) amb mongoimport en ordre alfabètic.

Tingueu en compte que a causa de la naturalesa de mongoexport, els fitxers delta no us poden informar sobre els productes suprimits. Tingueu en compte que a causa de la naturalesa de mongoexport, els fitxers delta no us poden informar sobre els productes suprimits.

Exportació de dades CSV

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 advanced search form.

Enllaç

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

La codificació del fitxer és Unicode UTF-8. The character that separates fields is <tab> (tabulation).

RDF Data Export

The database is also available in the RDF format. announcement in French.

Enllaç

https://world.openbeautyfacts.org/data/en.openbeautyfacts.org.products.rdf

Live JSON API

The API behaves 99% like Open Food Facts, so many of the SDKs, codes to interact with the Open Food Facts API should work by merely changing the endpoint from: openfoodfacts.org to openbeautyfacts.org. The code hasn't been updated in over a year, so many of the newer APIs like Knowledge Panels are not available yet.

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.

We change the API over-time but we are careful to keep backwards compatibility. Please tell us if you use it, so that we can tell you about potential changes.

URL to read data for a product: https://world.openbeautyfacts.org/api/v2/product/[barcode].json

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

• API V1- Old documentation available on the Wiki (Important note: the page is divided into subpages for READ and WRITE).
• API V2 - Comprehensive but not OpenAPI compliant - It contains uses cases for displaying a product, and letting your users add the data required to get the Nutri-Score, the NOVA classification, additives, and the Eco-Score.
• API V2 - new OpenAPI documentation - Work in Progress
• API V3 - new OpenAPI documentation - Work in Progress

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.

If you are unsure about anything, or have any question (there is no silly question), feel free to ask it on Slack :-)

Android and iPhone mobile app (help needed!)

The code for the Open Beauty Facts mobile app is available on GitHub (Android and iOS). We need help to adapt the new native iOS code to cosmetics 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.

The app for Android is developed in Kotlin.

The new cross-platform app is developed in Flutter/Dart.

You are welcome to reuse the code (it's open source) and help us improve it, for everyone, on all the planet.

Wrappers and SDKs

We probably have a wrapper for your favorite programming language. If we do, you can use it and improve it, and probably add Open Beauty Facts support to it. If we don't, you can help create it.

They will let you consume data, as well as let your users contribute new data

• Cordova: GitHub (old Open Beauty Facts official app)
• DART: GitHub (Open Food Facts only at the moment)
• Elixir: GitHub (Open Food Facts only at the moment)
• Go: GitHub (Open Food Facts only at the moment)
• NodeJS: GitHub (Open Food Facts only at the moment)
• PHP: GitHub (Open Food Facts only at the moment)
• PHP (Lararel): GitHub (Open Food Facts only at the moment)
• Python: GitHub (Open Food Facts only at the moment)
• React Native: GitHub (Open Food Facts only at the moment)
• Ruby: GitHub (Open Beauty Facts compatible)

Discussing data, API and exports

You can join the Open Beauty Facts Slack chatroom which is the preferred way to ask questions and discuss the API.

You can open a thread on our API documentation repository

Contacte

For any question regarding the data, you can contact us at contact@openfoodfacts.org