Open API v1Episodes
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
| Status | Error | Description |
|---|---|---|
| 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 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.