Skip to main content
GET
Get Music Moods

Overview

Retrieve a comprehensive list of available music moods for filtering and searching music tracks. Use these mood values to find music that precisely matches the emotional tone and atmosphere of 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

moods
array of strings
Array of available music mood names. Each mood represents a distinct emotional or tonal quality 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 mood values when searching for music to ensure valid selection from available categories. Mood values are case-sensitive and must match exactly as returned by this endpoint.
Mood Categories: The API provides over 60 distinct mood options spanning a comprehensive range of emotional tones, from “Calm / Serene” to “Intense / Hard”, enabling precise alignment of music with your video’s emotional narrative.

Common Use Cases

1. Populate a Mood Selector

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

2. Categorize Moods by Emotion

Organize moods into emotional categories for simplified user selection:

3. Validate User Input

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