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

Get Tags

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

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

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

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

  • id: شناسه پست
  • type: نوع پست (عکس، ویدیو، آلبوم)
  • caption: متن کپشن
  • like_count: تعداد لایک‌ها
  • comment_count: تعداد کامنت‌ها
  • media_url: لینک رسانه
  • timestamp: تاریخ انتشار پست
  • و اطلاعات تکمیلی…

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

Name Type Default Description
id (required) int User id
count int 12 Number of media to retrieve (max: 50)
max_id string None Use for pagination
curl --request POST \
--url https://boxapi.ir/api/instagram/user/get_tags \
--user 'boxapi_username:boxapi_password' \
--data '{
        "id": 173560420,
        "count": 12
    }'