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

Get Media

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

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

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

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

  • id: شناسه پست
  • type: نوع پست (عکس، ویدیو، آلبوم)
  • caption: متن کپشن
  • like_count: تعداد لایک‌ها
  • comment_count: تعداد کامنت‌ها
  • View_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_media \
--user 'boxapi_username:boxapi_password' \
--data '{
        "id": 12281817,
        "count": 12
    }'