API: List Followed Episodes

Retrieve episodes from all podcasts the authenticated user has followed within a date range, sorted by publish time (newest first).

Endpoint

GEThttps://podwise.ai/api/open/v1/user/episodes/followed

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 30. 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