واجهة Facebook API
الصفحات والمنشورات وReels والمجموعات والفعاليات وMarketplace ومكتبة إعلانات Meta. استدعِ نقاط النهاية المدعومة للبيانات العامة بمفتاح crawlfeed واحد، واحصل على استجابة بغلاف موحّد.
- نقاط النهاية المتاحة
- 21
- المجموعات المغطّاة
- 8
- السعر الأساسي للطلب
- رصيد واحد
البيانات التي يمكنك جلبها
كل عملية أدناه متاحة على Facebook. افتح أيًّا منها لترى الطلب الدقيق والمُعاملات ونوع الإرجاع والتكلفة، وستجد العقد الكامل في المرجع التقني.
الأساسية
- الملف الشخصيرصيد واحد للطلبملف شخصي عام حسب اسم المستخدم.GET /v1/facebook/profile → Profile
- المنشوراترصيد واحد للطلبأحدث منشورات ملف شخصي.GET /v1/facebook/posts → Post[]
- المنشوررصيد واحد للطلبمنشور واحد حسب معرّفه.GET /v1/facebook/post → Post
- التعليقاترصيد واحد للطلبالتعليقات على منشور.GET /v1/facebook/comments → Comment[]
الملفات الشخصية والأشخاص
المنشورات والخلاصات
النصوص المفرّغة والوسائط
المجتمعات
المتاجر والأسواق
مكتبات الإعلانات
- البحث في الإعلاناترصيد واحد للطلبإعلانات من مكتبة الإعلانات العامة تطابق كلمة مفتاحية.GET /v1/facebook/ads/search → Ad[]
- إعلانات المعلِنرصيد واحد للطلبكل إعلان يعرضه المعلِن حاليًا أو عرضه سابقًا.GET /v1/facebook/ads → Ad[]
- الإعلانرصيد واحد للطلبإعلان واحد من مكتبة الإعلانات.GET /v1/facebook/ad → Ad
- النص المفرّغ للإعلانرصيد واحد للطلبالكلام المنطوق في إعلان فيديو.GET /v1/facebook/ad/transcript → Transcript
- البحث عن المعلِنينرصيد واحد للطلبالعثور على معلِن، والمعرّف المسجّلة تحته إعلاناته.GET /v1/facebook/advertisers/search → Advertiser[]
أول طلب إلى Facebook
عملية «الملف الشخصي»: ملف شخصي عام حسب اسم المستخدم. اضبط مفتاحك، واستبدل القيم التجريبية، ثم أرسل الطلب. تصل النتيجة داخل غلاف crawlfeed المكوّن من data وmeta.
curl -G https://api.crawlfeed.dev/v1/facebook/profile \
-H "Authorization: Bearer $CRAWLFEED_KEY" \
--data-urlencode "handle=nike"اطّلع على مُعاملات «الملف الشخصي» أو على شكل الاستجابة.
كيف يعمل الرصيد
الأسعار أعلاه للطلب العادي. أما الطلب مع fresh=true فيتجاوز التخزين المؤقت ويكلّف ضعف سعر العملية المعتاد. وقد تؤثر خيارات أخرى في التكلفة، فراجع قواعد الرصيد قبل تشغيل دفعة كبيرة من الطلبات.
تقتصر التغطية على المعلومات العامة التي تعيدها نقاط النهاية المذكورة. وتختلف الطلبات المتاحة من منصة إلى أخرى، فالعملية المتاحة على شبكة أخرى ليست بالضرورة متاحة هنا.