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