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