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
| Status | Error | Description |
|---|---|---|
| 403 | copyright_denied | Episode is unavailable. |
| 404 | not_found | Episode does not exist. |
| 404 | not_transcribed | Episode exists but has not been transcribed yet. |
| 404 | not_translated | Episode is transcribed but the requested translation is not available yet. |
| 429 | rate_limited | The 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.