> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hooked.so/llms.txt
> Use this file to discover all available pages before exploring further.

# List Music

> Get all available music tracks for background audio

## Overview

List all background music tracks available for your videos.

### Query Parameters

<ParamField query="category" type="string">
  Filter by category (e.g., "Electronic", "Pop", "Classical")
</ParamField>

<ParamField query="genre" type="string">
  Filter by genre (e.g., "Electronic", "Viral", "Calm")
</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X GET "https://api.hooked.so/v1/music/list?category=Electronic" \
    -H "x-api-key: your_api_key_here"
  ```
</RequestExample>

<ResponseExample>
  ```json Response theme={null}
  {
    "success": true,
    "data": {
      "music": [
        {
          "id": "1",
          "name": "Bladerunner 2049",
          "url": "https://cdn.hooked.so/music/bladerunner.mp3",
          "thumbnail": "https://cdn.hooked.so/music/thumbs/bladerunner.jpg",
          "category": "Futuristic",
          "duration": "03:00",
          "genres": ["Futuristic", "Electronic"]
        }
      ],
      "categories": [
        { "id": 1, "name": "Electronic", "description": "Electronic music collection" }
      ],
      "total": 200
    }
  }
  ```
</ResponseExample>


## OpenAPI

````yaml GET /v1/music/list
openapi: 3.0.0
info:
  title: Hooked API
  version: 1.0.0
  description: AI Video Generation API
servers:
  - url: https://api.hooked.so
security:
  - ApiKeyAuth: []
paths:
  /v1/music/list:
    get:
      tags: []
      summary: List Music
      description: Get all available music tracks for background audio
      operationId: listMusic
      parameters:
        - name: category
          in: query
          description: Filter by music category
          required: false
          schema:
            type: string
        - name: genre
          in: query
          description: Filter by genre
          required: false
          schema:
            type: string
      responses:
        '200':
          description: Success
      security:
        - ApiKeyAuth: []
components:
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key

````