Skip to Content
Open API v1EpisodesGet Episode Summary

API: Get Episode Summary

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

Endpoint

GEThttps://app.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, }, }

Error Responses

StatusErrorDescription
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 summary quota for your plan is used up. See content quotas.

Only requests that return the summary count toward the quota. To wait for an episode to finish processing, poll Get Episode Status instead of this endpoint.


Last updated on