Skip to main content

GET Podcast Audios with Pagination

Overview


The following table contains important information about the GET method in regards to receiving paged podcast audios for the player configuration.

GET Podcast Audios with Pagination
MethodGET
URL or Endpoint/podcast/podcastId/audios
HeadersNot Applicable
ParameterspodcastId, page, take
BodyNot Applicable

The description of the URL parameter is as follows:

podcastId URL Parameter
URL Parameter NamepodcastId
MandatoryYes
Typestring
DescriptionUnique Id of the podcast.

The description of query parameters is as follows:

Parameter NameMandatoryTypeDescription
pageNointegerPage number (default: 1).
takeNointegerNumber of items per page (default: 10).

Request Body

The request does not contain a request body

Response

{
"podcastId": "{podcastId}",
"title": "{title}",
"audios": {
"currentPage": 1,
"totalPages": 1,
"pageSize": 10,
"totalCount": 1,
"items": [
{
"mediaId": "{mediaId}",
"title": "{title}",
"author": "{author}",
"publishDate": "2026-03-27T12:00:00.000Z",
"thumbnailUrl": "{thumbnailUrl}",
"duration": 224.664,
"durationString": "{durationString}",
"hlsUrl": "{hlsUrl}"
}
]
}
}

Information about the fields that appear when you receive the response are displayed in the table below.

Field NameTypeDescription
podcastIdstringThe unique Id of the podcast.
titlestringThe title of the podcast.
audiosobjectPaginated list of audio episodes.
currentPageintegerThe current page number.
totalPagesintegerThe total number of pages.
pageSizeintegerThe number of items per page.
totalCountintegerThe total number of audio episodes in the podcast.
itemsarray[object]Array of audio episodes on the current page.
mediaIdstringThe unique Id of the audio episode.
titlestringThe title of the audio episode.
authorstringThe author of the audio episode.
publishDatestring($date-time)The publish date of the audio episode.
thumbnailUrlstringURL of the audio episode thumbnail.
durationnumberDuration of the audio episode in seconds.
durationStringstringHuman-readable duration of the audio episode.
hlsUrlstringThe HLS stream URL for the audio episode.

If the action is successful, the service sends back an HTTP 200 or 201 response.

Errors

For information about the errors that are common to all actions, see Common Errors:

  • HTTP Status Code 400: Bad Request

  • HTTP Status Code 401: Unauthorized

  • HTTP Status Code 403: Forbidden

  • HTTP Status Code 404: Result Not Found

  • HTTP Status Code 500: Internal Server Error

  • HTTP Status Code 503: Backend Fetch Failed