Open API v1Episodes
API: Import Episode
Import a single episode by providing a Xiaoyuzhou episode URL, an Apple Podcasts episode URL or a YouTube video URL. Only single episodes are supported — podcast or channel URLs will be rejected.
Apple Podcasts episodes can only be imported from podcasts with a public RSS feed.
Endpoint
POSThttps://app.podwise.ai/api/open/v1/episodes/import
Request Body
type RequestBody = {
// A Xiaoyuzhou episode URL, an Apple Podcasts episode URL or a YouTube video URL
// Supported formats:
// https://www.xiaoyuzhoufm.com/episode/{episode-id}
// https://podcasts.apple.com/{country}/podcast/{name}/id{podcast-id}?i={episode-id}
// https://www.youtube.com/watch?v={video-id}
// https://youtu.be/{video-id}
url: string;
};Response
type Response = {
success: true;
result: {
seq: number;
title: string;
podcastName: string;
episodeId: string;
podcastId: string;
// Unix timestamp in seconds
publishTime: number;
cover: string;
// Duration in seconds
duration: number;
};
};Error Responses
| Status | Error | Description |
|---|---|---|
| 400 | -- | Missing or invalid url, unsupported URL format, or podcast/channel URL provided. |
| 403 | private_episode | The Xiaoyuzhou episode is private and cannot be imported. |
| 403 | unavailable | The podcast is not available for public import. |
| 404 | not_found | The YouTube video or Apple Podcasts episode was not found, or the show has no public RSS feed. |
| 409 | conflict | A conflict was detected during import. Please contact support. |
| 502 | fetch_error | Failed to fetch data from the source. Please try again later. |