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