Skip to content
Docs
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

StatusErrorDescription
402--Open API or export is not available for the current plan.
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. Markdown export, SRT export and Get Episode Transcripts share it. See content quotas.

Only requests that return the Markdown count toward the quota.