> ## 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.

This endpoint returns the direct media URLs for a video's available audio-only formats, along with their codec, bitrate, container and file size.

### Choosing a region

Media URLs are always resolved from a specific country. By default that is the country your request originates from, falling back to `DE` when it cannot be determined. Pass `regionCode` to resolve the request as if it came from somewhere else — use it when a video is region-restricted and returns no formats from the default region.

`regionCode` accepts an ISO 3166-1 alpha-2 code; see [Countries](/api-reference/countries) for the full list of accepted values.

```bash cURL theme={null}
curl --request GET \
  --url 'https://api.poix.io/files/audio/dQw4w9WgXcQ?regionCode=US' \
  --header 'Authorization: Bearer poix-xxx'
```

### Downloading the files

The `url` of each format is a signed, time-limited link served directly by YouTube's CDN. Two things follow from that:

* **The links expire within a few hours.** Request the list right before you download rather than storing the URLs.
* **The links are issued to the host that fetched them**, which is Poix — not your own IP address. For most videos this makes no difference and the link downloads from anywhere. For some region-licensed content YouTube additionally restricts playback to the network the link was issued for, and downloading it yourself returns `403 Forbidden`.

<Note>
  `regionCode` does not fix a `403` on download. It controls which region the
  link is issued for, not which IP address may use it — the link is never issued
  for your own IP. If you hit one, request a fresh list and retry; the same link
  frequently succeeds from a different network.
</Note>


## OpenAPI

````yaml get /files/audio/{videoId}
openapi: 3.1.0
info:
  version: 1.0.1
  title: Poix API
servers:
  - url: https://api.poix.io
    description: Production server
security: []
paths:
  /files/audio/{videoId}:
    get:
      tags:
        - Files
      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
        - schema:
            type: string
            enum:
              - AD
              - AE
              - AF
              - AG
              - AI
              - AL
              - AM
              - AN
              - AO
              - AQ
              - AR
              - AS
              - AT
              - AU
              - AW
              - AX
              - AZ
              - BA
              - BB
              - BD
              - BE
              - BF
              - BG
              - BH
              - BI
              - BJ
              - BM
              - BN
              - BO
              - BR
              - BS
              - BT
              - BV
              - BW
              - BY
              - BZ
              - CA
              - CC
              - CD
              - CF
              - CG
              - CH
              - CI
              - CK
              - CL
              - CM
              - CN
              - CO
              - CR
              - CU
              - CV
              - CX
              - CY
              - CZ
              - DE
              - DJ
              - DK
              - DM
              - DO
              - DZ
              - EC
              - EE
              - EG
              - EH
              - ER
              - ES
              - ET
              - EU
              - FI
              - FJ
              - FK
              - FM
              - FO
              - FR
              - GA
              - GB
              - GD
              - GE
              - GF
              - GG
              - GH
              - GI
              - GL
              - GM
              - GN
              - GP
              - GQ
              - GR
              - GS
              - GT
              - GU
              - GW
              - GY
              - HK
              - HM
              - HN
              - HR
              - HT
              - HU
              - ID
              - IE
              - IL
              - IM
              - IN
              - IO
              - IQ
              - IR
              - IS
              - IT
              - JE
              - JM
              - JO
              - JP
              - KE
              - KG
              - KH
              - KI
              - KM
              - KN
              - KP
              - KR
              - KW
              - KY
              - KZ
              - LA
              - LB
              - LC
              - LI
              - LK
              - LR
              - LS
              - LT
              - LU
              - LV
              - LY
              - MA
              - MC
              - MD
              - ME
              - MG
              - MH
              - MK
              - ML
              - MM
              - MN
              - MO
              - MP
              - MQ
              - MR
              - MS
              - MT
              - MU
              - MV
              - MW
              - MX
              - MY
              - MZ
              - NA
              - NC
              - NE
              - NF
              - NG
              - NI
              - NL
              - 'NO'
              - NP
              - NR
              - NU
              - NZ
              - OM
              - PA
              - PE
              - PF
              - PG
              - PH
              - PK
              - PL
              - PM
              - PN
              - PR
              - PS
              - PT
              - PW
              - PY
              - QA
              - RE
              - RO
              - RS
              - RU
              - RW
              - SA
              - SB
              - SC
              - SD
              - SE
              - SG
              - SH
              - SI
              - SJ
              - SK
              - SL
              - SM
              - SN
              - SO
              - SR
              - ST
              - SV
              - SY
              - SZ
              - TC
              - TD
              - TF
              - TG
              - TH
              - TJ
              - TK
              - TL
              - TM
              - TN
              - TO
              - TR
              - TT
              - TV
              - TW
              - TZ
              - UA
              - UG
              - UM
              - US
              - UY
              - UZ
              - VA
              - VC
              - VE
              - VG
              - VI
              - VN
              - VU
              - WF
              - WS
              - XK
              - YE
              - YT
              - ZA
              - ZM
              - ZW
            description: >-
              Instructs the API to return results as if the request was made
              from a specific country. ISO 3166 alpha-2 country code.
          required: false
          description: >-
            Instructs the API to return results as if the request was made from
            a specific country. ISO 3166 alpha-2 country code.
          name: regionCode
          in: query
      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

````