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

Media Get Comments

این اندپوینت امکان دریافت کامنت‌های یک مدیا (پست عکس، ویدیو یا آلبوم) اینستاگرام را بر اساس شناسهٔ آن مدیا فراهم می‌کند. شما با استفاده از این endpoint می‌توانید لیستی از نظرات کاربران را ببینید، به همراه امکان پیمایش (pagination) اگر تعداد کامنت‌ها زیاد باشد.

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

  • id (الزامی): شناسه عددی مدیا که می‌خواهید کامنت‌هایش را دریافت کنید.
  • min_id (اختیاری): شناسه‌ای برای نقطهٔ شروع در پیمایش کامنت‌ها، اگر بخواهید کامنت‌ها را از یک نقطهٔ خاص (مثلاً بعد از شناسهٔ مشخص) دریافت کنید.
  • can_support_threading (اختیاری): بولی؛ اگر مقدار false داده شود، ترتیب کامنت‌ها به صورت زمانی خواهد بود (chronological). پیش‌فرض آن true است.

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

  • id: شناسهٔ کامنت
  • media_id: شناسهٔ مدیا متعلق به این کامنت
  • text: متن کامنت توسط کاربر
  • user: اطلاعات کاربری که نظر را داده است مثل شناسه و نام کاربری
  • created_at: زمان ثبت نظر
  • threaded_comments (در صورت وجود): لیست پاسخ‌های زیر کامنت اگر پاسخ داشته باشد، شامل همان ساختار کامنت‌ها باشد.

نکته: اگر تعداد کامنت‌ها زیاد باشد، ممکن است نیاز باشد از پارامتر min_id برای پیمایش استفاده کنید. همچنین ترتیب کامنت‌ها به پیش‌فرض یا بر اساس پارامتر can_support_threading ممکن است متفاوت باشد.

Name Type Default Description
id (required) string Media id
min_id string None Use for pagination
can_support_threading bool True Set False if you want chronological order
curl --request POST \
--url https://boxapi.ir/api/instagram/media/get_comments \
--user 'boxapi_username:boxapi_password' \
--data '{
        "id": 2967835229909923253
    }