ساعدنا في إعلام ملايين المستهلكين حول العالم بما يأكلون

group photo donation 2024
Open Food Facts logo

يرجى التبرع لحملة جمع التبرعات 2026

تساهم تبرعاتكم في تمويل العمليات اليومية لجمعيتنا غير الربحية:

  • الحفاظ على قاعدة البيانات الخاصة بنا مفتوحة ومتاحة للجميع،
    • البنية التحتية التقنية (موقع الويب / تطبيق الهاتف المحمول) وفريق صغير دائم

  • ظل مستقلا عن صناعة الأغذية،

  • إشراك مجتمع من المواطنين الملتزمين،

  • دعم تقدم أبحاث الصحة العامة.

كل تبرع يُحسب! نقدّر دعمكم لتعزيز الشفافية الغذائية في العالم.

معطيات

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

The Open Pet Food 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 Pet Food 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 Pet Food Facts community. يمكنك أيضًا ملء هذا النموذج للحصول على فرصة لعرض تطبيقك.

Open Pet Food Facts data exports

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

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

تفريغ MongoDB

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

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

Delta Export

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

Each line represents a file that is available at https://static.openpetfoodfacts.org/data/delta/{filename}.

.

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

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

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

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

A suitable way to exploit the database is to use DuckDB, an in-processs 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 Pet Food 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.

الروابط
The classic app for iOS has never been adapted nor deployed for pet food.

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

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

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

رابط
https://world.openpetfoodfacts.org/data/en.openpetfoodfacts.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 Pet Food 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.openpetfoodfacts.org/api/v0/product/[barcode].json

Example: https://world.openpetfoodfacts.org/api/v0/product/3600550578041.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

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.

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

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

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

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

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

  • يمكنك البحث عن معلومات حول المنتجات، بما في ذلك العديد من القيم المحسوبة المفيدة.
  • 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 Pet Food Facts AI and contributors to get the computed result you want to show them.
  • يمكنك أيضًا تنفيذ التدفق الكامل حتى يحصلوا على النتيجة فورًا مع بذل بعض الجهد من جانبهم.

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

  • إرسال الصور (الواجهة/التغذية/المكونات): الشيء الأكثر سهولة بالنسبة لمستخدميك
  • The Open Pet Food Facts AI - Robotoff - will generate some derived data from the photos
  • Over time, other apps, and the Open Pet Food 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 code for the current universal app called Open Food Facts is available on GitHub (Flutter. It can scan and add pet food. The legacy Open Pet Food Facts mobile app, still available for Android is built on Kotlin. The plan is to update it to a Open Pet Food Facts branded flavor of the Flutter app.

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

Kotlin Android and Swift iOS

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

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

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

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

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

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

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

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