Skip to content
Docs

API: List Episode Clips

Retrieve all Clips created by the authenticated user for an Episode. Clips are ordered by their generated start time or requested playback point.

Endpoint

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

Path Parameters

  • seq: Episode sequence number.

Response

type Response = {
  success: true;
  result: {
    clips: Clip[];
    clipCount: number;
    exportableClipCount: number;
    unexportableClipCount: number;
  };
  episode: {
    episodeId: string;
    seq: number;
    title: string | null;
    podcastName: string;
  };
};

type Clip = {
  id: number;
  episodeId: string;
  episodeSeq: number;
  episodeTitle: string;
  episodeCover: string | null;
  podcastName: string;
  podcastCover: string | null;
  title: string;
  takeaways: string[];
  content: string | null;
  point: number;
  clipStart: number | null;
  clipEnd: number | null;
  status: "waiting" | "processing" | "done" | "failed";
  exportable: boolean;
  // Unix timestamp in seconds
  createdAt: number;
};

Error Responses

StatusErrorDescription
400--Invalid Episode sequence number.
404not_foundEpisode does not exist.