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

Get Media by username

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

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

  • username (الزامی): نام کاربری اینستاگرام کاربر مورد نظر
  • 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
username (required) str Username
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_by_username \
--user 'boxapi_username:boxapi_password' \
--data '{
        "username": "Boxapi.ir",
        "count": 12
    }'