معطيات

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

قاعدة بيانات 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 والعديد من برامج جداول البيانات الأخرى) من خلال نموذج البحث المتقدم .

الروابط

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

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

Pet Food: https://static.openpetfoodfacts.org/data/en.openpetfoodfacts.org.products.csv.gz

All other products: https://static.openproductsfacts.org/data/en.openproductsfacts.org.products.csv.gz

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

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

The database is also available in the RDF format (this is an experiment, not actively maintained anymore). يمكنك قراءة الإعلان باللغة الفرنسية.

رابط

https://world.openfoodfacts.org/data/en.openfoodfacts.org.products.rdf.gz

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

يمكن تنزيل جميع الصور ونتائج التعرف الضوئي على الحروف (OCR) من خادمنا أو من AWS (من خلال برنامج AWS Open Data). Check out our documentation to learn more about how to download images

OpenAPI Documentation for the JSON API

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

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

Discover our API

Contributing to improving our API and OpenAPI documentation

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.

XML API (unsupported)

يمكنك أيضًا الحصول على النتيجة بصيغة 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)

Icon	Language / Framework	Resources	Discussion
	Cordova (Old App)	GitHub	N/A
	DART	GitHub pub.dev	N/A
	Elixir	GitHub	Slack Channel
	Go	GitHub	Slack Channel
	Java	GitHub	Slack Channel
	Spring Boot	GitHub	Slack Channel
	Kotlin	GitHub	Slack Channel
	NodeJS	GitHub	Slack Channel
	PHP	GitHub	Slack Channel
	PHP (Laravel)	GitHub	Slack Channel
	Python	GitHub	Slack Channel
	React Native	GitHub	Slack Channel
	Ruby	GitHub	Slack Channel
	Rust	GitHub	Slack Channel
	R	GitHub	Slack Channel
	Swift	GitHub	Slack Channel
	.NET/C#	GitHub	Slack Channel

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

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

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

You can open a thread on our API documentation repository

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