Help us inform millions of consumers around the world about what they eat

group photo donation 2024
open food facts logo

Please give to our 2025 Fundraiser

Your donations fund the day-to-day operations of our non-profit association:

  • keeping our database open & available to all,
    • technical infrastructure (website/mobile app) & a small permanent team

  • remain independent of the food industry,

  • engage a community of committed citizens,

  • support the advancement of public health research.

Each donation counts! We appreciate your support in bringing further food transparency in the world.

Date

Condiții de reutilizare

Baza de date Open Beauty Facts este disponibilă sub Licența Open Database License.
Conținutul individual al bazei de date este disponibil sub Licența pentru conținutul bazei de date.
Imaginile produselor sunt disponibile sub licența Creative Commons Attribution ShareAlike. Acestea pot conține elemente grafice supuse dreptului de autor sau altor drepturi, care în unele cazuri pot fi reproduse (drepturi de citare sau utilizare loială).

Vă rugăm să citiți Termenii și condițiile de utilizare și reutilizarea înainte de a reutiliza datele.

Spuneți-ne despre reutilizarea dvs

Suntem foarte interesați să învățăm pentru ce sunt folosite datele Open Beauty Facts. 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. You can also fill this form to get a chance to get your app featured.

Aplicație mobilă pentru Android și iPhone (este nevoie de ajutor!)

Exporturile pentru baza de date sunt generate noaptea. Baza de date este foarte mare, așa că puteți găsi moduri diferite de a utiliza datele, în funcție de aroma de export.

Informații despre diferitele câmpuri pentru depozitul de date MongoDB și exporturile CSV sunt disponibile la https://world.openbeautyfacts.org/data/data-fields.txt

Dump MongoDB

Datele pentru toate produsele sunt disponibile într-un dump al bazei de date MongoDB.

Link
https://static.openbeautyfacts.org/data/openbeautyfacts-mongodbdump.gz
sha256sum
https://static.openbeautyfacts.org/data/gz-sha256sum
md5sum
https://static.openbeautyfacts.org/data/gz-md5sum

Delta Export

Exporturile zilnice delta sunt furnizate pentru ultimele 14 zile. The list of currently available delta files can be found at https://static.openbeautyfacts.org/data/delta/index.txt.

Fiecare linie reprezintă un fișier disponibil la https://static.openbeautyfacts.org/data/delta/{filename}.

The filename contains UNIX timestamp of the first and the last change contained in the JSON file, so that the delta files can be imported (after extraction) with mongoimport in alphabetical order.

Vă rugăm să rețineți că, din cauza naturii mongoexport, fișierele delta nu vă pot spune despre produsele șterse. To remove deleted products from your database, you will need to import the full MongoDB dump.

Export date JSONL

Întreaga bază de date este de asemenea disponibilă în format JSONL (numit uneori LDJSON sau NDJSON) unde fiecare linie este un obiect JSON. Aceasta reprezintă aceleași date ca și exportul de MongoDB. Fişierul este comprimat cu gzip.

Link
https://static.openbeautyfacts.org/data/openbeautyfacts-products.jsonl.gz

A suitable way to exploit the database is to use DuckDB, an in-process analytical tool designed to process large amount of data in a fraction of seconds. You can read our blog post where we walk you through exploring and processing the Open Beauty Facts database with DuckDB

Export date CSV

A simplified version of the JSONL dump is also available in the Parquet format. During the conversion, we filtered columns that contains duplicated information, are used for internal debugging, or are simply irrelevant for users.

The Parquet format has proved to be handy:

  • Data is organized by column, rather than by row, which saves storage space and speeds up analytics queries, i.e. you can select just the columns you care about, optimizing query performances, even on entry-level computers.
  • Highly efficient data compression and decompression, making it good for storing and sharing big datasets of any kind,
  • Supports complex data types and advanced nested data structures.

The dataset is available on Hugging Face, a collaborative Machine Learning ecosystem where developers and researchers can share models and datasets.

Link
https://huggingface.co/datasets/openfoodfacts/product-database/resolve/main/beauty.parquet?download=true

Find more information in the Wiki, including guidelines for data reuse and example queries to get started.

Export de date RDF

Data for all products, or some of the products, can be downloaded in the CSV format (readable with LibreOffice, Excel and many other spreadsheet software) through the advanced search form.

Link-uri
https://static.openbeautyfacts.org/data/en.openbeautyfacts.org.products.csv.gz (compressed CSV in GZIP format: ~ 0.9 Gb, uncompressed: ~ 9 Gb)

Codificarea fișierelor este Unicode UTF-8. Caracterul care separă câmpurile este <tab> (tabulare).

Export de date imagine

Baza de date este, de asemenea, disponibilă în formatul RDF. You can read the announcement in French.

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

Export de date imagine

All images and OCR results can either be downloaded from our server or from AWS (through the AWS Open Data Program). Consultați documentația noastră pentru a afla mai multe despre cum să descărcați imagini.

OpenAPI Documentation for the JSON API

Un API JSON este, de asemenea, disponibil pentru a citi datele unui produs. Acest API este utilizat în special în aplicația mobilă Open Beauty Facts pentru iPhone și Android.

Îmbunătățim API-ul în timp, dar avem grijă să păstrăm compatibilitatea cu versiunea anterioară. Please get in touch 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

Aplicația pentru Android este dezvoltată în Kotlin.

Note that if the output is too overwhelming, you can filter it - as described in the API documentation.

OpenAPI help wanted

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.

Vă vor permite să consumați date, precum și utilizatorii să contribuie cu date noi

Experimental XML API

The code for the official Open Food Facts mobile apps is available on GitHub Flutter Kotlin Android Swift iOS

Example: https://world.openbeautyfacts.org/api/v2/product/737628064502.xml

This API is not actively maintained, and not officially documented.

Ambalaje şi SDK-uri

Probabil că avem un pachet pentru limbajul tău de programare preferat. Dacă o facem, îl puteți folosi și îmbunătăți. Dacă nu o facem, puteți ajuta la crearea acestuia.

Sunteți bineveniți să reutilizați codul (este open source) și să ne ajutați să îl îmbunătățim pentru toată lumea, pe întreaga planetă.

General principles to make your users happy

  • Puteți căuta informații despre produse, inclusiv multe valori calculate utile.
  • DART: GitHub (Open Food Facts doar în acest moment)
  • De asemenea, puteți implementa fluxul complet, astfel încât aceștia să obțină imediat rezultatul cu un efort de partea lor.

Dacă utilizatorii dvs. se așteaptă la un rezultat imediat (de exemplu, aplicații de nutriție)

  • Trimiteți fotografii (față/nutriție/ingrediente): cel mai dureros lucru pentru utilizatori
  • The Open Beauty Facts AI - Robotoff - will generate some derived data from the photos
  • Over time, other apps, and the Open Beauty Facts community will fill the data gaps

If your users expect a result immediately (e.g. Allergy apps)

  • Submit ingredients + category > get Ingredient analysis, additives, allergens, normalized ingredients, vegan, vegetarian…
  • Submit labels for added value

Android/iPhone/Flutter mobile app

The code for the Open Beauty Facts mobile app is available on GitHub (Flutter, Kotlin Android and Swift iOS).

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

Puteți deschide o temă în depozitul nostru de documentație API

Sunteți bineveniți să reutilizați codul (este open source) și să ne ajutați să îl îmbunătățim pentru toată lumea, pe întreaga planetă.

SDKs

Discutând date, API și exporturi

You can look at common FAQ questions about the API and Data Exports and common Open Food Facts questions

You can join the Open Beauty Facts Slack chatroom which is the preferred way to ask questions and discuss the API. Please ask your questions in the #api channel

Puteți deschide o temă în depozitul nostru de documentație API

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