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

Media Get Info by shortcode

این اندپوینت امکان دریافت جزئیات کامل یک مدیا (عکس، ویدیو یا آلبوم) را بر اساس *shortcode* آن مدیا فراهم می‌کند. Shortcode قسمتی از لینک مدیا در اینستاگرام است که معمولاً بعد از `/p/` آمده و شناسهٔ قابل خواندن برای کاربر محسوب می‌شود. با استفاده از این اندپوینت، می‌توانید اطلاعات مثل نوع محتوا، تعداد لایک و کامنت، کپشن، لینک مستقیم مدیا و صاحب پست را بدست آورید.

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

  • shortcode (الزامی): کد کوتاه مدیا اینستاگرام (مثلاً آن بخش از URL که بعد از `/p/` می‌آید).

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

  • id: شناسه عددی داخلی مدیا
  • shortcode: همان کد کوتاه ورودی
  • type: نوع مدیا (image / video / album)
  • media_link: لینک مستقیم به تصویر یا ویدیو
  • thumbnail_link: لینک تصویر کوچک پیش‌نمایش
  • caption: متن کپشن پست (اگر وجود داشته باشد)
  • like_count: تعداد لایک‌ها
  • comment_count: تعداد کامنت‌ها
  • timestamp: زمان انتشار مدیا
  • owner: شناسه و نام کاربری صاحب پست
  • اطلاعات تکمیلی…

نکته: این اندپوینت فقط برای مدیاهای عمومی قابل استفاده است؛ در صورتی که مدیا خصوصی باشد یا صاحب پست دسترسی به آن را محدود کرده باشد، ممکن است برخی از فیلدها مقدار null یا خالی داشته باشند.

Name Type Default Description
shortcode (required) string Media shortcode
curl --request POST \
--url https://boxapi.ir/api/instagram/media/get_info_by_shortcode \
--user 'boxapi_username:boxapi_password' \
--data '{
        "shortcode": "Cm9DyYNooPD"
    }'