{"openapi":"3.0.1","info":{"title":"Shownotes","description":"Extract podcast transcript.","version":"v1"},"paths":{"/apple.php":{"get":{"operationId":"AppleSearch","description":"Takes an episode as input and returns up to 3 matching episodes on Apple podcasts. Ask the user which one they would like to transcribe. Allow the user to click the enclosure link to listen and show the artwork if available.","parameters":[{"in":"query","name":"q","schema":{"type":"string"},"required":true,"description":"Search for episode"}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"podcast":{"type":"string","description":"Name of the podcast."},"title":{"type":"string","description":"Title of the episode."},"releaseDate":{"type":"string","format":"date-time","description":"Release date of the episode."},"enclosure":{"type":"string","format":"uri","description":"URL to the audio file of the episode."},"description":{"type":"string","description":"Episode description."},"artwork":{"type":"string","format":"uri","description":"URL to Episode artwork 160px"},"protect":{"type":"boolean","description":"If true, do not allow transcribe."}}}}}}}}}},"/airplugin.php":{"get":{"operationId":"AudioTranscribe","description":"Takes the enclosure, podcast, and title parameters from the AppleSearch endpoint as input and returns a link called audiolink where the transcript will appear. Let the user know this may take a few minutes & will get an email when ready. Do not allow transcription if protect is true.","parameters":[{"in":"query","name":"enclosure","schema":{"type":"string"},"required":true,"description":"Link to the episode"},{"in":"query","name":"podcast","schema":{"type":"string"},"required":true,"description":"Podcast name"},{"in":"query","name":"title","schema":{"type":"string"},"required":true,"description":"Episode title"}],"responses":{"200":{"description":"Transcription request accepted","content":{"application/json":{"schema":{"type":"object","properties":{"audiolink":{"type":"string","format":"uri","description":"Link where the transcript will appear."}}}}}}}}},"/captions-shownotes.php":{"get":{"description":"Search shownotes.io with show and return transcript.","operationId":"AudioController_findTranscript","parameters":[{"name":"show","in":"query","schema":{"type":"string"},"description":"The show name"}],"responses":{"200":{"description":"A JSON object of the transcript","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TranscriptSchema"}}}}}}},"/search-youtube.php":{"get":{"description":"Search YouTube for podcasts matchng show, returns array of 3 videos.","operationId":"SearchController_findVideos","parameters":[{"name":"show","in":"query","schema":{"type":"string"},"description":"The show name"}],"responses":{"200":{"description":"A JSON object with an array of 3 video ids","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListVideo"}}}}}}},"/captions-youtube.php":{"get":{"description":"Extract transcript of YouTube video using videoid. Only use the transcript returned when making a summary or if questions are asked about the transcript. Do not embellish in any way. Let the user know we also sent an email summary to their inbox.","operationId":"CaptionController_findTranscript","parameters":[{"name":"videoid","in":"query","schema":{"type":"string"},"description":"The 11-character Youtube videoid."}],"responses":{"200":{"description":"A JSON object of the transcript in 2 parts, chunk1 and chunk2","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TranscriptSchema"}}}}}}}},"components":{"schemas":{"TranscriptSchema":{"type":"object","properties":{"transcript":{"type":"object","properties":{"chunk1":{"type":"string","description":"First chunk of transcript"},"chunk2":{"type":"string","description":"Next chunk of transcript"}}}}},"VideoItem":{"type":"object","properties":{"name":{"type":"string"},"videoid":{"type":"string"}}},"ListVideo":{"type":"array","items":{"$ref":"#/components/schemas/VideoItem"}}}},"servers":[{"url":"https://plugins.shownotes.io"}]}