API Reference
v1Everything you need to integrate AudioScape music search into your experience.
Quick Start
Get music playing in your Roblox experience in under 5 minutes. Four steps, one script.
Authentication
All API requests require an API key passed via the x-api-key header. Create and manage your keys from the API Keys page.
x-api-key: your-api-key-hereEndpoints
POST/v1/searchSearch Music
Search our catalog using natural language. Describe a mood, genre, or artist and get relevant tracks.
POST/v1/similarFind Similar
Find tracks that sound like a given track. Pass an asset ID and get acoustically similar results.
POST/v1/sfx/searchSearch Sound Effects
Search the SFX catalog with natural language, or browse by UCS category to fill out a soundscape.
POST/v1/sfx/similarSimilar Sound Effects
Find SFX that sound like a given clip. Pass an asset ID and get acoustically similar results.
POST/v1/sfx/taxonomySFX Taxonomy
Fetch the full broader-category → category → subcategory hierarchy for building SFX browse UIs.
POST/v1/browseBrowse Catalog
Browse by artist, album, genre, mood, or trending. List available entities, drill into one, or fetch the daily-refreshed top tracks.
POST/v1/sfx/browseBrowse Sound Effects
Daily-refreshed list of trending sound effects across the SFX catalog, ranked by player engagement.
POST/v1/playlistPlaylists
Fetch playlists configured in the portal. List your playlists or get a specific one with its tracks.
POST/v1/track/structureTrack Structure
Beat grid + section labels for syncing animations, lighting, or VFX to the music.