Skip to content
Docs

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://app.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;
  }[];
};