API: Get Episode Summary

Retrieve the AI-generated summary, chapters, mind map, and other metadata for a specific episode.

Endpoint

GEThttps://podwise.ai/api/open/v1/episodes/[seq]/summary

Path Parameters

seq: Episode sequence number (found in search results or Podwise URL).

Query Parameters

translation: Translation language. When provided, returns the translated summary. One of: "Chinese", "Traditional Chinese", "English", "Japanese", "Korean".

Response


type Response = {
  success: true,
  result: {
    // Overall episode summary
    summary: string,
    keywords: {
      key: string,
      desc: string,
    }[],
    chapters: {
      // Time string in MM:SS or HH:MM:SS format
      time: string,
      title: string,
      summary: string,
      has_ads: boolean,
    }[],
    // Mindmap in markdown format
    mindmap: string,
    // Optional fields - may not be present for every episode
    chapter_parts?: {
      time: string,
      title: string,
      start: number,
      end: number,
    }[],
    qas?: {
      question: string,
      answer: string,
      question_speaker: string,
      answer_speaker: string,
    }[],
    takeaways?: string[],
    highlights?: {
      time: string,
      content: string,
    }[],
    titles?: string[],
    intros?: string[],
    timestamps?: 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,
  },
}

Authorization Error Codes