الموضوع في Instagram API
منشورات تختارها المنصة لموضوع معيّن، الأكثر رواجًا أولًا. تعيد نقطة النهاية هذه من crawlfeed النوع Post[] داخل غلاف الاستجابة الموحّد المكوّن من data وmeta.
الطلب
أرسل طلب GET مع مفتاح API إلى هذا المسار. القيم في الأمثلة نقطة بداية فقط، فاستبدلها بالعنصر أو الاستعلام العام في Instagram الذي تريد قراءته.
المُعاملات
| الاسم | الاستخدام | ما يتحكم فيه |
|---|---|---|
| q | مطلوب | موضوع، مثل basketball. |
| cursor | اختياري | المتابعة من صفحة سابقة. |
| fresh | اختياري | تجاوز التخزين المؤقت. التكلفة مضاعفة. |
| enrich | اختياري | إضافة اللهجة العربية والمشاعر والكيانات. |
يمكنك أيضًا تمرير include_raw=true لتضمين بيانات المصدر الأصلية. اقرأ تفاصيل صيغة الاستجابة.
انسخ طلبًا جاهزًا
ضع مفتاح API في CRAWLFEED_KEY. تكلفة عملية «الموضوع» بالسعر العادي: رصيد واحد، أما fresh=true فيتجاوز التخزين المؤقت ويضاعف التكلفة.
curl -G https://api.crawlfeed.dev/v1/instagram/topic \
-H "Authorization: Bearer $CRAWLFEED_KEY" \
--data-urlencode "q=basketball"اقرأ أكثر من صفحة
قد تعيد هذه العملية صفحة من النتائج مع meta.next_cursor. إن وُجد هذا الحقل، فأرسل قيمته في cursor مع الطلب التالي. وكل صفحة طلب مستقل يُحتسب من رصيدك. راجع دليل التنقل بين الصفحات لترى الحلقة كاملة.
ماذا بعد؟
استخدم قيمة Post[] الموحّدة من data في تطبيقك، وافحص meta لمعرفة الرصيد والمصدر والتنقل بين الصفحات. ويسرد مرجع الأنواع الحقول كلها. وقد يختلف توفر البيانات العامة من عنصر إلى آخر ومن منصة إلى أخرى.