الصفحات والمنشورات وReels والمجموعات والفعاليات وMarketplace ومكتبة إعلانات Meta.
تبحث عن فكرة لما تبنيه؟ اطّلع على نظرة عامة على Facebook API مع صفحات نقاط النهاية وأمثلة عملية.
- نقاط النهاية
- 21
- السعر الأساسي
- 1 رصيد
- المصدر
- مزوّد بيانات
| نقطة النهاية | نوع الإرجاع | الرصيد |
|---|---|---|
| GET /v1/facebook/profile | Profile | 1 |
| GET /v1/facebook/posts | Post[] | 1 |
| GET /v1/facebook/post | Post | 1 |
| GET /v1/facebook/comments | Comment[] | 1 |
| GET /v1/facebook/linked-profiles | LinkedProfile[] | 10 |
| GET /v1/facebook/reels | Post[] | 1 |
| GET /v1/facebook/photos | Post[] | 1 |
| GET /v1/facebook/transcript | Transcript | 1 |
| GET /v1/facebook/summary | Summary | 4 |
| GET /v1/facebook/community | Profile | 1 |
| GET /v1/facebook/community/posts | Post[] | 1 |
| GET /v1/facebook/marketplace/search | Product[] | 1 |
| GET /v1/facebook/marketplace/item | Product | 1 |
| GET /v1/facebook/ads/search | Ad[] | 1 |
| GET /v1/facebook/ads | Ad[] | 1 |
| GET /v1/facebook/ad | Ad | 1 |
| GET /v1/facebook/ad/transcript | Transcript | 1 |
| GET /v1/facebook/advertisers/search | Advertiser[] | 1 |
| GET /v1/facebook/events | Event[] | 1 |
| GET /v1/facebook/events/search | Event[] | 1 |
| GET /v1/facebook/event | Event | 1 |
الأساسية
الملف الشخصي
رصيد واحدملف شخصي عام حسب اسم المستخدم.
| handle | مطلوب | اسم المستخدم بدون @. |
| enrich | اختياري | arabic: يضيف اللهجة والمشاعر والكيانات والموضوعات (+3 أرصدة). |
curl -G https://api.crawlfeed.dev/v1/facebook/profile \
-H "Authorization: Bearer $CRAWLFEED_KEY" \
--data-urlencode "handle=nike"المنشورات
رصيد واحدأحدث منشورات ملف شخصي.
| handle | مطلوب | اسم المستخدم بدون @. |
| cursor | اختياري | القيمة من meta.next_cursor لجلب الصفحة التالية. |
| enrich | اختياري | arabic: يضيف اللهجة والمشاعر والكيانات والموضوعات (+3 أرصدة). |
curl -G https://api.crawlfeed.dev/v1/facebook/posts \
-H "Authorization: Bearer $CRAWLFEED_KEY" \
--data-urlencode "handle=nike"المنشور
رصيد واحدمنشور واحد حسب معرّفه.
| id | مطلوب | معرّف المنشور على تلك المنصة. |
| enrich | اختياري | arabic: يضيف اللهجة والمشاعر والكيانات والموضوعات (+3 أرصدة). |
curl -G https://api.crawlfeed.dev/v1/facebook/post \
-H "Authorization: Bearer $CRAWLFEED_KEY" \
--data-urlencode "id=<id>"الملفات الشخصية والأشخاص
الحسابات المرتبطة
10 أرصدةحسابات صانع المحتوى نفسه على منصات أخرى، مطابَقة عبر روابطه العامة.
| handle | مطلوب | اسم المستخدم بدون @. |
| cursor | اختياري | القيمة من meta.next_cursor لجلب الصفحة التالية. |
curl -G https://api.crawlfeed.dev/v1/facebook/linked-profiles \
-H "Authorization: Bearer $CRAWLFEED_KEY" \
--data-urlencode "handle=nike"المنشورات والخلاصات
Reels وShorts
رصيد واحدالفيديوهات القصيرة لملف شخصي: Reels وShorts.
| handle | مطلوب | اسم المستخدم بدون @، أو رابط الملف الشخصي. |
| cursor | اختياري | القيمة من meta.next_cursor لجلب الصفحة التالية. |
| enrich | اختياري | arabic: يضيف اللهجة والمشاعر والكيانات والموضوعات (+3 أرصدة). |
curl -G https://api.crawlfeed.dev/v1/facebook/reels \
-H "Authorization: Bearer $CRAWLFEED_KEY" \
--data-urlencode "handle=nike"الصور
رصيد واحدصور صفحة.
| handle | مطلوب | اسم المستخدم بدون @، أو رابط الملف الشخصي. |
| cursor | اختياري | القيمة من meta.next_cursor لجلب الصفحة التالية. |
| enrich | اختياري | arabic: يضيف اللهجة والمشاعر والكيانات والموضوعات (+3 أرصدة). |
curl -G https://api.crawlfeed.dev/v1/facebook/photos \
-H "Authorization: Bearer $CRAWLFEED_KEY" \
--data-urlencode "handle=charlidamelio"النصوص المفرّغة والوسائط
النص المفرّغ
رصيد واحدالكلام المنطوق في فيديو مكتوبًا، مع التوقيتات إن توفرت.
| id | مطلوب | معرّف الفيديو أو المنشور، أو رابطه. |
curl -G https://api.crawlfeed.dev/v1/facebook/transcript \
-H "Authorization: Bearer $CRAWLFEED_KEY" \
--data-urlencode "id=<id>"الملخص
4 أرصدةملخص فيديو بالذكاء الاصطناعي: بضع جمل وأهم النقاط والموضوعات، مكتوب من نصه المفرّغ.
| id | مطلوب | معرّف الفيديو أو المنشور، أو رابطه. |
| lang | اختياري | لغة الملخص (ISO 639-1، مثل en أو ar). الافتراضية لغة الفيديو. |
curl -G https://api.crawlfeed.dev/v1/facebook/summary \
-H "Authorization: Bearer $CRAWLFEED_KEY" \
--data-urlencode "id=<id>"المجتمعات
المجتمع
رصيد واحدمجتمع (subreddit أو مجموعة) بصيغة ملف شخصي.
| id | مطلوب | اسم المجتمع أو رابطه. |
| enrich | اختياري | arabic: يضيف اللهجة والمشاعر والكيانات والموضوعات (+3 أرصدة). |
curl -G https://api.crawlfeed.dev/v1/facebook/community \
-H "Authorization: Bearer $CRAWLFEED_KEY" \
--data-urlencode "id=<id>"منشورات المجتمع
رصيد واحدمنشورات في مجتمع، أو تبويب المجتمع في قناة.
| id | مطلوب | اسم المجتمع أو رابطه، أو اسم مستخدم قناة YouTube. |
| cursor | اختياري | القيمة من meta.next_cursor لجلب الصفحة التالية. |
| enrich | اختياري | arabic: يضيف اللهجة والمشاعر والكيانات والموضوعات (+3 أرصدة). |
curl -G https://api.crawlfeed.dev/v1/facebook/community/posts \
-H "Authorization: Bearer $CRAWLFEED_KEY" \
--data-urlencode "id=<id>"المتاجر والأسواق
البحث في Marketplace
رصيد واحدعروض Marketplace القريبة من موقع معيّن.
| q | مطلوب | عبارة البحث. |
| lat | مطلوب | خط العرض. |
| lng | مطلوب | خط الطول. |
| cursor | اختياري | القيمة من meta.next_cursor لجلب الصفحة التالية. |
curl -G https://api.crawlfeed.dev/v1/facebook/marketplace/search \
-H "Authorization: Bearer $CRAWLFEED_KEY" \
--data-urlencode "q=coffee" \
--data-urlencode "lat=40.7128" \
--data-urlencode "lng=-74.006"عرض في Marketplace
رصيد واحدعرض واحد في Marketplace.
| id | مطلوب | معرّف العرض أو رابطه. |
curl -G https://api.crawlfeed.dev/v1/facebook/marketplace/item \
-H "Authorization: Bearer $CRAWLFEED_KEY" \
--data-urlencode "id=<id>"مكتبات الإعلانات
البحث في الإعلانات
رصيد واحدإعلانات من مكتبة الإعلانات العامة تطابق كلمة مفتاحية.
| q | مطلوب | عبارة البحث. |
| country | اختياري | رمز الدولة وفق ISO. |
| cursor | اختياري | القيمة من meta.next_cursor لجلب الصفحة التالية. |
curl -G https://api.crawlfeed.dev/v1/facebook/ads/search \
-H "Authorization: Bearer $CRAWLFEED_KEY" \
--data-urlencode "q=coffee"إعلانات المعلِن
رصيد واحدكل إعلان يعرضه المعلِن حاليًا أو عرضه سابقًا.
| advertiser | مطلوب | اسم المعلِن أو معرّف صفحته أو نطاقه. |
| country | اختياري | رمز الدولة وفق ISO. |
| cursor | اختياري | القيمة من meta.next_cursor لجلب الصفحة التالية. |
curl -G https://api.crawlfeed.dev/v1/facebook/ads \
-H "Authorization: Bearer $CRAWLFEED_KEY" \
--data-urlencode "advertiser=nike.com"الإعلان
رصيد واحدإعلان واحد من مكتبة الإعلانات.
| id | مطلوب | معرّف الإعلان أو رابطه في مكتبة الإعلانات. |
curl -G https://api.crawlfeed.dev/v1/facebook/ad \
-H "Authorization: Bearer $CRAWLFEED_KEY" \
--data-urlencode "id=<id>"النص المفرّغ للإعلان
رصيد واحدالكلام المنطوق في إعلان فيديو.
| id | مطلوب | معرّف الإعلان أو رابطه في مكتبة الإعلانات. |
curl -G https://api.crawlfeed.dev/v1/facebook/ad/transcript \
-H "Authorization: Bearer $CRAWLFEED_KEY" \
--data-urlencode "id=<id>"البحث عن المعلِنين
رصيد واحدالعثور على معلِن، والمعرّف المسجّلة تحته إعلاناته.
| q | مطلوب | عبارة البحث. |
| cursor | اختياري | القيمة من meta.next_cursor لجلب الصفحة التالية. |
curl -G https://api.crawlfeed.dev/v1/facebook/advertisers/search \
-H "Authorization: Bearer $CRAWLFEED_KEY" \
--data-urlencode "q=coffee"الفعاليات
الفعاليات
رصيد واحدفعاليات صفحة القادمة والسابقة، أو جدول بث صانع محتوى.
| handle | مطلوب | اسم المستخدم بدون @، أو رابط الملف الشخصي. |
| cursor | اختياري | القيمة من meta.next_cursor لجلب الصفحة التالية. |
curl -G https://api.crawlfeed.dev/v1/facebook/events \
-H "Authorization: Bearer $CRAWLFEED_KEY" \
--data-urlencode "handle=nike"البحث في الفعاليات
رصيد واحدفعاليات عامة تطابق كلمة مفتاحية.
| q | مطلوب | عبارة البحث. |
| cursor | اختياري | القيمة من meta.next_cursor لجلب الصفحة التالية. |
curl -G https://api.crawlfeed.dev/v1/facebook/events/search \
-H "Authorization: Bearer $CRAWLFEED_KEY" \
--data-urlencode "q=coffee"الفعالية
رصيد واحدفعالية واحدة.
| id | مطلوب | معرّف الفعالية أو رابطها. |
curl -G https://api.crawlfeed.dev/v1/facebook/event \
-H "Authorization: Bearer $CRAWLFEED_KEY" \
--data-urlencode "id=<id>"تقبل كل نقطة نهاية أيضًا fresh=true (لتجاوز التخزين المؤقت بضعف السعر) وinclude_raw=true (لإضافة بيانات المنصة الأصلية). راجع شكل الاستجابة والرصيد.
التعليقات
رصيد واحدالتعليقات على منشور.