Skip to Content
Open API v1EpisodesGet Episode Transcripts

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.


Last updated on