---
title: "GET /api/v2/podcasts/{podcastKey}/episodes"
method: GET
path: "/api/v2/podcasts/{podcastKey}/episodes"
tags: ["API-v2"]
---

# GET /api/v2/podcasts/{podcastKey}/episodes

`GET /api/v2/podcasts/{podcastKey}/episodes`

Get podcast episodes

## Path parameters

- `podcastKey` string, required

## Query parameters

- `limit` string
- `offset` string

## Response `200`

OK

## Changes

- **2026-08-21** `6cebdc059200` — 1 breaking, 2 warning
  - for the `query` request parameter `limit`, the max was decreased from `1000.00` to `100.00`
  - for the `query` request parameter `offset`, the max was set to `1000.00`
  - removed the optional property `items/items/tags` from the response with the `200` status
- **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

[Change history](https://skmtc.dev/zeno/apis/aggregators-api-service/changes/api/v2/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-service-production.skmtc.workers.dev/v1/apis/zeno/aggregators-api-service/revisions/59afc5b05240/schema)