> ## 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 playlist items

> Get playlist items by ID, playlist or channel



## OpenAPI

````yaml get /playlistItems
openapi: 3.1.0
info:
  version: 1.0.0
  title: Poix API
servers:
  - url: https://api.poix.io
    description: Production server
security: []
paths:
  /playlistItems:
    get:
      summary: Get playlist items
      description: Get playlist items by ID, playlist or channel
      operationId: getPlaylistItems
      parameters:
        - schema:
            type: string
          required: false
          name: ids
          in: query
        - schema:
            type: string
            description: >-
              The unique ID of the playlist for which you want to retrieve
              playlist items
          required: false
          description: >-
            The unique ID of the playlist for which you want to retrieve
            playlist items
          name: playlistId
          in: query
        - schema:
            type: string
            minLength: 24
            maxLength: 24
            pattern: ^UC
            description: >-
              The unique ID of the channel for which you want to retrieve
              uploads videos
          required: false
          description: >-
            The unique ID of the channel for which you want to retrieve uploads
            videos
          name: channelId
          in: query
        - schema:
            type: string
            minLength: 11
            maxLength: 11
            description: >-
              The unique ID of the video for which you want to retrieve the
              playlist items
          required: false
          description: >-
            The unique ID of the video for which you want to retrieve the
            playlist items
          name: videoId
          in: query
        - schema:
            type: string
          required: false
          name: pageToken
          in: query
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                type: object
                properties:
                  totalResults:
                    type: number
                    description: Total number of playlist items returned.
                  resultsPerPage:
                    type: number
                    description: Number of results returned per page.
                  nextPageToken:
                    type: string
                    description: Token to retrieve the next page of results, if available.
                  prevPageToken:
                    type: string
                    description: >-
                      Token to retrieve the previous page of results, if
                      available.
                  data:
                    type: array
                    items:
                      type: object
                      properties:
                        kind:
                          type: string
                          description: The type of resource this item represents.
                        videoId:
                          type: string
                          description: >-
                            The unique ID of the video associated with this
                            playlist item.
                        id:
                          type: string
                          description: The unique ID of the playlist item.
                        privacyStatus:
                          type: string
                          description: >-
                            The privacy status of the playlist item (e.g.,
                            public, private).
                        videoPublishedAt:
                          type: string
                          description: The date and time when the video was published.
                        publishedAt:
                          type: string
                          description: The date and time when the playlist item was added.
                        channelId:
                          type: string
                          description: The ID of the channel that owns the video.
                        title:
                          type: string
                          description: The title of the video.
                        description:
                          type: string
                          description: The description of the video.
                        channelTitle:
                          type: string
                          description: The title of the channel that owns the video.
                        playlistId:
                          type: string
                          description: The ID of the playlist that this item belongs to.
                        position:
                          type: number
                          description: The position of the video in the playlist.
                        videoOwnerChannelTitle:
                          type: string
                          description: The title of the channel that owns the video.
                        videoOwnerChannelId:
                          type: string
                          description: The ID of the channel that owns the video.
                      required:
                        - kind
                        - videoId
                        - id
                        - privacyStatus
                        - videoPublishedAt
                        - publishedAt
                        - channelId
                        - title
                        - description
                        - channelTitle
                        - playlistId
                        - position
                        - videoOwnerChannelTitle
                        - videoOwnerChannelId
                    description: Array of playlist item objects.
                required:
                  - totalResults
                  - resultsPerPage
                  - data
              example:
                totalResults: 212
                resultsPerPage: 50
                nextPageToken: >-
                  EAAaelBUOkNHUWlFRGM0TURZd05VSkROamxETmtNeU5UQW9BVWpveU5yMjZlV0hBMUFCV2pZaVEyaG9WbFpYV2pSV1J6RXpUMFJhVjJKVk1WVmpWM2g1VVZkT2VscEhNSGhSVjJOVFEzZHFjVFU1VHpGQ2FFUkJjRTQwY0NJ
                prevPageToken: >-
                  EAEaelBUOkNESWlFRGhETlVaQlJUWkNNVFkwT0RFelF6Z29BVWpveU5yMjZlV0hBMUFBV2pZaVEyaG9WbFpYV2pSV1J6RXpUMFJhVjJKVk1WVmpWM2g1VVZkT2VscEhNSGhSVjJOVFEzZHFjVFU1VHpGQ2FFUkJjRTQwY0NJ
                data:
                  - kind: youtube#video
                    videoId: '-4hfcRWJMTs'
                    id: VVVmeFRtdzg2Vm1NVHFsckFjc2RtMUFnLi00aGZjUldKTVRz
                    privacyStatus: public
                    videoPublishedAt: '2021-06-12T07:58:19Z'
                    publishedAt: '2021-06-12T07:58:19Z'
                    channelId: UCfxTmw86VmMTqlrAcsdm1Ag
                    title: player stares death in the face decides to end it
                    description: |-
                      player stares death in the face decides to end it

                      #warzone
                    channelTitle: Always Call of Duty
                    playlistId: UUfxTmw86VmMTqlrAcsdm1Ag
                    position: 50
                    videoOwnerChannelTitle: Always Call of Duty
                    videoOwnerChannelId: UCfxTmw86VmMTqlrAcsdm1Ag
                  - kind: youtube#video
                    videoId: Q5lU0OLLJGI
                    id: VVVmeFRtdzg2Vm1NVHFsckFjc2RtMUFnLlE1bFUwT0xMSkdJ
                    privacyStatus: public
                    videoPublishedAt: '2021-05-31T10:00:28Z'
                    publishedAt: '2021-05-31T10:00:28Z'
                    channelId: UCfxTmw86VmMTqlrAcsdm1Ag
                    title: >-
                      Call of Duty Black Ops: Cold War RTX 3090 4K | Satelite
                      Gun Game 3rd
                    description: >-
                      Call of Duty Black Ops: Cold War RTX 3090 4K Satelite Gun
                      Game Gameplay

                      Satelite - Gun Game - 2021 - 4K - PC













                      #CallofDuty #ColdWar #RTX3090
                    channelTitle: Always Call of Duty
                    playlistId: UUfxTmw86VmMTqlrAcsdm1Ag
                    position: 51
                    videoOwnerChannelTitle: Always Call of Duty
                    videoOwnerChannelId: UCfxTmw86VmMTqlrAcsdm1Ag
                  - kind: youtube#video
                    videoId: QHm7Ysbm8Mk
                    id: VVVmeFRtdzg2Vm1NVHFsckFjc2RtMUFnLlFIbTdZc2JtOE1r
                    privacyStatus: public
                    videoPublishedAt: '2021-05-31T10:00:27Z'
                    publishedAt: '2021-05-31T10:00:27Z'
                    channelId: UCfxTmw86VmMTqlrAcsdm1Ag
                    title: Call of Duty Ghosts RTX 3090 4K | Siege
                    description: |-
                      Call of Duty Ghosts RTX 3090 4K Siege Gameplay
                      Siege - Team Deathmatch - 2021 - 4K - PC
















                      #CallofDuty #Ghosts #RTX3090
                    channelTitle: Always Call of Duty
                    playlistId: UUfxTmw86VmMTqlrAcsdm1Ag
                    position: 52
                    videoOwnerChannelTitle: Always Call of Duty
                    videoOwnerChannelId: UCfxTmw86VmMTqlrAcsdm1Ag
                  - kind: youtube#video
                    videoId: vwOSYnlH2XY
                    id: VVVmeFRtdzg2Vm1NVHFsckFjc2RtMUFnLnZ3T1NZbmxIMlhZ
                    privacyStatus: public
                    videoPublishedAt: '2021-05-31T10:00:24Z'
                    publishedAt: '2021-05-31T10:00:24Z'
                    channelId: UCfxTmw86VmMTqlrAcsdm1Ag
                    title: Call of Duty World at War RTX 3090 | Airfield  new
                    description: |-
                      Call of Duty World at War RTX 3090 Airfield Gameplay
                      Airfield - Team Deathmatch - 2021 - 4K - PC













                      #RTX3090 #CallofDuty #WorldatWar
                    channelTitle: Always Call of Duty
                    playlistId: UUfxTmw86VmMTqlrAcsdm1Ag
                    position: 53
                    videoOwnerChannelTitle: Always Call of Duty
                    videoOwnerChannelId: UCfxTmw86VmMTqlrAcsdm1Ag
                  - kind: youtube#video
                    videoId: rxvIGm5DmFs
                    id: VVVmeFRtdzg2Vm1NVHFsckFjc2RtMUFnLnJ4dklHbTVEbUZz
                    privacyStatus: public
                    videoPublishedAt: '2021-05-31T10:00:17Z'
                    publishedAt: '2021-05-31T10:00:17Z'
                    channelId: UCfxTmw86VmMTqlrAcsdm1Ag
                    title: >-
                      Call of Duty Black Ops Cold War RTX 3090 4K | Nuketown
                      victory
                    description: >-
                      Call of Duty Black Ops Cold War RTX 3090 4K Nuketown
                      Gameplay

                      Nuketown - Team Deathmatch - 2021 - 4K - PC


















                      #CallofDuty #BlackOps #RTX3090
                    channelTitle: Always Call of Duty
                    playlistId: UUfxTmw86VmMTqlrAcsdm1Ag
                    position: 54
                    videoOwnerChannelTitle: Always Call of Duty
                    videoOwnerChannelId: UCfxTmw86VmMTqlrAcsdm1Ag
        '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
                            received:
                              type: string
                            options:
                              type: array
                              items:
                                type: string
                          required:
                            - code
                            - message
                            - path
                      name:
                        type: string
                        enum:
                          - ZodError
                    required:
                      - issues
                      - name
                required:
                  - success
                  - error
              example:
                success: false
                error:
                  success: false
                  error:
                    issues:
                      - code: too_big
                        maximum: 24
                        type: string
                        inclusive: true
                        exact: true
                        message: String must contain exactly 24 character(s)
                        path:
                          - channelId
                    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

````