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.

معطيات

شروط إعادة الاستخدام

The Open Products 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. قد تحتوي على عناصر رسومية تخضع لحقوق الطبع والنشر أو حقوق أخرى، التي قد يتم إعادة إنتاجها في بعض الحالات (حقوق الاقتباس أو الاستخدام العادل).

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

أخبرنا عن إعادة استخدامك

We are very interested in learning what the Open Products 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 Products Facts community. يمكنك أيضًا ملء هذا النموذج للحصول على فرصة لعرض تطبيقك.

Open Products Facts data exports

يتم إنشاء تفريغات قاعدة البيانات والتصديرات كل ليلة. قاعدة البيانات كبيرة جدًا، لذا يمكنك العثور على طرق مختلفة لاستخدام البيانات، اعتمادًا على نوع التصدير.

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

تفريغ MongoDB

البيانات الخاصة بجميع المنتجات متوفرة في تفريغ قاعدة بيانات MongoDB.

رابط
https://static.openproductsfacts.org/data/openproductsfacts-mongodbdump.gz
sha256sum
https://static.openproductsfacts.org/data/gz-sha256sum
md5sum
https://static.openproductsfacts.org/data/gz-md5sum

Delta Export

يتم توفير تصديرات الدلتا اليومية للأيام الـ 14 السابقة. The list of currently available delta files can be found at https://static.openproductsfacts.org/data/delta/index.txt.

The list of currently available delta files can be found at https://static.openproductsfacts.org/data/delta/index.txt.

.

يرجى ملاحظة أنه بسبب طبيعة mongoexport، لا يمكن لملفات الدلتا إخبارك عن المنتجات المحذوفة. لإزالة المنتجات المحذوفة من قاعدة بياناتك، ستحتاج إلى استيراد تفريغ MongoDB الكامل.

تصدير بيانات JSONL

قاعدة البيانات الكاملة متوفرة أيضًا بصيغة JSONL (التي تُسمى أحيانًا LDJSON أو NDJSON) حيث يكون كل سطر هو كائن JSON. يمثل نفس البيانات كما في تصدير MongoDB. الملف مضغوط باستخدام gzip.

رابط
https://static.openproductsfacts.org/data/openproductsfacts-products.jsonl.gz

طريقة مناسبة لاستغلال قاعدة البيانات هي استخدام DuckDB، وهو أداة تحليلية تعمل ضمن العملية مصممة لمعالجة كميات كبيرة من البيانات في جزء من الثانية. You can read our blog post where we walk you through exploring and processing the Open Products Facts database with DuckDB

تصدير بيانات 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.

الروابط
https://static.openproductsfacts.org/data/en.openproductsfacts.org.products.csv.gz (compressed CSV in GZIP format: ~ 0.9 Gb, uncompressed: ~ 9 Gb)

ترميز الملف هو Unicode UTF-8. الرمز الذي يفصل الحقول هو <tab> (الجدولة).

تصدير بيانات RDF

قاعدة البيانات متاحة أيضًا بتنسيق RDF. يمكنك قراءة الإعلان باللغة الفرنسية.

رابط
https://world.openproductsfacts.org/data/en.openproductsfacts.org.products.rdf.gz

تصدير بيانات الصورة

يمكن تنزيل جميع الصور ونتائج التعرف الضوئي على الحروف (OCR) من خادمنا أو من AWS (من خلال برنامج AWS Open Data). قم بإلقاء نظرة على وثائقنا لمعرفة المزيد حول كيفية تنزيل الصور.

OpenAPI Documentation for the JSON API

تتوفر أيضًا واجهة برمجة تطبيقات JSON لقراءة البيانات الخاصة بمنتج ما. This API is in particular used in the Open Products Facts mobile app for iPhone and Android.

نعمل على تحسين واجهة برمجة التطبيقات (API) بمرور الوقت ولكننا نحرص على الحفاظ على التوافق مع الإصدارات السابقة. 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.openproductsfacts.org/api/v2/product/[barcode].json

Example: https://world.openproductsfacts.org/api/v2/product/8710847992063.json

لاحظ أنه إذا كان الناتج كبيرًا جدًا، فيمكنك تصفيته - كما هو موضح في وثائق واجهة برمجة التطبيقات.

مطلوب مساعدة في OpenAPI

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.

إذا لم تكن متأكدًا من أي شيء، أو لديك أي سؤال (لا يوجد سؤال سخيف)، فلا تتردد في طرحه على قناة #api على Slack :-)

واجهة برمجة تطبيقات XML التجريبية

يمكنك أيضًا الحصول على النتيجة بصيغة XML باستخدام .xml

جهة الاتصال

لا يتم صيانة هذه الواجهة البرمجية بشكل نشط، كما أنها غير موثقة رسميًا.

التغليفات ومجموعات تطوير البرامج

ربما لدينا غلافًا للغة البرمجة المفضلة لديك. إذا فعلنا ذلك، فيمكنك استخدامه وتحسينه. إذا لم نفعل ذلك، فيمكنك المساعدة في إنشائه.

سيسمحون لك باستهلاك البيانات، فضلاً عن السماح لمستخدميك بالمساهمة ببيانات جديدة

المبادئ العامة لإسعاد المستخدمين

  • يمكنك البحث عن معلومات حول المنتجات، بما في ذلك العديد من القيم المحسوبة المفيدة.
  • If you can't get the information on a specific product, you can get your user to send photos and data, that will then be processed by Open Products Facts AI and contributors to get the computed result you want to show them.
  • يمكنك أيضًا تنفيذ التدفق الكامل حتى يحصلوا على النتيجة فورًا مع بذل بعض الجهد من جانبهم.

إذا لم يتوقع المستخدمون الحصول على نتيجة فورية (على سبيل المثال تطبيقات المخزون)

  • إرسال الصور (الواجهة/التغذية/المكونات): الشيء الأكثر سهولة بالنسبة لمستخدميك
  • The Open Products Facts AI - Robotoff - will generate some derived data from the photos
  • Over time, other apps, and the Open Products Facts community will fill the data gaps

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

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

Android/iPhone/Flutter mobile app

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

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

يتيح التطبيق للمستخدمين مسح الرمز الشريطي للمنتجات، وعرض معلومات المنتج، والتقاط الصور والبيانات الخاصة بالمنتجات المفقودة وإرسالها.

نرحب بك لإعادة استخدام الكود (إنه مفتوح المصدر) ومساعدتنا في تحسينه، للجميع، في جميع أنحاء الكوكب.

حزم تطوير البرامج (SDK)

مناقشة البيانات وواجهة برمجة التطبيقات والصادرات

يمكنك إلقاء نظرة على الأسئلة الشائعة الشائعة حول واجهة برمجة التطبيقات وتصدير البيانات و الأسئلة الشائعة حول Open Food Facts

You can join the Open Products Facts Slack chatroom which is the preferred way to ask questions and discuss the API. من فضلك اطرح أسئلتك في قناة #api

يمكنك فتح موضوع على مستودع وثائق واجهة برمجة التطبيقات الخاص بنا

لأي سؤال بخصوص البيانات، يمكنك الاتصال بنا على reuse@openfoodfacts.org