Open API v1Export & Integrations
API: Export Episode as SRT
Export a processed episode's transcript as SRT subtitles. Each transcript segment becomes one subtitle cue with its start and end time. Speaker names are not included.
Endpoint
POSThttps://app.podwise.ai/api/open/v1/episodes/[seq]/export/srt
Path Parameters
seq: Episode sequence number.
Request Body
All fields are optional.
type RequestBody = {
// Translation language code (e.g., "Chinese", "Japanese"). null for original language
translation?: string | null;
// Output bilingual subtitles with both original and translated text when translation is set. Default: false
mixWithOriginLanguage?: boolean;
// In bilingual subtitles, put the translated line above the original line. Default: false
translationFirst?: boolean;
};Response
Save result.srt as a UTF-8 .srt file.
type Response = {
success: true;
result: {
// The generated SRT content
srt: string;
};
episode: {
episodeId: string;
seq: number;
title: string;
podcastName: string;
cover: string;
epCover: string | 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;
language: string | null;
};
};Error Responses
| Status | Error | Description |
|---|---|---|
| 402 | -- | Open API or export is not available for the current plan. |
| 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. Markdown export, SRT export and Get Episode Transcripts share it. See content quotas. |
Only requests that return the subtitles count toward the quota.