Skip to main content
GET
Get Music Instruments

Overview

Retrieve a comprehensive list of available music instruments for filtering and searching music tracks. Use these instrument values to find music featuring specific instrumental sounds that complement your video content.
You need a valid API key to use this endpoint. Get your API key from the API Access page in your Pictory dashboard.

API Endpoint


Request Parameters

Headers

Authorization
string
required
API key for authentication (starts with pictai_)

Response

instruments
array of strings
Array of available music instrument names. Each instrument represents a distinct sound or instrumental category for filtering music tracks in search queries.

Response Examples


Code Examples

Replace YOUR_API_KEY with your actual API key that starts with pictai_

Usage Notes

Use these exact instrument values when searching for music to ensure valid selection from available categories. Instrument values are case-sensitive and must match exactly as returned by this endpoint.
Instrument Diversity: The API provides 95 distinct instrument options spanning traditional acoustic instruments (Piano, Guitar, Violin), electronic sounds (Synth, Vocoder, Electronic Drums), world instruments (Sitar, Koto, Didgeridoo), and special effects (FX Heartbeat, Vinyl Crackle, Hand Claps), enabling precise matching of instrumental sound to your video’s sonic requirements.

Common Use Cases

1. Populate an Instrument Selector

Fetch all available instruments to populate a dropdown or selection interface in your application:

2. Categorize Instruments by Type

Organize instruments into categories for simplified user selection:

3. Validate User Input

Ensure user-selected instruments are valid before using them in music search requests:

4. Build Instrument Filter Interface

Create a multi-category instrument filter for advanced music search:

5. Search by Multiple Instruments

Combine instrument filtering with other search criteria: