---
title: "GET /podcast-bot/podcasts/{podcastKey}/videos"
method: GET
path: "/podcast-bot/podcasts/{podcastKey}/videos"
tags: ["Podcast Bot"]
---

# GET /podcast-bot/podcasts/{podcastKey}/videos

`GET /podcast-bot/podcasts/{podcastKey}/videos`

## Request

- Base URL: `https://api.zeno.fm`
- URL: `https://api.zeno.fm/podcast-bot/podcasts/{podcastKey}/videos`
- Auth: none declared
- TypeScript: <https://skmtc.dev/zeno/apis/aggregators-api-service/docs/podcast-bot/podcasts/:podcastKey/videos/get.ts> (a function with typed inputs; its response is checked against the schema)

List the videos of all episodes of the specified podcast, newest episode first

## Path parameters

- `podcastKey` string, required

## Query parameters

- `limit` string
- `offset` string

## Response `200`

OK

- PBEpisodeVideoList: A page of episode videos, together with the total number of videos of the podcast
  - `data` PBEpisodeVideo[]: The requested page of videos
    - `id` integer
    - `episodeKey` string: Key of the episode the video belongs to
    - `name` string
    - `encoding` string
    - `fileSize` integer: Video file size in bytes
    - `duration` integer: Video duration in seconds
    - `aspectRatio` string: Aspect ratio of the video, e.g. 16:9
    - `fileUrl` string
    - `srtFileUrl` string: Url of the subtitles file, when one was generated
    - `creationDate` string, date-time
    - `lastUpdate` string, date-time
  - `total` integer: Total number of videos of the podcast, across all pages

## Changes

- **2026-09-07** `ff11223d18fb`: 1 breaking, 4 info
  - the response's body type changed from `array` to `object` for status `200`
  - added the new optional `query` request parameter `limit`
  - added the new optional `query` request parameter `offset`
  - added the optional property `data` to the response with the `200` status
  - …1 more
- **2026-08-24** `59afc5b05240`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/zeno/apis/aggregators-api-service/changes/podcast-bot/podcasts/:podcastKey/videos/get.md)

---

[API](https://skmtc.dev/zeno/apis/aggregators-api-service.md) - [All operations](https://skmtc.dev/zeno/apis/aggregators-api-service/llms.txt) - [OpenAPI document](https://skmtc.dev/zeno/apis/aggregators-api-service/revisions/e6ef499b4111?raw)