این اندپوینت به شما امکان میدهد تا رسانههای صوتی (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: لینک تصویر پروفایل صاحب رسانه.
- media: اطلاعات مربوط به هر رسانه، شامل:
نکته: این اندپوینت تنها به رسانههای عمومی دسترسی دارد و رسانههای خصوصی یا محدود را ارائه نمیدهد.
| Name | Type | Default | Description |
|---|---|---|---|
| id (required) | int | – | Audio id |
| max_id | string | None |
Use for pagination |
