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

# Get audio files list

> This endpoint retrieves a list of audio files for a specified YouTube video.



## OpenAPI

````yaml get /files/audio/{videoId}
openapi: 3.1.0
info:
  version: 1.0.0
  title: Poix API
servers:
  - url: https://api.poix.io
    description: Production server
security: []
paths:
  /files/audio/{videoId}:
    get:
      summary: Get audio files list
      description: >-
        This endpoint retrieves a list of audio files for a specified YouTube
        video.
      operationId: getAudioFilesList
      parameters:
        - schema:
            type: string
            minLength: 11
            maxLength: 11
            description: The YouTube video ID
            example: dQw4w9WgXcQ
          required: true
          name: videoId
          in: path
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
                  properties:
                    itag:
                      type: integer
                      exclusiveMinimum: 0
                      description: The itag of the audio format
                    url:
                      type: string
                      format: uri
                      description: The URL of the audio file
                    mimeType:
                      type: string
                      description: The MIME type of the audio file
                    bitrate:
                      type: integer
                      exclusiveMinimum: 0
                      description: The bitrate of the audio in bits per second
                    initRange:
                      type: object
                      properties:
                        start:
                          type: string
                          description: The start byte of the initialization range
                        end:
                          type: string
                          description: The end byte of the initialization range
                      required:
                        - start
                        - end
                      description: The initialization range for the audio file
                    indexRange:
                      type: object
                      properties:
                        start:
                          type: string
                          description: The start byte of the index range
                        end:
                          type: string
                          description: The end byte of the index range
                      required:
                        - start
                        - end
                      description: The index range for the audio file
                    lastModified:
                      type: string
                      description: The last modified timestamp of the audio file
                    contentLength:
                      type: string
                      description: The content length of the audio file in bytes
                    quality:
                      type: string
                      description: The quality label of the audio
                    projectionType:
                      type: string
                      description: The projection type of the audio
                    averageBitrate:
                      type: integer
                      exclusiveMinimum: 0
                      description: The average bitrate of the audio in bits per second
                    audioQuality:
                      type: string
                      description: The audio quality label
                    approxDurationMs:
                      type: string
                      description: The approximate duration of the audio in milliseconds
                    audioSampleRate:
                      type: string
                      description: The audio sample rate
                    audioChannels:
                      type: integer
                      exclusiveMinimum: 0
                      description: The number of audio channels
                    parsedContentLength:
                      type: string
                      description: The parsed content length in a human-readable format
                    lengthSeconds:
                      type: string
                      description: The length of the audio in seconds
                    parsedLastModified:
                      type: string
                      description: The parsed last modified date in ISO 8601 format
                    highReplication:
                      type: boolean
                      description: Indicates if the audio has high replication
                  required:
                    - itag
                    - url
                    - mimeType
                    - bitrate
                    - initRange
                    - indexRange
                    - lastModified
                    - contentLength
                    - quality
                    - projectionType
                    - averageBitrate
                    - audioQuality
                    - approxDurationMs
                    - audioSampleRate
                    - audioChannels
                    - parsedContentLength
                    - lengthSeconds
                    - parsedLastModified
                description: List of available audio files
                example:
                  - itag: 139
                    url: >-
                      https://rr1---sn-8vq54voxpu-925e.googlevideo.com/videoplayback?expire=1727179901&ei=HVjyZoX0DraCi9oPuJLFyAI&ip=31.26.138.243&id=o-AGFdx643g1zp1pVHAn6l5PANXDz8Nvmg7DncE_45cMM6&itag=139&source=youtube&requiressl=yes&xpc=EgVo2aDSNQ%3D%3D&mh=7c&mm=31%2C29&mn=sn-8vq54voxpu-925e%2Csn-hpa7zns6&ms=au%2Crdu&mv=m&mvi=1&pl=21&initcwndbps=1255000&vprv=1&svpuc=1&mime=audio%2Fmp4&rqh=1&gir=yes&clen=1295035&dur=212.183&lmt=1717047826596234&mt=1727157900&fvip=2&keepalive=yes&c=ANDROID_TESTSUITE&txp=4532434&sparams=expire%2Cei%2Cip%2Cid%2Citag%2Csource%2Crequiressl%2Cxpc%2Cvprv%2Csvpuc%2Cmime%2Crqh%2Cgir%2Cclen%2Cdur%2Clmt&sig=AJfQdSswRQIgWMJorIvdLaJa5oqpWV2xWTAuk1sV8oTZ1wjj0TeXq6gCIQCc0aP2FLhIo6RzJJTNQZQs5HSHpoG2h5Xv3gTQ0Bn8RQ%3D%3D&lsparams=mh%2Cmm%2Cmn%2Cms%2Cmv%2Cmvi%2Cpl%2Cinitcwndbps&lsig=ABPmVW0wRQIhALudieGQmoIh_qLTgz_EaXn6q9wm5H7WjebX_se0h7RUAiBSsjkCUszwNDJH4RTT4nHrhSy_BFuKV4TuG7ll5go6_A%3D%3D
                    mimeType: audio/mp4; codecs="mp4a.40.5"
                    bitrate: 50079
                    initRange:
                      start: '0'
                      end: '731'
                    indexRange:
                      start: '732'
                      end: '1027'
                    lastModified: '1717047826596234'
                    contentLength: '1295035'
                    quality: tiny
                    projectionType: RECTANGULAR
                    averageBitrate: 48827
                    audioQuality: AUDIO_QUALITY_LOW
                    approxDurationMs: '212183'
                    audioSampleRate: '22050'
                    audioChannels: 2
                    parsedContentLength: 1.24 MiB
                    lengthSeconds: '212'
                    parsedLastModified: '2024-05-30T05:43:46.596Z'
                  - itag: 140
                    url: >-
                      https://rr1---sn-8vq54voxpu-925e.googlevideo.com/videoplayback?expire=1727179901&ei=HVjyZoX0DraCi9oPuJLFyAI&ip=31.26.138.243&id=o-AGFdx643g1zp1pVHAn6l5PANXDz8Nvmg7DncE_45cMM6&itag=140&source=youtube&requiressl=yes&xpc=EgVo2aDSNQ%3D%3D&mh=7c&mm=31%2C29&mn=sn-8vq54voxpu-925e%2Csn-hpa7zns6&ms=au%2Crdu&mv=m&mvi=1&pl=21&initcwndbps=1255000&vprv=1&svpuc=1&mime=audio%2Fmp4&rqh=1&gir=yes&clen=3433605&dur=212.091&lmt=1717047821006373&mt=1727157900&fvip=2&keepalive=yes&c=ANDROID_TESTSUITE&txp=4532434&sparams=expire%2Cei%2Cip%2Cid%2Citag%2Csource%2Crequiressl%2Cxpc%2Cvprv%2Csvpuc%2Cmime%2Crqh%2Cgir%2Cclen%2Cdur%2Clmt&sig=AJfQdSswRAIga0ETV3wIzfWxNuu_lGfcvjsfUXpH8E-WIyji7IufSAMCICJcXNhLSWKt7P7r6FRQIwWeui_BseZ7jSYCAf6esbDh&lsparams=mh%2Cmm%2Cmn%2Cms%2Cmv%2Cmvi%2Cpl%2Cinitcwndbps&lsig=ABPmVW0wRQIhALudieGQmoIh_qLTgz_EaXn6q9wm5H7WjebX_se0h7RUAiBSsjkCUszwNDJH4RTT4nHrhSy_BFuKV4TuG7ll5go6_A%3D%3D
                    mimeType: audio/mp4; codecs="mp4a.40.2"
                    bitrate: 130675
                    initRange:
                      start: '0'
                      end: '722'
                    indexRange:
                      start: '723'
                      end: '1018'
                    lastModified: '1717047821006373'
                    contentLength: '3433605'
                    quality: tiny
                    projectionType: RECTANGULAR
                    averageBitrate: 129514
                    highReplication: true
                    audioQuality: AUDIO_QUALITY_MEDIUM
                    approxDurationMs: '212091'
                    audioSampleRate: '44100'
                    audioChannels: 2
                    parsedContentLength: 3.27 MiB
                    lengthSeconds: '212'
                    parsedLastModified: '2024-05-30T05:43:41.006Z'
                  - itag: 249
                    url: >-
                      https://rr1---sn-8vq54voxpu-925e.googlevideo.com/videoplayback?expire=1727179901&ei=HVjyZoX0DraCi9oPuJLFyAI&ip=31.26.138.243&id=o-AGFdx643g1zp1pVHAn6l5PANXDz8Nvmg7DncE_45cMM6&itag=249&source=youtube&requiressl=yes&xpc=EgVo2aDSNQ%3D%3D&mh=7c&mm=31%2C29&mn=sn-8vq54voxpu-925e%2Csn-hpa7zns6&ms=au%2Crdu&mv=m&mvi=1&pl=21&initcwndbps=1255000&vprv=1&svpuc=1&mime=audio%2Fwebm&rqh=1&gir=yes&clen=1232413&dur=212.061&lmt=1717047819209140&mt=1727157900&fvip=2&keepalive=yes&c=ANDROID_TESTSUITE&txp=4532434&sparams=expire%2Cei%2Cip%2Cid%2Citag%2Csource%2Crequiressl%2Cxpc%2Cvprv%2Csvpuc%2Cmime%2Crqh%2Cgir%2Cclen%2Cdur%2Clmt&sig=AJfQdSswRQIgT1IgHRdP6_0ejnZKkTKrWFF3UWNbYA4N9MNbKOQQJL4CIQDu5ccVYqi0UDWjx3vm9IXdnutM514_3yRrzqczVavudQ%3D%3D&lsparams=mh%2Cmm%2Cmn%2Cms%2Cmv%2Cmvi%2Cpl%2Cinitcwndbps&lsig=ABPmVW0wRQIhALudieGQmoIh_qLTgz_EaXn6q9wm5H7WjebX_se0h7RUAiBSsjkCUszwNDJH4RTT4nHrhSy_BFuKV4TuG7ll5go6_A%3D%3D
                    mimeType: audio/webm; codecs="opus"
                    bitrate: 49668
                    initRange:
                      start: '0'
                      end: '265'
                    indexRange:
                      start: '266'
                      end: '635'
                    lastModified: '1717047819209140'
                    contentLength: '1232413'
                    quality: tiny
                    projectionType: RECTANGULAR
                    averageBitrate: 46492
                    audioQuality: AUDIO_QUALITY_LOW
                    approxDurationMs: '212061'
                    audioSampleRate: '48000'
                    audioChannels: 2
                    parsedContentLength: 1.18 MiB
                    lengthSeconds: '212'
                    parsedLastModified: '2024-05-30T05:43:39.209Z'
                  - itag: 250
                    url: >-
                      https://rr1---sn-8vq54voxpu-925e.googlevideo.com/videoplayback?expire=1727179901&ei=HVjyZoX0DraCi9oPuJLFyAI&ip=31.26.138.243&id=o-AGFdx643g1zp1pVHAn6l5PANXDz8Nvmg7DncE_45cMM6&itag=250&source=youtube&requiressl=yes&xpc=EgVo2aDSNQ%3D%3D&mh=7c&mm=31%2C29&mn=sn-8vq54voxpu-925e%2Csn-hpa7zns6&ms=au%2Crdu&mv=m&mvi=1&pl=21&initcwndbps=1255000&vprv=1&svpuc=1&mime=audio%2Fwebm&rqh=1&gir=yes&clen=1630086&dur=212.061&lmt=1717047822840442&mt=1727157900&fvip=2&keepalive=yes&c=ANDROID_TESTSUITE&txp=4532434&sparams=expire%2Cei%2Cip%2Cid%2Citag%2Csource%2Crequiressl%2Cxpc%2Cvprv%2Csvpuc%2Cmime%2Crqh%2Cgir%2Cclen%2Cdur%2Clmt&sig=AJfQdSswRQIgI4Vwy12m6UidKdL0SqCi5G7nbKx1UAXev-TObNRRlGICIQDA0SL6AnZEqhpvypdLKdwR2QtcsUZQSVk-exV4Z10Vaw%3D%3D&lsparams=mh%2Cmm%2Cmn%2Cms%2Cmv%2Cmvi%2Cpl%2Cinitcwndbps&lsig=ABPmVW0wRQIhALudieGQmoIh_qLTgz_EaXn6q9wm5H7WjebX_se0h7RUAiBSsjkCUszwNDJH4RTT4nHrhSy_BFuKV4TuG7ll5go6_A%3D%3D
                    mimeType: audio/webm; codecs="opus"
                    bitrate: 65984
                    initRange:
                      start: '0'
                      end: '265'
                    indexRange:
                      start: '266'
                      end: '636'
                    lastModified: '1717047822840442'
                    contentLength: '1630086'
                    quality: tiny
                    projectionType: RECTANGULAR
                    averageBitrate: 61494
                    audioQuality: AUDIO_QUALITY_LOW
                    approxDurationMs: '212061'
                    audioSampleRate: '48000'
                    audioChannels: 2
                    parsedContentLength: 1.55 MiB
                    lengthSeconds: '212'
                    parsedLastModified: '2024-05-30T05:43:42.840Z'
                  - itag: 251
                    url: >-
                      https://rr1---sn-8vq54voxpu-925e.googlevideo.com/videoplayback?expire=1727179901&ei=HVjyZoX0DraCi9oPuJLFyAI&ip=31.26.138.243&id=o-AGFdx643g1zp1pVHAn6l5PANXDz8Nvmg7DncE_45cMM6&itag=251&source=youtube&requiressl=yes&xpc=EgVo2aDSNQ%3D%3D&mh=7c&mm=31%2C29&mn=sn-8vq54voxpu-925e%2Csn-hpa7zns6&ms=au%2Crdu&mv=m&mvi=1&pl=21&initcwndbps=1255000&vprv=1&svpuc=1&mime=audio%2Fwebm&rqh=1&gir=yes&clen=3437753&dur=212.061&lmt=1717047822556748&mt=1727157900&fvip=2&keepalive=yes&c=ANDROID_TESTSUITE&txp=4532434&sparams=expire%2Cei%2Cip%2Cid%2Citag%2Csource%2Crequiressl%2Cxpc%2Cvprv%2Csvpuc%2Cmime%2Crqh%2Cgir%2Cclen%2Cdur%2Clmt&sig=AJfQdSswRAIgPQ-Q-5PkH0mnKI6pXIOEj7f_qrvovoGY7VCh8F4M7ZQCIGy0TOgdwKUHiE3xi0Jm8VqfgUXpQ9TlSSZtk4xXHdcV&lsparams=mh%2Cmm%2Cmn%2Cms%2Cmv%2Cmvi%2Cpl%2Cinitcwndbps&lsig=ABPmVW0wRQIhALudieGQmoIh_qLTgz_EaXn6q9wm5H7WjebX_se0h7RUAiBSsjkCUszwNDJH4RTT4nHrhSy_BFuKV4TuG7ll5go6_A%3D%3D
                    mimeType: audio/webm; codecs="opus"
                    bitrate: 136946
                    initRange:
                      start: '0'
                      end: '265'
                    indexRange:
                      start: '266'
                      end: '636'
                    lastModified: '1717047822556748'
                    contentLength: '3437753'
                    quality: tiny
                    projectionType: RECTANGULAR
                    averageBitrate: 129689
                    audioQuality: AUDIO_QUALITY_MEDIUM
                    approxDurationMs: '212061'
                    audioSampleRate: '48000'
                    audioChannels: 2
                    parsedContentLength: 3.28 MiB
                    lengthSeconds: '212'
                    parsedLastModified: '2024-05-30T05:43:42.556Z'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    enum:
                      - false
                  error:
                    type: object
                    properties:
                      issues:
                        type: array
                        items:
                          type: object
                          properties:
                            code:
                              type: string
                            maximum:
                              type: number
                            type:
                              type: string
                            inclusive:
                              type: boolean
                            exact:
                              type: boolean
                            message:
                              type: string
                            path:
                              type: array
                              items:
                                type: string
                          required:
                            - code
                            - type
                            - message
                            - path
                      name:
                        type: string
                        enum:
                          - ZodError
                    required:
                      - issues
                      - name
                required:
                  - success
                  - error
              example:
                success: false
                error:
                  issues:
                    - code: too_big
                      maximum: 11
                      type: string
                      inclusive: true
                      exact: true
                      message: String must contain exactly 11 character(s)
                      path:
                        - videoId
                  name: ZodError
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: object
                    properties:
                      message:
                        type: string
                    required:
                      - message
                required:
                  - error
              example:
                error:
                  message: Forbidden
      security:
        - Bearer: []
components:
  securitySchemes:
    Bearer:
      type: http
      scheme: bearer
      bearerFormat: JWT

````