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