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

Highlight Get Stories

این اندپوینت به شما امکان می‌دهد تا استوری‌های موجود در یک هایلایت اینستاگرام را دریافت کنید. با استفاده از این اندپوینت، می‌توانید اطلاعات مربوط به استوری‌های ذخیره‌شده در هایلایت‌های عمومی یک کاربر را استخراج کنید.

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

  • ids (الزامی): شناسه‌های هایلایت مورد نظر. این شناسه‌ها باید به صورت یک لیست از اعداد صحیح ارائه شوند. (تا ۴ ID به ازای هر ریکوئست)

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

  • reels: آرایه‌ای از استوری‌های هایلایت که شامل موارد زیر است:
    • id: شناسه استوری.
    • latest_reel_media: زمان انتشار آخرین استوری در هایلایت.
    • seen: وضعیت دیده‌شدن استوری (در صورت موجود بودن).
    • can_reply: امکان ارسال پاسخ به استوری.
    • can_reshare: امکان به اشتراک‌گذاری استوری.
    • cover_media: اطلاعات مربوط به تصویر کاور استوری، شامل:
      • url: لینک تصویر کاور.
      • width: عرض تصویر کاور.
      • height: ارتفاع تصویر کاور.
    • user: اطلاعات کاربر منتشرکننده استوری، شامل:
      • pk: شناسه کاربر.
      • username: نام کاربری.
      • is_verified: وضعیت تأیید حساب.
      • profile_pic_url: لینک تصویر پروفایل.

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

Name Type Default Description
ids (required) list Highlight id(s)
curl --request POST \
--url https://boxapi.ir/api/instagram/highlight/get_stories \
--user 'boxapi_username:boxapi_password' \
--data '{
        "ids": [ 17902417075637532 ]
    }'