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

Media Get id by shortcode

این اندپوینت شناسه عددی داخلی (media id) یک مدیای اینستاگرام را بر اساس کد کوتاه (shortcode) آن مدیا برمی‌گرداند. این مفید است وقتی shortcode یک پست را دارید ولی شناسهٔ عددی آن را نمی‌دانید و می‌خواهید برای استفاده در اندپوینت‌های دیگر مثل دریافت اطلاعات کامل مدیا، نظرات یا لایک‌ها.

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

  • shortcode (الزامی): کد کوتاه مدیا (shortcode) که در URL پست اینستاگرام بعد از /p/ یا مشابه آن وجود دارد.

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

  • id: شناسهٔ عددی مدیا (media id) که برای درخواست‌های بعدی استفاده می‌شود

نکته: این اندپوینت فقط زمانی کار می‌کند که مدیا عمومی باشد. اگر مدیا خصوصی یا محدودیت دیگری داشته باشد، ممکن است نتوان شناسه را دریافت کرد یا پاسخ با خطا همراه باشد. همچنین باید مطمئن باشید که shortcode دقیق و معتبر است.

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