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

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

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

## Request

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

Get podcast episodes

## Path parameters

- `podcastKey` string, required

## Query parameters

- `limit` string
- `offset` string

## Response `200`

OK

- PBPodcastEpisode[]
  - `podcast` string: Podcast key
  - `key` string: Episode key
  - `explicit` boolean
  - `published` boolean
  - `duration` integer: Episode duration in seconds
  - `size` integer: Episode size in bytes
  - `author` string
  - `image` string
  - `link` string
  - `title` string
  - `subtitle` string
  - `summary` string
  - `description` string
  - `publish_date` string
  - `upload_status` string
  - `file_url` string

## Changes

- **2026-07-26** `cf4d10f16c63`: 2 breaking
  - for the `query` request parameter `limit`, default value `10` was added
  - for the `query` request parameter `offset`, default value `0` was added
- **2026-07-13** `104d35bf8984`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/zeno/apis/aggregators-api-service/changes/podcast-bot/podcasts/:podcastKey/episodes/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)