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

StatusErrorDescription
400--Missing or invalid url, unsupported URL format, or podcast/channel URL provided.
403private_episodeThe Xiaoyuzhou episode is private and cannot be imported.
403unavailableThe podcast is not available for public import.
404not_foundThe YouTube video or Apple Podcasts episode was not found, or the show has no public RSS feed.
409conflictA conflict was detected during import. Please contact support.
502fetch_errorFailed to fetch data from the source. Please try again later.