API: List Podcast Episodes

Retrieve episodes for a specific podcast within a date range, sorted by publish time (newest first).

Endpoint

GEThttps://podwise.ai/api/open/v1/podcasts/[seq]/episodes

Path Parameters

seq: Podcast sequence number.

Query Parameters

date: End date in YYYY-MM-DD format. The query covers up to this date (inclusive). Default is today.
days: Number of days to look back from date (inclusive). Max 365. Default is 7.

Response


type Response = {
  success: true,
  result: {
    episodeId: string,
    seq: number,
    title: string,
    podcastName: string,
    cover: string,
    // May be null
    epCover: string | null,
    // May be null
    description: string | null,
    // Unix timestamp in seconds
    publishTime: number,
    link: string,
    linkType: string,
    // Duration in seconds, may be null
    duration: number | null,
    transcribed: boolean,
    // May be null
    language: string | null,
    // Whether the authenticated user has marked this episode as read
    isRead: boolean,
  }[],
}

Authorization Error Codes