مستندات BoxAPI
API جامع، کامل و ساده

Get Clips

این اندپوینت به شما امکان می‌دهد تا کلیپ‌ها (Reels) یک کاربر اینستاگرام را دریافت کنید. کلیپ‌ها شامل ویدیوهای کوتاه منتشر شده توسط کاربر هستند و با استفاده از این اندپوینت می‌توانید جزئیات هر کلیپ مانند کپشن، تعداد لایک و کامنت، لینک مستقیم و تاریخ انتشار آن‌ها را مشاهده کنید.

پارامتر ورودی:

  • ID (الزامی): آیدی عددی کاربر (پیج) موردنظر
  • Count (اختیاری): تعداد کلیپ‌هایی که می‌خواهید دریافت کنید
  • max_id (اختیاری): برای دریافت صفحه‌های بعدی نتایج (۱۲ پست بعدی تا انتها)، باید از پارامتر max_id  استفاده کنید. این مقدار را می‌توانید از فیلد next_max_id در پاسخ API بردارید و در درخواست بعدی ارسال کنید.

خروجی: اطلاعات کلیپ‌ها به صورت JSON که شامل موارد زیر است:

  • id: شناسه کلیپ
  • caption: متن کپشن کلیپ
  • like_count: تعداد لایک‌ها
  • comment_count: تعداد کامنت‌ها
  • media_url: لینک ویدیو
  • timestamp: تاریخ انتشار کلیپ
  • و اطلاعات تکمیلی…

نکته: این اندپوینت تنها به کلیپ‌های عمومی کاربر دسترسی دارد و کلیپ‌های خصوصی یا دایرکت‌ها را ارائه نمی‌دهد.

Name Type Default Description
id (required) int User id
count int 12 Number of media to retrieve (max: 12)
max_id string None Use for pagination
curl --request POST \
--url https://boxapi.ir/api/instagram/user/get_clips \
--user 'boxapi_username:boxapi_password' \
--data '{
        "id": 173560420,
        "count": 12
    }'