Retrieve a list of supported Genres, Moods and Vocals

December 2, 2024 (November 16, 2026)

Table of contents

  1. Request Headers
  2. Query Parameters
  3. Responses
  4. Model
  5. Examples
  6. Try It

https://api.useapi.net/v1/mureka/music/moods-and-genres/?…

Request Headers
Authorization: Bearer {API token}
Content-Type: application/json
Query Parameters
  • account is optional when only one account configured. However, if you have multiple accounts configured, this parameter becomes required.
Responses
  • 200 OK

    {
        "genres": [
            {
                "tag": "pop",
                "cover": "cos-prod/res/image/Pop@4x.png"
            },
            {
                "tag": "<genre 2>",
                "cover": "<cover image 1>"
            },
            {
                "tag": "<genre NN>",
                "cover": "<cover image NN>"
            }
        ],
        "moods": [
            {
                "tag": "relaxed"
            },
            {
                "tag": "<mood 2>"
            },
            {
                "tag": "<mood NN>"
            }
        ],
        "vocals": [
            {
                "tag": "female vocal"
            },
            {
                "tag": "male vocal"
            }
        ]
    }
    
  • 400 Bad Request

    {
        "error": "<Error message>",
        "code": 400
    }
    
  • 401 Unauthorized

    {
      "error": "Unauthorized",
      "code": 401
    }
    
  • 596 Account Error

    Returned when the account has an error state preventing API calls.

    {
        "error": "Session refresh failed 2026-01-19T14:31:15.000Z, manual update required",
        "code": "REFRESH_FAILED"
    }
    

    Possible error codes:

    • ACCOUNT_ERROR - Account has a blocking error
    • REFRESH_FAILED - Automatic token refresh failed
    • REFRESH_IN_PROGRESS - Token refresh already in progress, retry shortly
    • SESSION_EXPIRED - Session expired and no auto-refresh available
    • COOKIE_EXPIRED - Google cookie has expired

    To resolve, update your account configuration via POST /accounts.

Model

The genre, mood and vocal tags Mureka supports, each as a tag string.

The genre, mood and vocal tags, field by field
{ // TypeScript, all fields are optional
    genres: { tag: string, cover?: string }[]
    moods: { tag: string }[]
    vocals: { tag: string }[]
}
Examples
  • curl "https://api.useapi.net/v1/mureka/music/moods-and-genres/?account=account" \
       -H "Accept: application/json" \
       -H "Authorization: Bearer …" 
    
  • const token = "API token";
    const account = "Previously configured account"; 
    const apiUrl = `https://api.useapi.net/v1/mureka/music/moods-and-genres/?account=${account}`; 
    const response = await fetch(apiUrl, {
      headers: {
        "Authorization": `Bearer ${token}`,
      },
    });
    const result = await response.json();
    console.log("response", {response, result});
    
  • import requests
    token = "API token"
    account = "Previously configured account"
    apiUrl = f"https://api.useapi.net/v1/mureka/music/moods-and-genres/?account={account}"
    headers = {
        "Content-Type": "application/json", 
        "Authorization" : f"Bearer {token}"
    }
    response = requests.get(apiUrl, headers=headers)
    print(response, response.json())
    
Try It