Skip to content
Docs
Open API v1Discovery

API: List Podcast Episodes

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

Endpoint

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