Open API v1Export & Integrations
API: Export Episode as Markdown
Export a processed episode's content as a Markdown string. The generated Markdown includes episode metadata, summary, takeaways, Q&A, outlines, keywords, highlights, and transcript.
Endpoint
POSThttps://app.podwise.ai/api/open/v1/episodes/[seq]/export/markdown
Path Parameters
seq: Episode sequence number.
Request Body
All fields are optional.
type RequestBody = {
// Group transcript by outline sections. Default: false
mixOutlines?: boolean;
// Translation language code (e.g., "Chinese", "Japanese"). null for original language
translation?: string | null;
// Show both original and translated text when translation is set. Default: false
mixWithOriginLanguage?: boolean;
// Markdown format dialect. One of: "common", "obsidian", "logseq". Default: "common"
dialect?: "common" | "obsidian" | "logseq";
};Response
type Response = {
success: true;
result: {
// The generated Markdown content
markdown: 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 Markdown count toward the quota.