Skip to content
Docs
Open API v1Episodes

API: Get Episode Transcripts

Retrieve the text transcripts for a specific episode.

Endpoint

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

Path Parameters

  • seq: Episode sequence number.

Query Parameters

  • translation: Translation language. When provided, returns the translated transcripts. One of: "Chinese", "Traditional Chinese", "English", "Japanese", "Korean".

Response

type Response = {
  success: true;
  result: {
    // Time string in MM:SS or HH:MM:SS format
    time: string;
    // Start time in seconds (floating point), optional
    start?: number;
    // End time in seconds (floating point), optional
    end?: number;
    content: string;
    // Optional, automatically resolved to display name when available
    speaker?: string;
    // Optional
    language?: string;
  }[];
  episode: {
    episodeId: string;
    seq: number;
    title: string;
    podcastName: string;
    cover: string;
    epCover: string | null;
    description: string | null;
    publishTime: number;
    link: string;
    linkType: string;
    duration: number | null;
    transcribed: boolean;
    language: string | null;
  };
};

Error Responses

StatusErrorDescription
403copyright_deniedEpisode is unavailable.
404not_foundEpisode does not exist.
404not_transcribedEpisode exists but has not been transcribed yet.
404not_translatedEpisode is transcribed but the requested translation is not available yet.
429rate_limitedThe transcripts quota for your plan is used up. Shared with Markdown and SRT export. See content quotas.

Only requests that return the transcript count toward the quota. To wait for an episode to finish processing, poll Get Episode Status instead of this endpoint.