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

Audio Search Audios

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

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

  • query (الزامی): عبارت جستجویی که می‌خواهید صداها بر اساس آن فیلتر شوند.

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

  • num_results: تعداد نتایج یافت شده.
  • audios: آرایه‌ای از صداهای مرتبط با عبارت جستجو، که شامل موارد زیر است:
    • audio_cluster_id: شناسه خوشه صدا.
    • id: شناسه منحصر به فرد صدا.
    • title: عنوان صدا.
    • sanitized_title: عنوان تمیز شده صدا (در صورت وجود).
    • subtitle: زیرنویس صدا (در صورت وجود).
    • display_artist: نام هنرمند نمایش داده شده.
    • artist_id: شناسه هنرمند (در صورت وجود).
    • cover_artwork_uri: لینک تصویر کاور صدا.
    • cover_artwork_thumbnail_uri: لینک تصویر کوچک کاور صدا.
    • progressive_download_url: لینک دانلود پیشرفته صدا.
    • fast_start_progressive_download_url: لینک دانلود سریع صدا.
    • web_30s_preview_download_url: لینک پیش‌نمایش 30 ثانیه‌ای صدا.
    • reactive_audio_download_url: لینک دانلود واکنشی صدا.
    • highlight_start_times_in_ms: زمان‌های شروع هایلایت‌ها در میلی‌ثانیه.
    • is_explicit: آیا محتوای صدا صریح است؟
    • has_lyrics: آیا صدا دارای متن ترانه است؟
    • audio_asset_id: شناسه دارایی صدا.
    • duration_in_ms: مدت زمان صدا به میلی‌ثانیه.
    • dark_message: پیام تاریک (در صورت وجود).
    • allows_saving: آیا امکان ذخیره صدا وجود دارد؟
    • ig_username: نام کاربری اینستاگرام صاحب صدا (در صورت وجود).
    • is_eligible_for_audio_effects: آیا صدا برای افکت‌های صوتی مناسب است؟
    • is_eligible_for_vinyl_sticker: آیا صدا برای برچسب وینیل مناسب است؟
Name Type Default Description
query (required) string The search query
curl --request POST \
--url https://boxapi.ir/api/instagram/audio/search \
--user 'boxapi_username:boxapi_password' \
--data '{
        "query": "lofi"
    }'