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

Media Get Likes

این اندپوینت قابلیت دریافت لیست کاربرانی را دارد که یک مدیا (پست عکس، ویدیو یا آلبوم) در اینستاگرام را لایک کرده‌اند. تعداد لایک‌کنندگان قابل بازگشت تا ۱۰۰۰ نفر است و برای مدیاهای عمومی اعمال می‌شود.

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

  • shortcode (الزامی): کد کوتاه مدیا در اینستاگرام (Shortcode) که مدیا با آن شناخته شده است.

خروجی: پاسخ JSON شامل لیستی از کاربران لایک‌کننده مدیا، که هر عضو ممکن است شامل فیلدهایی مانند موارد زیر باشد:

  • id: شناسه عددی کاربر لایک‌کننده
  • username: نام کاربری کاربر لایک‌کننده
  • full_name: نام کامل کاربر لایک‌کننده
  • profile_picture_link: لینک تصویر پروفایل کاربر لایک‌کننده

نکته: اگر مدیا خصوصی باشد یا تنظیمات حساب به گونه‌ای باشد که اطلاعات عمومی در دسترس نباشد، ممکن است برخی داده‌ها در پاسخ وجود نداشته باشند یا درخواست به درستی پردازش نشود. همچنین حداکثر تعداد کاربران لایک‌کننده که برمی‌گردد برابر ۱۰۰۰ نفر است.

Name Type Default Description
shortcode (required) string Shortcode
curl --request POST \
--url https://boxapi.ir/api/instagram/media/get_likes_by_shortcode \
--user 'boxapi_username:boxapi_password' \
--data '{
        "shortcode": "Ckv3mrWq7W1"
    }'