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.

معطيات

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

قاعدة بيانات Open Food Facts متاحة بموجب ترخيص قاعدة البيانات المفتوحة.
محتويات قاعدة البيانات الفردية متاحة بموجب ترخيص محتويات قاعدة البيانات.
صور المنتجات متاحة بموجب ترخيص المشاع الإبداعي النسب بالمثل. قد تحتوي على عناصر رسومية تخضع لحقوق الطبع والنشر أو حقوق أخرى، التي قد يتم إعادة إنتاجها في بعض الحالات (حقوق الاقتباس أو الاستخدام العادل).

يرجى قراءة شروط وأحكام الاستخدام وإعادة الاستخدام قبل إعادة استخدام البيانات.

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

نحن مهتمون جدًا بمعرفة كيفية استخدام بيانات Open Food Facts. ليس إلزاميًا، ولكننا نقدر ذلك كثيرًا إذا أخبرتنا عن إعادة استخداماتك حتى نتمكن من مشاركتها مع مجتمع Open Food Facts. يمكنك أيضًا ملء هذا النموذج للحصول على فرصة لعرض تطبيقك.

تصديرات بيانات Open Food Facts

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

معلومات حول الحقول المختلفة لتفريغ MongoDB وتصديرات CSV متوفرة على https://world.openfoodfacts.org/data/data-fields.txt

تفريغ MongoDB

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

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

Delta Export

يتم توفير تصديرات الدلتا اليومية للأيام الـ 14 السابقة. قائمة ملفات الدلتا المتوفرة حاليًا يمكن العثور عليها على https://static.openfoodfacts.org/data/delta/index.txt.

كل سطر يمثل ملفًا متوفرًا على https://static.openfoodfacts.org/data/delta/{filename}.

.

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

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

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

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

طريقة مناسبة لاستغلال قاعدة البيانات هي استخدام DuckDB، وهو أداة تحليلية تعمل ضمن العملية مصممة لمعالجة كميات كبيرة من البيانات في جزء من الثانية. يمكنك قراءة مقال المدونة حيث نشرح لك كيفية استكشاف ومعالجة قاعدة بيانات Open Food Facts باستخدام DuckDB

تصدير بيانات Parquet على Hugging Face

إصدار مبسط من تفريغ الـJSONL أيضاً في تنسيق الباركيه. خلال التحويل, صَفَّيّنا الأعمدة التي تحتوي على معلومات متكررة, تستخدم لتصحيح أخطاء داخلية, أو هي فقط عَرَضِيّة للمستخدمين.

لقد أثبت تنسيق الباركيه أنه مفيد:

  • يتم تنظيم البيانات حسب العمود، وليس حسب الصف، مما يوفر مساحة التخزين ويسرع استعلامات التحليلات، أي أنه يمكنك تحديد الأعمدة التي تهمك فقط، مما يؤدي إلى تحسين أداء الاستعلامات، حتى على أجهزة الكمبيوتر الأساسية.
  • ضغط البيانات وفك ضغطها بكفاءة عالية، مما يجعلها جيدة لتخزين ومشاركة مجموعات البيانات الكبيرة من أي نوع،
  • يدعم أنواع البيانات المعقدة وهياكل البيانات المتداخلة المتقدمة.

تتوفر مجموعة البيانات على Hugging Face، وهو نظام بيئي تعاوني للتعلم الآلي حيث يمكن للمطورين والباحثين مشاركة النماذج ومجموعات البيانات.

رابط
https://huggingface.co/datasets/openfoodfacts/product-database/resolve/main/food.parquet?download=true

يمكنك العثور على مزيد من المعلومات في Wiki، بما في ذلك إرشادات إعادة استخدام البيانات وأمثلة الاستعلامات للبدء.

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

يمكن تنزيل بيانات جميع المنتجات، أو بعض المنتجات، بتنسيق CSV (قابل للقراءة باستخدام LibreOffice وExcel والعديد من برامج جداول البيانات الأخرى) من خلال نموذج البحث المتقدم .

الروابط
https://static.openfoodfacts.org/data/en.openfoodfacts.org.products.csv.gz (ملف CSV مضغوط بتنسيق GZIP: ~ 0.9 جيجابايت، غير مضغوط: ~ 9 جيجابايت)

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

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

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

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

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

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

OpenAPI Documentation for the JSON API

تتوفر أيضًا واجهة برمجة تطبيقات JSON لقراءة البيانات الخاصة بمنتج ما. يتم استخدام واجهة برمجة التطبيقات هذه على وجه الخصوص في تطبيق Open Food Facts للجوال لأجهزة iPhone وAndroid.

نعمل على تحسين واجهة برمجة التطبيقات (API) بمرور الوقت ولكننا نحرص على الحفاظ على التوافق مع الإصدارات السابقة. يرجى التواصل معنا إذا كنت تستخدمه، حتى نتمكن من إخبارك بالتغييرات المحتملة.

رابط لقراءة البيانات الخاصة بالمنتج: https://world.openfoodfacts.org/api/v2/product/[رمز شريطي].json

مثال: https://world.openfoodfacts.org/api/v3/product/737628064502.json

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

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

نحن حريصون على الانتهاء من توثيق واجهة برمجة التطبيقات، وإضافة حالات الاستخدام، وأتمتة إنشاء مجموعة أدوات التطوير البرمجية (SDK). إذا كنت من خبراء OpenAPI، فنحن نرحب بك كثيرًا للمساعدة.

مرحبًا بك كثيرًا لاستخدام واجهة برمجة التطبيقات (API) لحالات الإنتاج، طالما أن مكالمة API واحدة = مسح حقيقي واحد بواسطة مستخدم. من المحتمل جدًا أن يتم حظر أي محاولة لجمع قاعدة البيانات باستخدام واجهة برمجة التطبيقات، حيث تتوفر الصادرات اليومية الكاملة على هذه الصفحة ذاتها.

بالإضافة إلى ذلك، فإن إرسال رأس HTTP مع استدعاء API الخاص بك يعد طريقة جيدة يمكننا من خلالها التواصل معك في حالة ظهور أي مشكلة.

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

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

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

مثال: https://world.openfoodfacts.org/api/v2/product/737628064502.xml

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

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

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

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

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

  • يمكنك البحث عن معلومات حول المنتجات، بما في ذلك العديد من القيم المحسوبة المفيدة.
  • إذا لم تتمكن من الحصول على المعلومات حول منتج معين، فيمكنك جعل المستخدم يرسل الصور والبيانات، والتي سيتم معالجتها بعد ذلك بواسطة Open Food Facts AI والمساهمين للحصول على النتيجة المحسوبة التي تريد إظهارها لهم.
  • يمكنك أيضًا تنفيذ التدفق الكامل حتى يحصلوا على النتيجة فورًا مع بذل بعض الجهد من جانبهم.

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

  • إرسال الصور (الواجهة/التغذية/المكونات): الشيء الأكثر سهولة بالنسبة لمستخدميك
  • سيقوم الذكاء الاصطناعي Open Food Facts - Robotoff - بإنشاء بعض البيانات المشتقة من الصور
  • بمرور الوقت، ستعمل التطبيقات الأخرى ومجتمع Open Food Facts على سد فجوات البيانات

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

  • أرسل معلومات التغذية + الفئة > احصل على Nutri-Score
  • أرسل المكونات > احصل على مجموعة NOVA (حول المعالجة الفائقة للأطعمة)، المواد المضافة، المواد المسببة للحساسية، المكونات الطبيعية، نباتي، نباتي تمامًا…
  • أرسل الفئة + العلامات > احصل قريبًا على النتيجة البيئية (حول التأثير البيئي)

Android/iPhone/Flutter mobile app

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

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

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

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

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

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

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

يمكنك الانضمام إلى غرفة الدردشة الخاصة بـ Open Food Facts على Slack وهي الطريقة المفضلة لطرح الأسئلة ومناقشة واجهة برمجة التطبيقات. من فضلك اطرح أسئلتك في قناة #api

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

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