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

Get Followers

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

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

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

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

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

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

Name Type Default Description
id (required) int User id
count int 12 Number of users to return (max: 50)
max_id string None Use for pagination
query string None Search query

پارامتر query در این API به شما امکان می‌دهد تا در بین لیست فالوورهای یک کاربر، نام یا یوزرنیم موردنظر خود را جستجو کنید.

curl --request POST \
--url https://boxapi.ir/api/instagram/user/get_followers \
--user 'boxapi_username:boxapi_password' \
--data '{
        "id": 12281817,
        "count": 12
    }'