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

# Get podcast episodes

> Get episodes from a specific podcast show



## OpenAPI

````yaml api-reference/spotify-openapi.json get /api/v1/podcasts/episodes
openapi: 3.1.0
info:
  title: Spotify APIs
  description: Spotify API Documentation
  version: 1.0.0
servers:
  - url: https://spotify-api31.p.rapidapi.com
security: []
paths:
  /api/v1/podcasts/episodes:
    get:
      tags:
        - Podcasts
      summary: Get podcast episodes
      description: Get episodes from a specific podcast show
      operationId: getApiV1PodcastsEpisodes
      parameters:
        - in: query
          name: uri
          schema:
            type: string
            pattern: ^spotify:show:[a-zA-Z0-9]+$
            description: Spotify podcast show URI to get episodes from
            example: spotify:show:00wEJsU0XM16HnVSu4c8hd
          required: true
        - in: query
          name: offset
          schema:
            type: number
            minimum: 0
            default: 0
            description: Offset for pagination
            example: 0
          required: false
        - in: query
          name: limit
          schema:
            type: number
            minimum: 1
            maximum: 300
            default: 50
            description: Number of results to return
            example: 50
          required: false
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                    example: Success
                  statusCode:
                    type: number
                    example: 200
                  pagination:
                    type: object
                    properties:
                      total:
                        type: number
                        example: 100
                      hasMore:
                        type: boolean
                        example: true
                      continuation:
                        type:
                          - string
                          - 'null'
                        description: Continuation token for pagination
                        example: CDsQ8FsiEwje95_F1pmRAxXlsykDHUX
                  data:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                          description: Episode ID
                          example: 1loeWEN8v8pVAddWuKz33C
                        name:
                          type: string
                          description: Episode name
                          example: >-
                            AWH: Taylor Swifts Eras Tour Bonuses & Celebrity
                            Gossip We Cant Confirm with Justin Sylvester
                        uri:
                          type: string
                          description: Spotify episode URI
                          example: spotify:episode:1loeWEN8v8pVAddWuKz33C
                        description:
                          type: string
                          description: Episode description
                          example: >-
                            Today, we are in our Justin Sylvester era!! From
                            Taylor Swifts Eras Tour bonuses...
                        htmlDescription:
                          type: string
                          description: HTML formatted episode description
                          example: >-
                            <p>Today, we are in our Justin Sylvester era!! From
                            Taylor Swifts Eras Tour bonuses</p>
                        duration:
                          type: number
                          description: Episode duration in milliseconds
                          example: 1603369
                        releaseDate:
                          type: object
                          properties:
                            isoString:
                              type: string
                              description: Release date in ISO string format
                              example: '2025-12-18T08:00:00Z'
                            precision:
                              type: string
                              description: Date precision
                              example: MINUTE
                          required:
                            - isoString
                          description: Episode release date information
                        coverArt:
                          type: array
                          items:
                            type: object
                            properties:
                              url:
                                type: string
                                description: Image URL
                                example: >-
                                  https://i.scdn.co/image/ab6765630000f68d94f52ca224075c6411271ad4
                              width:
                                type: number
                                description: Image width in pixels
                                example: 64
                              height:
                                type: number
                                description: Image height in pixels
                                example: 64
                            required:
                              - url
                              - width
                              - height
                          description: Array of episode cover images
                        playability:
                          type: object
                          properties:
                            playable:
                              type: boolean
                              description: Whether the episode is playable
                              example: true
                          required:
                            - playable
                          description: Episode playability information
                      required:
                        - id
                        - name
                        - uri
                        - duration
                    description: Array of podcast episodes
                required:
                  - data
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                    example: Bad request
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                    example: Invalid API key
        '403':
          description: Not Found
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                    example: >-
                      You are not subscribed to this API, please subscribe
                      before using
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: false
                  message:
                    type: string
                    example: Internal Server Error
                  status_code:
                    type: number
                    example: 500
                  cost:
                    type: number
                    example: 0
                  explain:
                    type: string
                    example: Internal Server Error
      security:
        - apiKeyAuth: []
components:
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: x-rapidapi-key
      description: API Key

````