> ## 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 video files list

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

This endpoint returns the direct media URLs for a video's available video formats, along with their resolution, frame rate, 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/video/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/video/{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/video/{videoId}:
    get:
      tags:
        - Files
      summary: Get video files list
      description: >-
        This endpoint retrieves a list of video files for a specified YouTube
        video.
      operationId: getVideoFilesList
      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 video format
                    url:
                      type: string
                      format: uri
                      description: The URL of the video file
                    mimeType:
                      type: string
                      description: The MIME type of the video file
                    bitrate:
                      type: integer
                      exclusiveMinimum: 0
                      description: The bitrate of the video in bits per second
                    width:
                      type: integer
                      exclusiveMinimum: 0
                      description: The width of the video in pixels
                    height:
                      type: integer
                      exclusiveMinimum: 0
                      description: The height of the video in pixels
                    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 video 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 video file
                    lastModified:
                      type: string
                      description: The last modified timestamp of the video file
                    contentLength:
                      type: string
                      description: The content length of the video file in bytes
                    quality:
                      type: string
                      description: The quality label of the video
                    fps:
                      type: integer
                      exclusiveMinimum: 0
                      description: The frames per second of the video
                    qualityLabel:
                      type: string
                      description: The quality label of the video (e.g., 720p, 1080p)
                    projectionType:
                      type: string
                      description: The projection type of the video
                    averageBitrate:
                      type: integer
                      exclusiveMinimum: 0
                      description: The average bitrate of the video in bits per second
                    approxDurationMs:
                      type: string
                      description: The approximate duration of the video in milliseconds
                    parsedContentLength:
                      type: string
                      description: The parsed content length in a human-readable format
                    lengthSeconds:
                      type: string
                      description: The length of the video in seconds
                    parsedLastModified:
                      type: string
                      description: The parsed last modified date in ISO 8601 format
                    highReplication:
                      type: boolean
                      description: Indicates if the video has high replication
                  required:
                    - itag
                    - url
                    - mimeType
                    - bitrate
                    - width
                    - height
                    - initRange
                    - indexRange
                    - lastModified
                    - contentLength
                    - quality
                    - fps
                    - qualityLabel
                    - projectionType
                    - averageBitrate
                    - approxDurationMs
                    - parsedContentLength
                    - lengthSeconds
                    - parsedLastModified
                description: List of available video files
              example:
                - itag: 18
                  url: >-
                    https://rr1---sn-fpoq-ca9l.googlevideo.com/videoplayback?expire=1727182133&ei=1WDyZoahMKWM6dsP3qHPgQw&ip=151.82.249.76&id=o-ANh3_4noZDjF8Pjrd-fOJF64u3XR6UXUrQBnI6nMmtGH&itag=18&source=youtube&requiressl=yes&xpc=EgVo2aDSNQ%3D%3D&mh=Dt&mm=31%2C29&mn=sn-fpoq-ca9l%2Csn-hpa7knle&ms=au%2Crdu&mv=m&mvi=1&pl=19&initcwndbps=1168750&bui=AXLXGFTGwNil4uu7CLA9rDEnIqYBg7cJKaqB_AEuBqTO-rFhDr7i8YEeOQ0BEuy4h2wRpSFHtOIueRS2&vprv=1&mime=video%2Fmp4&rqh=1&gir=yes&clen=43264901&ratebypass=yes&dur=703.657&lmt=1724964085878348&mt=1727160066&fvip=3&fexp=51299151&c=ANDROID_CREATOR&txp=5538434&sparams=expire%2Cei%2Cip%2Cid%2Citag%2Csource%2Crequiressl%2Cxpc%2Cbui%2Cvprv%2Cmime%2Crqh%2Cgir%2Cclen%2Cratebypass%2Cdur%2Clmt&sig=AJfQdSswRQIgAhyfIbg6G2UrPd6OvmchXq5CY9LLBbYQ36pFB27Lf3oCIQCucMXLxH_mePAdWYinUjRMRptvnFwjEwi7cfmAf2lXoQ%3D%3D&lsparams=mh%2Cmm%2Cmn%2Cms%2Cmv%2Cmvi%2Cpl%2Cinitcwndbps&lsig=ABPmVW0wRgIhAOWqvWP_W9FtJbmuvkOvkDXhi1T1DWNyK5G1fybCdAklAiEAz4m9Oj23flgjujmv0FHvD_yQ7bOvCIMclc4jiSZvV5A%3D
                  mimeType: video/mp4; codecs="avc1.42001E, mp4a.40.2"
                  bitrate: 491926
                  width: 640
                  height: 360
                  initRange: {}
                  indexRange: {}
                  lastModified: '1724964085878348'
                  contentLength: '43264901'
                  quality: medium
                  fps: 25
                  qualityLabel: 360p
                  projectionType: RECTANGULAR
                  averageBitrate: 491886
                  approxDurationMs: '703657'
                  parsedContentLength: 41.26 MiB
                  lengthSeconds: '704'
                  parsedLastModified: +056631-12-09T02:31:18.348Z
                - itag: 137
                  url: >-
                    https://rr1---sn-fpoq-ca9l.googlevideo.com/videoplayback?expire=1727182133&ei=1WDyZoahMKWM6dsP3qHPgQw&ip=151.82.249.76&id=o-ANh3_4noZDjF8Pjrd-fOJF64u3XR6UXUrQBnI6nMmtGH&itag=137&source=youtube&requiressl=yes&xpc=EgVo2aDSNQ%3D%3D&mh=Dt&mm=31%2C29&mn=sn-fpoq-ca9l%2Csn-hpa7knle&ms=au%2Crdu&mv=m&mvi=1&pl=19&initcwndbps=1168750&bui=AXLXGFT6IwRcCk7DaGEUPfx-oh6iNlbrRdZevMdUXHeB5Gb6yV4OUdFHyQ-8zYMXi6fFVFxVf9GVsFSZ&vprv=1&mime=video%2Fmp4&rqh=1&gir=yes&clen=148092497&dur=703.600&lmt=1724964676123051&mt=1727160066&fvip=3&keepalive=yes&fexp=51299151&c=ANDROID_CREATOR&txp=5535434&sparams=expire%2Cei%2Cip%2Cid%2Citag%2Csource%2Crequiressl%2Cxpc%2Cbui%2Cvprv%2Cmime%2Crqh%2Cgir%2Cclen%2Cdur%2Clmt&sig=AJfQdSswRQIhALdoySWMmiUJCXmZhdcCPGi8ZTX4XBKqVZC9nU5BAxVCAiA0g3jQMQUOrm9W1ZZG_2tLNM3jWs7nlRPPhJKMrUWgWQ%3D%3D&lsparams=mh%2Cmm%2Cmn%2Cms%2Cmv%2Cmvi%2Cpl%2Cinitcwndbps&lsig=ABPmVW0wRgIhAOWqvWP_W9FtJbmuvkOvkDXhi1T1DWNyK5G1fybCdAklAiEAz4m9Oj23flgjujmv0FHvD_yQ7bOvCIMclc4jiSZvV5A%3D
                  mimeType: video/mp4; codecs="avc1.640028"
                  bitrate: 4549042
                  width: 1920
                  height: 1080
                  initRange:
                    start: '0'
                    end: '741'
                  indexRange:
                    start: '742'
                    end: '2309'
                  lastModified: '1724964676123051'
                  contentLength: '148092497'
                  quality: hd1080
                  fps: 25
                  qualityLabel: 1080p
                  projectionType: RECTANGULAR
                  averageBitrate: 1683826
                  approxDurationMs: '703600'
                  parsedContentLength: 141.23 MiB
                  lengthSeconds: '704'
                  parsedLastModified: +056631-12-15T22:28:43.051Z
                - itag: 248
                  url: >-
                    https://rr1---sn-fpoq-ca9l.googlevideo.com/videoplayback?expire=1727182133&ei=1WDyZoahMKWM6dsP3qHPgQw&ip=151.82.249.76&id=o-ANh3_4noZDjF8Pjrd-fOJF64u3XR6UXUrQBnI6nMmtGH&itag=248&source=youtube&requiressl=yes&xpc=EgVo2aDSNQ%3D%3D&mh=Dt&mm=31%2C29&mn=sn-fpoq-ca9l%2Csn-hpa7knle&ms=au%2Crdu&mv=m&mvi=1&pl=19&initcwndbps=1168750&bui=AXLXGFT6IwRcCk7DaGEUPfx-oh6iNlbrRdZevMdUXHeB5Gb6yV4OUdFHyQ-8zYMXi6fFVFxVf9GVsFSZ&vprv=1&mime=video%2Fwebm&rqh=1&gir=yes&clen=92477954&dur=703.600&lmt=1724964540896123&mt=1727160066&fvip=3&keepalive=yes&fexp=51299151&c=ANDROID_CREATOR&txp=5535434&sparams=expire%2Cei%2Cip%2Cid%2Citag%2Csource%2Crequiressl%2Cxpc%2Cbui%2Cvprv%2Cmime%2Crqh%2Cgir%2Cclen%2Cdur%2Clmt&sig=AJfQdSswRgIhAMiO2b4ZIJbwPA81QXFYoJvt5ONvl_L0Che_Y6RzoQ4XAiEAoz8eTqsYquIXAC4SOI0Ob87cBhFsbrnu5wTdG5T7Q2U%3D&lsparams=mh%2Cmm%2Cmn%2Cms%2Cmv%2Cmvi%2Cpl%2Cinitcwndbps&lsig=ABPmVW0wRgIhAOWqvWP_W9FtJbmuvkOvkDXhi1T1DWNyK5G1fybCdAklAiEAz4m9Oj23flgjujmv0FHvD_yQ7bOvCIMclc4jiSZvV5A%3D
                  mimeType: video/webm; codecs="vp9"
                  bitrate: 2549207
                  width: 1920
                  height: 1080
                  initRange:
                    start: '0'
                    end: '219'
                  indexRange:
                    start: '220'
                    end: '2489'
                  lastModified: '1724964540896123'
                  contentLength: '92477954'
                  quality: hd1080
                  fps: 25
                  qualityLabel: 1080p
                  projectionType: RECTANGULAR
                  averageBitrate: 1051483
                  approxDurationMs: '703600'
                  parsedContentLength: 88.19 MiB
                  lengthSeconds: '704'
                  parsedLastModified: +056631-12-14T08:54:56.123Z
                - itag: 136
                  url: >-
                    https://rr1---sn-fpoq-ca9l.googlevideo.com/videoplayback?expire=1727182133&ei=1WDyZoahMKWM6dsP3qHPgQw&ip=151.82.249.76&id=o-ANh3_4noZDjF8Pjrd-fOJF64u3XR6UXUrQBnI6nMmtGH&itag=136&source=youtube&requiressl=yes&xpc=EgVo2aDSNQ%3D%3D&mh=Dt&mm=31%2C29&mn=sn-fpoq-ca9l%2Csn-hpa7knle&ms=au%2Crdu&mv=m&mvi=1&pl=19&initcwndbps=1168750&bui=AXLXGFT6IwRcCk7DaGEUPfx-oh6iNlbrRdZevMdUXHeB5Gb6yV4OUdFHyQ-8zYMXi6fFVFxVf9GVsFSZ&vprv=1&mime=video%2Fmp4&rqh=1&gir=yes&clen=38644716&dur=703.600&lmt=1724964616509682&mt=1727160066&fvip=3&keepalive=yes&fexp=51299151&c=ANDROID_CREATOR&txp=5535434&sparams=expire%2Cei%2Cip%2Cid%2Citag%2Csource%2Crequiressl%2Cxpc%2Cbui%2Cvprv%2Cmime%2Crqh%2Cgir%2Cclen%2Cdur%2Clmt&sig=AJfQdSswRgIhAMeZOMeDCSgSOLgVRLbbX9Im7AppaNjZlJ4sUqydKmKUAiEA37IlOUsSv8CIo4aXD0KvJGeaPH3GfQv8rQnCYJ6c6UM%3D&lsparams=mh%2Cmm%2Cmn%2Cms%2Cmv%2Cmvi%2Cpl%2Cinitcwndbps&lsig=ABPmVW0wRgIhAOWqvWP_W9FtJbmuvkOvkDXhi1T1DWNyK5G1fybCdAklAiEAz4m9Oj23flgjujmv0FHvD_yQ7bOvCIMclc4jiSZvV5A%3D
                  mimeType: video/mp4; codecs="avc1.4d401f"
                  bitrate: 2019682
                  width: 1280
                  height: 720
                  initRange:
                    start: '0'
                    end: '739'
                  indexRange:
                    start: '740'
                    end: '2307'
                  lastModified: '1724964616509682'
                  contentLength: '38644716'
                  quality: hd720
                  fps: 25
                  qualityLabel: 720p
                  projectionType: RECTANGULAR
                  averageBitrate: 439394
                  approxDurationMs: '703600'
                  parsedContentLength: 36.85 MiB
                  lengthSeconds: '704'
                  parsedLastModified: +056631-12-15T05:55:09.682Z
                - itag: 247
                  url: >-
                    https://rr1---sn-fpoq-ca9l.googlevideo.com/videoplayback?expire=1727182133&ei=1WDyZoahMKWM6dsP3qHPgQw&ip=151.82.249.76&id=o-ANh3_4noZDjF8Pjrd-fOJF64u3XR6UXUrQBnI6nMmtGH&itag=247&source=youtube&requiressl=yes&xpc=EgVo2aDSNQ%3D%3D&mh=Dt&mm=31%2C29&mn=sn-fpoq-ca9l%2Csn-hpa7knle&ms=au%2Crdu&mv=m&mvi=1&pl=19&initcwndbps=1168750&bui=AXLXGFT6IwRcCk7DaGEUPfx-oh6iNlbrRdZevMdUXHeB5Gb6yV4OUdFHyQ-8zYMXi6fFVFxVf9GVsFSZ&vprv=1&mime=video%2Fwebm&rqh=1&gir=yes&clen=42703548&dur=703.600&lmt=1724964988146615&mt=1727160066&fvip=3&keepalive=yes&fexp=51299151&c=ANDROID_CREATOR&txp=5535434&sparams=expire%2Cei%2Cip%2Cid%2Citag%2Csource%2Crequiressl%2Cxpc%2Cbui%2Cvprv%2Cmime%2Crqh%2Cgir%2Cclen%2Cdur%2Clmt&sig=AJfQdSswRQIhALbvr9yzW_wlHbtC9IUN-owzNSO9q7VItaQSnZiPux9UAiBd3m6-ykHI9RGOHmBtucZ9h9s-BoabiFYG-b2fqLzxrQ%3D%3D&lsparams=mh%2Cmm%2Cmn%2Cms%2Cmv%2Cmvi%2Cpl%2Cinitcwndbps&lsig=ABPmVW0wRgIhAOWqvWP_W9FtJbmuvkOvkDXhi1T1DWNyK5G1fybCdAklAiEAz4m9Oj23flgjujmv0FHvD_yQ7bOvCIMclc4jiSZvV5A%3D
                  mimeType: video/webm; codecs="vp9"
                  bitrate: 1540241
                  width: 1280
                  height: 720
                  initRange:
                    start: '0'
                    end: '219'
                  indexRange:
                    start: '220'
                    end: '2463'
                  lastModified: '1724964988146615'
                  contentLength: '42703548'
                  quality: hd720
                  fps: 25
                  qualityLabel: 720p
                  projectionType: RECTANGULAR
                  averageBitrate: 485543
                  approxDurationMs: '703600'
                  parsedContentLength: 40.73 MiB
                  lengthSeconds: '704'
                  parsedLastModified: +056631-12-19T13:09:06.615Z
                - itag: 135
                  url: >-
                    https://rr1---sn-fpoq-ca9l.googlevideo.com/videoplayback?expire=1727182133&ei=1WDyZoahMKWM6dsP3qHPgQw&ip=151.82.249.76&id=o-ANh3_4noZDjF8Pjrd-fOJF64u3XR6UXUrQBnI6nMmtGH&itag=135&source=youtube&requiressl=yes&xpc=EgVo2aDSNQ%3D%3D&mh=Dt&mm=31%2C29&mn=sn-fpoq-ca9l%2Csn-hpa7knle&ms=au%2Crdu&mv=m&mvi=1&pl=19&initcwndbps=1168750&bui=AXLXGFT6IwRcCk7DaGEUPfx-oh6iNlbrRdZevMdUXHeB5Gb6yV4OUdFHyQ-8zYMXi6fFVFxVf9GVsFSZ&vprv=1&mime=video%2Fmp4&rqh=1&gir=yes&clen=20918173&dur=703.600&lmt=1724964616614986&mt=1727160066&fvip=3&keepalive=yes&fexp=51299151&c=ANDROID_CREATOR&txp=5535434&sparams=expire%2Cei%2Cip%2Cid%2Citag%2Csource%2Crequiressl%2Cxpc%2Cbui%2Cvprv%2Cmime%2Crqh%2Cgir%2Cclen%2Cdur%2Clmt&sig=AJfQdSswRQIgY-3hHzvrvVD2dzfKRNif9M4evsTJnJ-gJWJ7IB142-QCIQDAvBfabvxG5EPdLzodpYQJ5zubXWAC71HaM-FSyV_l1g%3D%3D&lsparams=mh%2Cmm%2Cmn%2Cms%2Cmv%2Cmvi%2Cpl%2Cinitcwndbps&lsig=ABPmVW0wRgIhAOWqvWP_W9FtJbmuvkOvkDXhi1T1DWNyK5G1fybCdAklAiEAz4m9Oj23flgjujmv0FHvD_yQ7bOvCIMclc4jiSZvV5A%3D
                  mimeType: video/mp4; codecs="avc1.4d401e"
                  bitrate: 998809
                  width: 854
                  height: 480
                  initRange:
                    start: '0'
                    end: '740'
                  indexRange:
                    start: '741'
                    end: '2308'
                  lastModified: '1724964616614986'
                  contentLength: '20918173'
                  quality: large
                  fps: 25
                  qualityLabel: 480p
                  projectionType: RECTANGULAR
                  averageBitrate: 237841
                  approxDurationMs: '703600'
                  parsedContentLength: 19.95 MiB
                  lengthSeconds: '704'
                  parsedLastModified: +056631-12-15T05:56:54.986Z
                - itag: 244
                  url: >-
                    https://rr1---sn-fpoq-ca9l.googlevideo.com/videoplayback?expire=1727182133&ei=1WDyZoahMKWM6dsP3qHPgQw&ip=151.82.249.76&id=o-ANh3_4noZDjF8Pjrd-fOJF64u3XR6UXUrQBnI6nMmtGH&itag=244&source=youtube&requiressl=yes&xpc=EgVo2aDSNQ%3D%3D&mh=Dt&mm=31%2C29&mn=sn-fpoq-ca9l%2Csn-hpa7knle&ms=au%2Crdu&mv=m&mvi=1&pl=19&initcwndbps=1168750&bui=AXLXGFT6IwRcCk7DaGEUPfx-oh6iNlbrRdZevMdUXHeB5Gb6yV4OUdFHyQ-8zYMXi6fFVFxVf9GVsFSZ&vprv=1&mime=video%2Fwebm&rqh=1&gir=yes&clen=25963840&dur=703.600&lmt=1724965005814578&mt=1727160066&fvip=3&keepalive=yes&fexp=51299151&c=ANDROID_CREATOR&txp=5535434&sparams=expire%2Cei%2Cip%2Cid%2Citag%2Csource%2Crequiressl%2Cxpc%2Cbui%2Cvprv%2Cmime%2Crqh%2Cgir%2Cclen%2Cdur%2Clmt&sig=AJfQdSswRQIhAPEs0y5cwTUwcTZ_wR7ZWfJdHU9pzg9igwafukaeHQMtAiAXtiUmkOyTuud5CqZR-SMP2xOW6n-WWt0HNj_t7XTUdA%3D%3D&lsparams=mh%2Cmm%2Cmn%2Cms%2Cmv%2Cmvi%2Cpl%2Cinitcwndbps&lsig=ABPmVW0wRgIhAOWqvWP_W9FtJbmuvkOvkDXhi1T1DWNyK5G1fybCdAklAiEAz4m9Oj23flgjujmv0FHvD_yQ7bOvCIMclc4jiSZvV5A%3D
                  mimeType: video/webm; codecs="vp9"
                  bitrate: 771445
                  width: 854
                  height: 480
                  initRange:
                    start: '0'
                    end: '219'
                  indexRange:
                    start: '220'
                    end: '2439'
                  lastModified: '1724965005814578'
                  contentLength: '25963840'
                  quality: large
                  fps: 25
                  qualityLabel: 480p
                  projectionType: RECTANGULAR
                  averageBitrate: 295211
                  approxDurationMs: '703600'
                  parsedContentLength: 24.76 MiB
                  lengthSeconds: '704'
                  parsedLastModified: +056631-12-19T18:03:34.578Z
                - itag: 134
                  url: >-
                    https://rr1---sn-fpoq-ca9l.googlevideo.com/videoplayback?expire=1727182133&ei=1WDyZoahMKWM6dsP3qHPgQw&ip=151.82.249.76&id=o-ANh3_4noZDjF8Pjrd-fOJF64u3XR6UXUrQBnI6nMmtGH&itag=134&source=youtube&requiressl=yes&xpc=EgVo2aDSNQ%3D%3D&mh=Dt&mm=31%2C29&mn=sn-fpoq-ca9l%2Csn-hpa7knle&ms=au%2Crdu&mv=m&mvi=1&pl=19&initcwndbps=1168750&bui=AXLXGFT6IwRcCk7DaGEUPfx-oh6iNlbrRdZevMdUXHeB5Gb6yV4OUdFHyQ-8zYMXi6fFVFxVf9GVsFSZ&vprv=1&mime=video%2Fmp4&rqh=1&gir=yes&clen=13747195&dur=703.600&lmt=1724964615550237&mt=1727160066&fvip=3&keepalive=yes&fexp=51299151&c=ANDROID_CREATOR&txp=5535434&sparams=expire%2Cei%2Cip%2Cid%2Citag%2Csource%2Crequiressl%2Cxpc%2Cbui%2Cvprv%2Cmime%2Crqh%2Cgir%2Cclen%2Cdur%2Clmt&sig=AJfQdSswRAIgEOAQxUoA26jbbzpiUhpWMg0O0OdI2RaSJ9g1GJVVukYCIBaHQyhyd2w2wkiBhxiUh0rKMG5fGOYWCufNPyu-TjjN&lsparams=mh%2Cmm%2Cmn%2Cms%2Cmv%2Cmvi%2Cpl%2Cinitcwndbps&lsig=ABPmVW0wRgIhAOWqvWP_W9FtJbmuvkOvkDXhi1T1DWNyK5G1fybCdAklAiEAz4m9Oj23flgjujmv0FHvD_yQ7bOvCIMclc4jiSZvV5A%3D
                  mimeType: video/mp4; codecs="avc1.4d401e"
                  bitrate: 574931
                  width: 640
                  height: 360
                  initRange:
                    start: '0'
                    end: '740'
                  indexRange:
                    start: '741'
                    end: '2308'
                  lastModified: '1724964615550237'
                  contentLength: '13747195'
                  quality: medium
                  fps: 25
                  qualityLabel: 360p
                  projectionType: RECTANGULAR
                  averageBitrate: 156306
                  approxDurationMs: '703600'
                  parsedContentLength: 13.11 MiB
                  lengthSeconds: '704'
                  parsedLastModified: +056631-12-15T05:39:10.237Z
                  highReplication: true
                - itag: 243
                  url: >-
                    https://rr1---sn-fpoq-ca9l.googlevideo.com/videoplayback?expire=1727182133&ei=1WDyZoahMKWM6dsP3qHPgQw&ip=151.82.249.76&id=o-ANh3_4noZDjF8Pjrd-fOJF64u3XR6UXUrQBnI6nMmtGH&itag=243&source=youtube&requiressl=yes&xpc=EgVo2aDSNQ%3D%3D&mh=Dt&mm=31%2C29&mn=sn-fpoq-ca9l%2Csn-hpa7knle&ms=au%2Crdu&mv=m&mvi=1&pl=19&initcwndbps=1168750&bui=AXLXGFT6IwRcCk7DaGEUPfx-oh6iNlbrRdZevMdUXHeB5Gb6yV4OUdFHyQ-8zYMXi6fFVFxVf9GVsFSZ&vprv=1&mime=video%2Fwebm&rqh=1&gir=yes&clen=17109471&dur=703.600&lmt=1724965011192770&mt=1727160066&fvip=3&keepalive=yes&fexp=51299151&c=ANDROID_CREATOR&txp=5535434&sparams=expire%2Cei%2Cip%2Cid%2Citag%2Csource%2Crequiressl%2Cxpc%2Cbui%2Cvprv%2Cmime%2Crqh%2Cgir%2Cclen%2Cdur%2Clmt&sig=AJfQdSswRQIhALcoWlMagHrEt84cEJfOSwl6IDMeGm8nK-YIzhm2ehTJAiBtV_CCgQ93Bx4l_TjvxAT7Hyv_vxtfu0OK1mdIJ30d_Q%3D%3D&lsparams=mh%2Cmm%2Cmn%2Cms%2Cmv%2Cmvi%2Cpl%2Cinitcwndbps&lsig=ABPmVW0wRgIhAOWqvWP_W9FtJbmuvkOvkDXhi1T1DWNyK5G1fybCdAklAiEAz4m9Oj23flgjujmv0FHvD_yQ7bOvCIMclc4jiSZvV5A%3D
                  mimeType: video/webm; codecs="vp9"
                  bitrate: 416725
                  width: 640
                  height: 360
                  initRange:
                    start: '0'
                    end: '219'
                  indexRange:
                    start: '220'
                    end: '2389'
                  lastModified: '1724965011192770'
                  contentLength: '17109471'
                  quality: medium
                  fps: 25
                  qualityLabel: 360p
                  projectionType: RECTANGULAR
                  averageBitrate: 194536
                  approxDurationMs: '703600'
                  parsedContentLength: 16.32 MiB
                  lengthSeconds: '704'
                  parsedLastModified: +056631-12-19T19:33:12.770Z
                - itag: 133
                  url: >-
                    https://rr1---sn-fpoq-ca9l.googlevideo.com/videoplayback?expire=1727182133&ei=1WDyZoahMKWM6dsP3qHPgQw&ip=151.82.249.76&id=o-ANh3_4noZDjF8Pjrd-fOJF64u3XR6UXUrQBnI6nMmtGH&itag=133&source=youtube&requiressl=yes&xpc=EgVo2aDSNQ%3D%3D&mh=Dt&mm=31%2C29&mn=sn-fpoq-ca9l%2Csn-hpa7knle&ms=au%2Crdu&mv=m&mvi=1&pl=19&initcwndbps=1168750&bui=AXLXGFT6IwRcCk7DaGEUPfx-oh6iNlbrRdZevMdUXHeB5Gb6yV4OUdFHyQ-8zYMXi6fFVFxVf9GVsFSZ&vprv=1&mime=video%2Fmp4&rqh=1&gir=yes&clen=7302791&dur=703.600&lmt=1724964616910813&mt=1727160066&fvip=3&keepalive=yes&fexp=51299151&c=ANDROID_CREATOR&txp=5535434&sparams=expire%2Cei%2Cip%2Cid%2Citag%2Csource%2Crequiressl%2Cxpc%2Cbui%2Cvprv%2Cmime%2Crqh%2Cgir%2Cclen%2Cdur%2Clmt&sig=AJfQdSswRQIgEZKztCbr37gSkJaYQFP9scpaWbDOA5uaBaGiLI9frgICIQD9Trs5ajSxFFECfEgNU2nCRS6wEjrd6iuZYtcyLPiExQ%3D%3D&lsparams=mh%2Cmm%2Cmn%2Cms%2Cmv%2Cmvi%2Cpl%2Cinitcwndbps&lsig=ABPmVW0wRgIhAOWqvWP_W9FtJbmuvkOvkDXhi1T1DWNyK5G1fybCdAklAiEAz4m9Oj23flgjujmv0FHvD_yQ7bOvCIMclc4jiSZvV5A%3D
                  mimeType: video/mp4; codecs="avc1.4d4015"
                  bitrate: 264095
                  width: 426
                  height: 240
                  initRange:
                    start: '0'
                    end: '739'
                  indexRange:
                    start: '740'
                    end: '2307'
                  lastModified: '1724964616910813'
                  contentLength: '7302791'
                  quality: small
                  fps: 25
                  qualityLabel: 240p
                  projectionType: RECTANGULAR
                  averageBitrate: 83033
                  approxDurationMs: '703600'
                  parsedContentLength: 6.96 MiB
                  lengthSeconds: '704'
                  parsedLastModified: +056631-12-15T06:01:50.813Z
                - itag: 242
                  url: >-
                    https://rr1---sn-fpoq-ca9l.googlevideo.com/videoplayback?expire=1727182133&ei=1WDyZoahMKWM6dsP3qHPgQw&ip=151.82.249.76&id=o-ANh3_4noZDjF8Pjrd-fOJF64u3XR6UXUrQBnI6nMmtGH&itag=242&source=youtube&requiressl=yes&xpc=EgVo2aDSNQ%3D%3D&mh=Dt&mm=31%2C29&mn=sn-fpoq-ca9l%2Csn-hpa7knle&ms=au%2Crdu&mv=m&mvi=1&pl=19&initcwndbps=1168750&bui=AXLXGFT6IwRcCk7DaGEUPfx-oh6iNlbrRdZevMdUXHeB5Gb6yV4OUdFHyQ-8zYMXi6fFVFxVf9GVsFSZ&vprv=1&mime=video%2Fwebm&rqh=1&gir=yes&clen=9796934&dur=703.600&lmt=1724964994201450&mt=1727160066&fvip=3&keepalive=yes&fexp=51299151&c=ANDROID_CREATOR&txp=5535434&sparams=expire%2Cei%2Cip%2Cid%2Citag%2Csource%2Crequiressl%2Cxpc%2Cbui%2Cvprv%2Cmime%2Crqh%2Cgir%2Cclen%2Cdur%2Clmt&sig=AJfQdSswRQIgM0n3YJTvcxwC3GHwAIl35uq9ZmcnpoQFg5ffo_0FAo8CIQCVmOYE1Judv1mfAdDeUHwfkIOoBHzxcXca3I01kz2tIA%3D%3D&lsparams=mh%2Cmm%2Cmn%2Cms%2Cmv%2Cmvi%2Cpl%2Cinitcwndbps&lsig=ABPmVW0wRgIhAOWqvWP_W9FtJbmuvkOvkDXhi1T1DWNyK5G1fybCdAklAiEAz4m9Oj23flgjujmv0FHvD_yQ7bOvCIMclc4jiSZvV5A%3D
                  mimeType: video/webm; codecs="vp9"
                  bitrate: 226901
                  width: 426
                  height: 240
                  initRange:
                    start: '0'
                    end: '218'
                  indexRange:
                    start: '219'
                    end: '2385'
                  lastModified: '1724964994201450'
                  contentLength: '9796934'
                  quality: small
                  fps: 25
                  qualityLabel: 240p
                  projectionType: RECTANGULAR
                  averageBitrate: 111392
                  approxDurationMs: '703600'
                  parsedContentLength: 9.34 MiB
                  lengthSeconds: '704'
                  parsedLastModified: +056631-12-19T14:50:01.450Z
                - itag: 160
                  url: >-
                    https://rr1---sn-fpoq-ca9l.googlevideo.com/videoplayback?expire=1727182133&ei=1WDyZoahMKWM6dsP3qHPgQw&ip=151.82.249.76&id=o-ANh3_4noZDjF8Pjrd-fOJF64u3XR6UXUrQBnI6nMmtGH&itag=160&source=youtube&requiressl=yes&xpc=EgVo2aDSNQ%3D%3D&mh=Dt&mm=31%2C29&mn=sn-fpoq-ca9l%2Csn-hpa7knle&ms=au%2Crdu&mv=m&mvi=1&pl=19&initcwndbps=1168750&bui=AXLXGFT6IwRcCk7DaGEUPfx-oh6iNlbrRdZevMdUXHeB5Gb6yV4OUdFHyQ-8zYMXi6fFVFxVf9GVsFSZ&vprv=1&mime=video%2Fmp4&rqh=1&gir=yes&clen=4408649&dur=703.600&lmt=1724964615276870&mt=1727160066&fvip=3&keepalive=yes&fexp=51299151&c=ANDROID_CREATOR&txp=5535434&sparams=expire%2Cei%2Cip%2Cid%2Citag%2Csource%2Crequiressl%2Cxpc%2Cbui%2Cvprv%2Cmime%2Crqh%2Cgir%2Cclen%2Cdur%2Clmt&sig=AJfQdSswRQIgFx2RkP_DhySuvyDtOuL3sQwx7dcgrG7CQqGcfCt7Qg8CIQCX7PoCaB9dgsMdTsCOeT1Q9F4KG-KwUlOn08pPiM8EaA%3D%3D&lsparams=mh%2Cmm%2Cmn%2Cms%2Cmv%2Cmvi%2Cpl%2Cinitcwndbps&lsig=ABPmVW0wRgIhAOWqvWP_W9FtJbmuvkOvkDXhi1T1DWNyK5G1fybCdAklAiEAz4m9Oj23flgjujmv0FHvD_yQ7bOvCIMclc4jiSZvV5A%3D
                  mimeType: video/mp4; codecs="avc1.4d400c"
                  bitrate: 108929
                  width: 256
                  height: 144
                  initRange:
                    start: '0'
                    end: '738'
                  indexRange:
                    start: '739'
                    end: '2306'
                  lastModified: '1724964615276870'
                  contentLength: '4408649'
                  quality: tiny
                  fps: 25
                  qualityLabel: 144p
                  projectionType: RECTANGULAR
                  averageBitrate: 50126
                  approxDurationMs: '703600'
                  parsedContentLength: 4.2 MiB
                  lengthSeconds: '704'
                  parsedLastModified: +056631-12-15T05:34:36.870Z
                - itag: 278
                  url: >-
                    https://rr1---sn-fpoq-ca9l.googlevideo.com/videoplayback?expire=1727182133&ei=1WDyZoahMKWM6dsP3qHPgQw&ip=151.82.249.76&id=o-ANh3_4noZDjF8Pjrd-fOJF64u3XR6UXUrQBnI6nMmtGH&itag=278&source=youtube&requiressl=yes&xpc=EgVo2aDSNQ%3D%3D&mh=Dt&mm=31%2C29&mn=sn-fpoq-ca9l%2Csn-hpa7knle&ms=au%2Crdu&mv=m&mvi=1&pl=19&initcwndbps=1168750&bui=AXLXGFT6IwRcCk7DaGEUPfx-oh6iNlbrRdZevMdUXHeB5Gb6yV4OUdFHyQ-8zYMXi6fFVFxVf9GVsFSZ&vprv=1&mime=video%2Fwebm&rqh=1&gir=yes&clen=6722602&dur=703.600&lmt=1724964991407489&mt=1727160066&fvip=3&keepalive=yes&fexp=51299151&c=ANDROID_CREATOR&txp=5535434&sparams=expire%2Cei%2Cip%2Cid%2Citag%2Csource%2Crequiressl%2Cxpc%2Cbui%2Cvprv%2Cmime%2Crqh%2Cgir%2Cclen%2Cdur%2Clmt&sig=AJfQdSswRgIhAPmsmGw8VECDgDFjxvniJfJukMJHBzJvD1u9DwIdSexBAiEA_1vVz8SQNGHFzh_qbiKsn7-TdOt3T87cmJbaX3_JJbY%3D&lsparams=mh%2Cmm%2Cmn%2Cms%2Cmv%2Cmvi%2Cpl%2Cinitcwndbps&lsig=ABPmVW0wRgIhAOWqvWP_W9FtJbmuvkOvkDXhi1T1DWNyK5G1fybCdAklAiEAz4m9Oj23flgjujmv0FHvD_yQ7bOvCIMclc4jiSZvV5A%3D
                  mimeType: video/webm; codecs="vp9"
                  bitrate: 97309
                  width: 256
                  height: 144
                  initRange:
                    start: '0'
                    end: '218'
                  indexRange:
                    start: '219'
                    end: '2384'
                  lastModified: '1724964991407489'
                  contentLength: '6722602'
                  quality: tiny
                  fps: 25
                  qualityLabel: 144p
                  projectionType: RECTANGULAR
                  averageBitrate: 76436
                  approxDurationMs: '703600'
                  parsedContentLength: 6.41 MiB
                  lengthSeconds: '704'
                  parsedLastModified: +056631-12-19T14:03:27.489Z
        '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

````