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

Audio Get Media

این اندپوینت به شما امکان می‌دهد تا رسانه‌های صوتی (Audio) مرتبط با یک شناسه صوتی خاص را دریافت کنید. با استفاده از این اندپوینت، می‌توانید اطلاعات مربوط به رسانه‌هایی که از یک قطعه صوتی استفاده کرده‌اند را مشاهده کنید.

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

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

خروجی: پاسخ JSON که شامل اطلاعات زیر است:

  • items: آرایه‌ای از رسانه‌ها که شامل موارد زیر است:
    • media: اطلاعات مربوط به هر رسانه، شامل:
      • id: شناسه رسانه.
      • media_type: نوع رسانه (عکس، ویدیو، آلبوم و …).
      • media_url: لینک مستقیم به رسانه.
      • thumbnail_url: لینک تصویر کوچک رسانه (در صورت وجود).
      • caption: متن توضیحات یا کپشن رسانه (در صورت وجود).
      • like_count: تعداد لایک‌های رسانه.
      • comment_count: تعداد کامنت‌های رسانه.
      • timestamp: زمان انتشار رسانه.
      • owner: اطلاعات صاحب رسانه، شامل:
        • username: نام کاربری صاحب رسانه.
        • full_name: نام کامل صاحب رسانه.
        • profile_pic_url: لینک تصویر پروفایل صاحب رسانه.

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

Name Type Default Description
id (required) int Audio id
max_id string None Use for pagination
curl --request POST \
--url https://boxapi.ir/api/instagram/audio/get_media \
--user 'boxapi_username:boxapi_password' \
--data '{
        "id": 2719627934837931
    }'