{"info":{"_postman_id":"ef2cd800-f212-423c-a6b9-5893600a3497","name":"Acast Publishing API","description":"

Acast's API is a collection of endpoints to let you query data about your shows and episodes, as well as creating new episodes straight from the command line or your current CMS.

Authentication

You will need an API key to authenticate your requests. Get in touch with our Customer Success team to get one set up for your account.

You'll need to send it in a header (X-API-Key) with each request. For example, using curl it would look like

curl --header \"X-API-Key: example-key\" https://open.acast.com/<url>\n\n

Rate limit

The API has a current rate limit of 60 requests/minute

Note:

This API is only for managing content in the CMS.
For serving feeds to listeners, use the RSS feed.

audio property on get/list episode is deprecated.
streamURL property on get/list episode will not work for serving private content, it also does not serve any intros or outros.

\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[{"content":"Authentication","slug":"authentication"},{"content":"Rate limit","slug":"rate-limit"},{"content":"Note:","slug":"note"}],"owner":"43277204","collectionId":"ef2cd800-f212-423c-a6b9-5893600a3497","publishedId":"2sB2cRBinC","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"publishDate":"2025-03-31T12:17:57.000Z"},"item":[{"name":"Shows","item":[{"name":"List all Shows","event":[{"listen":"test","script":{"id":"db454f22-d8fc-4e12-972c-5f2cc4b2b759","exec":[""],"type":"text/javascript","packages":{}}}],"id":"0a80c195-deba-45b4-a22c-9061d8a8aee5","request":{"method":"GET","header":[],"url":"https://open.acast.com/rest/shows","auth":{"type":"apikey","apikey":{"value":"","key":""},"isInherited":true,"source":{"_postman_id":"ef2cd800-f212-423c-a6b9-5893600a3497","id":"ef2cd800-f212-423c-a6b9-5893600a3497","name":"Acast Publishing API","type":"collection"}},"urlObject":{"protocol":"https","path":["rest","shows"],"host":["open","acast","com"],"query":[],"variable":[]}},"response":[{"id":"15f40ce5-7712-4618-a883-7e0fbd7ceab5","name":"Successful Response","originalRequest":{"method":"GET","header":[],"url":"https://open.acast.com/rest/shows"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":{"content":"","type":"text/plain"}}],"cookie":[],"responseTime":null,"body":"[\n {\n \"_id\":\"616ef0ac7d5f0200123c1f30\",\n \"cover\":\"https://assets.pippa.io/shows/undefined/1634660348261-382b155df68bfd9db9f0859cb96784fc.jpeg\",\n \"Redirect\":false,\n \"isPrivate\":false,\n \"creationDate\":\"2021-10-19T16:22:04.000Z\",\n \"title\":\"Mind Over Matter\",\n \"subtitle\":\"Mindfulness & Meditation \",\n \"Type\":\"episodic\",\n \"Explicit\":\"clean\",\n \"Alias\":\"mind-over-matter\",\n \"summary\":\"

Practicing mindfulness—being aware of one’s surroundings and present in the moment—is somewhat easier said than done. Many of us tend to go on “autopilot” for routine tasks, which can make days and even weeks pass in a blur. Turn in & tune out.

\",\n \"keywords\":\"Meditation\",\n \"Lang\":\"en\",\n \"author\":\"Acast Europe\",\n \"copyright\":\"Acast Europe\",\n \"ownerName\":\"Acast Europe\",\n \"ownerEmail\":\"europe-demo@acast.com\",\n \"categorie1\":\"Health & Fitness\",\n \"categorie2\":\"Health & Fitness|Mental Health\",\n \"categorie3\":\"Leisure|Hobbies\",\n \"Status\":\"published\",\n \"Owner\":\"609d53490224cf2e4685b2ed\",\n \"publishDate\":\"2021-11-19T14:59:22.487Z\",\n \"showId\":\"616ef0ac7d5f0200123c1f30\",\n \"link\":\"https://shows.acast.com/mind-over-matter\",\n \"accessToken\":null,\n \"Domain\":\"\",\n \"spotifyUri\":\"\",\n \"episodesCount\":9\n }\n]"}],"_postman_id":"0a80c195-deba-45b4-a22c-9061d8a8aee5"},{"name":"Get a Show","event":[{"listen":"test","script":{"id":"91fb39ea-ba25-4633-841b-32ba5a3c7ed0","exec":[""],"type":"text/javascript","packages":{}}}],"id":"8067314f-d3af-413a-aa28-bddc3930e0a3","request":{"method":"GET","header":[],"url":"https://open.acast.com/rest/shows/{showId}","auth":{"type":"apikey","apikey":{"value":"","key":""},"isInherited":true,"source":{"_postman_id":"ef2cd800-f212-423c-a6b9-5893600a3497","id":"ef2cd800-f212-423c-a6b9-5893600a3497","name":"Acast Publishing API","type":"collection"}},"urlObject":{"protocol":"https","path":["rest","shows","{showId}"],"host":["open","acast","com"],"query":[],"variable":[]}},"response":[{"id":"82149252-e2d5-48f0-8678-201f6ca5b465","name":"Successful Response","originalRequest":{"method":"GET","header":[],"url":"https://open.acast.com/rest/shows/5bcb76ef0d46b9226faefe92"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":{"content":"","type":"text/plain"}}],"cookie":[],"responseTime":null,"body":"{\n \"_id\":\"609e4b3069be6d6524986cee\",\n \"cover\":\"https://assets.pippa.io/shows/609e4b3069be6d6524986cee/1622804989335-5d65babe1dd0c5e6b2c40bca77bfa775.jpeg\",\n \"Redirect\":false,\n \"isPrivate\":false,\n \"creationDate\":\"2021-05-14T10:04:32.000Z\",\n \"Alias\":\"inside-the-eurovision-song-contest\",\n \"summary\":\"

What makes the Eurovision Song Contest so popular? Why do so many people love to hate it? Is the voting fair? Will Ireland ever win again? Is Australia the only non-European country to take part?

\",\n \"categorie1\":\"Music|Music Commentary\",\n \"categorie2\":\"Music|Music History\",\n \"categorie3\":\"TV & Film|After Shows\",\n \"Status\":\"published\",\n \"title\":\"Inside the Eurovision Song Contest\",\n \"Type\":\"episodic\",\n \"Explicit\":\"no\",\n \"keywords\":\"ESC, Eurovision\",\n \"Lang\":\"en\",\n \"author\":\"Acast Europe\",\n \"copyright\":\"Acast Europe\",\n \"ownerName\":\"Acast Europe\",\n \"ownerEmail\":\"europe-demo@acast.com\",\n \"Owner\":\"609d53490224cf2e4685b2ed\",\n \"publishDate\":\"2021-11-19T14:58:10.555Z\",\n \"showId\":\"609e4b3069be6d6524986cee\",\n \"accessToken\":null,\n \"link\":\"https://shows.acast.com/inside-the-eurovision-song-contest\",\n \"Domain\":\"\",\n \"spotifyUri\":\"\",\n \"Subtitle\":\"\",\n \"episodesCount\":3\n}"}],"_postman_id":"8067314f-d3af-413a-aa28-bddc3930e0a3"}],"id":"e733bdde-c30a-4ebd-9783-31ad5a7aa3c4","_postman_id":"e733bdde-c30a-4ebd-9783-31ad5a7aa3c4","description":"","auth":{"type":"apikey","apikey":{"value":"","key":""},"isInherited":true,"source":{"_postman_id":"ef2cd800-f212-423c-a6b9-5893600a3497","id":"ef2cd800-f212-423c-a6b9-5893600a3497","name":"Acast Publishing API","type":"collection"}}},{"name":"Episodes","item":[{"name":"List all Episodes","id":"28a986f4-ad4b-4cd4-83d2-9db4c2dd3c69","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://open.acast.com/rest/shows/{showId}/episodes","auth":{"type":"apikey","apikey":{"value":"","key":""},"isInherited":true,"source":{"_postman_id":"ef2cd800-f212-423c-a6b9-5893600a3497","id":"ef2cd800-f212-423c-a6b9-5893600a3497","name":"Acast Publishing API","type":"collection"}},"urlObject":{"protocol":"https","path":["rest","shows","{showId}","episodes"],"host":["open","acast","com"],"query":[],"variable":[]}},"response":[{"id":"fe379611-8fa0-4da8-b761-1a8d836ed4df","name":"List all Episodes","originalRequest":{"method":"GET","header":[],"url":"https://open.acast.com/rest/shows/{showId}/episodes"},"_postman_previewlanguage":"Text","header":null,"cookie":[],"responseTime":null,"body":"[\n {\n \"_id\":\"609e55b9f69c17229c1bdcd4\",\n \"audio\":\"https://assets.pippa.io/shows/609e4b3069be6d6524986cee/1621410644716-c0101be2c3d5fd99355ce551a7e17497.mp3\",\n \"cover\":\"https://assets.pippa.io/shows/609e4b3069be6d6524986cee/1622805074814-2e8dd434ebc9db8945adbdc63d936537.jpeg\",\n \"Explicit\":false,\n \"creationDate\":\"2021-05-14T10:49:29.069Z\",\n \"lastEditedDate\":\"2021-11-19T14:58:10.555Z\",\n \"Markers\":\n [\n {\n \"_id\":\"6197bb4526fbf000122dc395\",\n \"Placement\":\"preroll\",\n \"Start\":263.82399999999996\n },\n {\n \"_id\":\"6197bb4526fbf000122dc394\",\n \"Placement\":\"postroll\",\n \"Start\":1916.5857401374997\n },\n {\n \"_id\":\"6197bb4526fbf000122dc393\",\n \"Placement\":\"midroll\",\n \"Start\":1049.1039999999998\n }\n ],\n \"Show\":\"609e4b3069be6d6524986cee\",\n \"Duration\":2034.632,\n \"title\":\"Swedish Domination\",\n \"Type\":\"full\",\n \"Season\":null,\n \"episodeNumber\":3,\n \"summary\":\"

In this episode we're talking to Swedish legend Max Martin, the genius behind many of the biggest hits of the past twenty years. He is music’s magic melody man, the master hooksmith responsible for twenty-one No. 1 Billboard hits including the Backstreet Boys, ’NSync, Britney Spears, Katy Perry, Taylor Swift, and the Weeknd.

The United Kingdolls were awarded douze points from the Ruruvision judges. Is this the UK's chance to break their losing streak at the Eurovision?

\",\n \"Alias\":\"uk-hun\",\n \"publishDate\":\"2021-05-07T10:27:31.435Z\",\n \"Status\":\"published\",\n \"Owner\":\"609d53490224cf2e4685b2ed\",\n \"streamUrl\":\"https://feeds.acast.com/public/streams/609e4b3069be6d6524986cee/episodes/609e5093b7d032227d1bd3a0.mp3\"\n }\n]"}],"_postman_id":"28a986f4-ad4b-4cd4-83d2-9db4c2dd3c69"},{"name":"Get an Episode","id":"c4548e39-5bf6-4be9-8fdf-2901be4e3723","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://open.acast.com/rest/shows/{showId}/episodes/{episodeId}","auth":{"type":"apikey","apikey":{"value":"","key":""},"isInherited":true,"source":{"_postman_id":"ef2cd800-f212-423c-a6b9-5893600a3497","id":"ef2cd800-f212-423c-a6b9-5893600a3497","name":"Acast Publishing API","type":"collection"}},"urlObject":{"protocol":"https","path":["rest","shows","{showId}","episodes","{episodeId}"],"host":["open","acast","com"],"query":[],"variable":[]}},"response":[{"id":"c8fda6f3-b73f-4d0b-9a57-6898d7538057","name":"Get an Episode","originalRequest":{"method":"GET","header":[],"url":"https://open.acast.com/rest/shows/{showId}/episodes/{episodeId}"},"_postman_previewlanguage":"Text","header":null,"cookie":[],"responseTime":null,"body":"{\n \"_id\":\"609e55b9f69c17229c1bdcd4\",\n \"audio\":\"https://assets.pippa.io/shows/609e4b3069be6d6524986cee/1621410644716-c0101be2c3d5fd99355ce551a7e17497.mp3\",\n \"cover\":\"https://assets.pippa.io/shows/609e4b3069be6d6524986cee/1622805074814-2e8dd434ebc9db8945adbdc63d936537.jpeg\",\n \"Explicit\":false,\n \"creationDate\":\"2021-05-14T10:49:29.069Z\",\n \"lastEditedDate\":\"2021-11-19T14:58:10.555Z\",\n \"Markers\":\n [\n {\n \"_id\":\"6197bb4526fbf000122dc395\",\n \"Placement\":\"preroll\",\n \"Start\":263.82\n },\n {\n \"_id\":\"6197bb4526fbf000122dc394\",\n \"Placement\":\"postroll\",\n \"Start\":1916.58\n },\n {\n \"_id\":\"6197bb4526fbf000122dc393\",\n \"Placement\":\"midroll\",\n \"Start\":1049.103\n }\n ],\n \"Show\":\"609e4b3069be6d6524986cee\",\n \"Duration\":2034.632,\n \"title\":\"Swedish Domination\",\n \"Type\":\"full\",\n \"Season\":null,\n \"episodeNumber\":3,\n \"Summary\":\n \"

\",\n \"Alias\":\"swedish-domination\",\n \"publishDate\":\"2021-05-14T10:50:29.033Z\",\n \"Status\":\"published\",\n \"Owner\":\"609d53490224cf2e4685b2ed\",\n \"streamUrl\":\"https://feeds.acast.com/public/streams/609e4b3069be6d6524986cee/episodes/609e55b9f69c17229c1bdcd4.mp3\"\n}"}],"_postman_id":"c4548e39-5bf6-4be9-8fdf-2901be4e3723"},{"name":"Delete an Episode","id":"c5d5c128-c01e-49d3-a564-70f412f6bafd","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"DELETE","header":[],"url":"https://open.acast.com/rest/shows/{showId}/episodes/{episodeId}","auth":{"type":"apikey","apikey":{"value":"","key":""},"isInherited":true,"source":{"_postman_id":"ef2cd800-f212-423c-a6b9-5893600a3497","id":"ef2cd800-f212-423c-a6b9-5893600a3497","name":"Acast Publishing API","type":"collection"}},"urlObject":{"protocol":"https","path":["rest","shows","{showId}","episodes","{episodeId}"],"host":["open","acast","com"],"query":[],"variable":[]}},"response":[{"id":"47b1d2be-cb70-48a5-bcf5-64c860b887d1","name":"Delete an Episode","originalRequest":{"method":"DELETE","header":[],"url":"https://open.acast.com/rest/shows/{showId}/episodes/{episodeId}"},"_postman_previewlanguage":"Text","header":null,"cookie":[],"responseTime":null,"body":null}],"_postman_id":"c5d5c128-c01e-49d3-a564-70f412f6bafd"},{"name":"Update an Episode","id":"149932e6-3bf6-4ab6-a202-81516b49402e","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"PATCH","header":[],"url":"","auth":{"type":"apikey","apikey":{"value":"","key":""},"isInherited":true,"source":{"_postman_id":"ef2cd800-f212-423c-a6b9-5893600a3497","id":"ef2cd800-f212-423c-a6b9-5893600a3497","name":"Acast Publishing API","type":"collection"}},"urlObject":{"query":[],"variable":[]}},"response":[{"id":"d493e7b5-9bb5-495d-b705-101388aa9d74","name":"Update an Episode","originalRequest":{"method":"PATCH","header":[],"url":"https://open.acast.com/rest/shows/{showId}/episodes/{episodeId}"},"_postman_previewlanguage":"Text","header":null,"cookie":[],"responseTime":null,"body":"{\n \"lastEditedDate\": \"2018-10-15T20:23:34.561Z\",\n \"title\": \"Episode Title\",\n \"subtitle\": \"Episode Subtitle\",\n \"status\": \"published\",\n \"owner\": \"59531603ace983f260682fdb\",\n \"show\": \"5bbde56a6916956ba08bc21e\",\n \"audio\": \"https://assets.acast.com/shows/5bbde56a6916956ba08bc21e/aee0ceb6-d49f-11e8-a8d5-f2801f1b9fd1.mp3\",\n \"explicit\": false,\n \"creationDate\": \"2018-10-15T20:23:34.135Z\",\n \"_id\": \"5bc4f746de48d76cff24c6ca\",\n \"streamUrl\": \"https://open.acast.com/public/streams/5bbde56a6916956ba08bc21e/episodes/5bc4f746de48d76cff24c6ca.mp3\"\n}"}],"_postman_id":"149932e6-3bf6-4ab6-a202-81516b49402e"},{"name":"Create an Episode","id":"fd49e95a-1cae-49ed-a562-43485647715d","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"formdata","formdata":[{"key":"title","value":" Episode title","type":"text"},{"key":"subtitle","value":" Episode subtitle","type":"text"},{"key":"summary","value":" Episode summary (should be less than the recommended 4000 characters limit)","type":"text"},{"key":"alias","value":" Url friendly title, used for SEO and links purposes","type":"text"},{"key":"link","value":" A link to your episode. If not set then we will use your link on https://shows.acast.com","type":"text"},{"key":"publishDate","value":" Publication date","type":"text"},{"key":"season","value":" Indicating the season number","type":"text"},{"key":"episodeNumber","value":" Indicating the episode number","type":"text"},{"key":"type","value":" Can be 'full', 'trailer' or 'bonus'","type":"text"},{"key":"explicit","value":" Set to true if your episoe contains explicit langage","type":"text"},{"key":"audio","value":" The path to your audio file to upload","type":"text"},{"key":"duration","value":" Duration (in seconds) of your episode","type":"text"},{"key":"cover","value":" The path to your cover file to upload","type":"text"},{"key":"status","value":" Can be 'disabled', ''draft', 'published' or 'scheduled'","type":"text"},{"key":"markers","value":" An Array specifying the position of your ad markers. For example: ['preroll,25, postroll'] will create: preroll marker at the beginning of the episode, midroll marker at the 25th second, postroll marker at the end of the file","type":"text"},{"key":"privateIntro","value":" The path to an intro file for private episodes","type":"text"},{"key":"privateOutro","value":" The path to an outro for private episodes","type":"text"},{"key":"publicIntro","value":" The path to an intro for public episodes","type":"text"},{"key":"publicOutro","value":" The path to an outro for public episodes","type":"text"}]},"url":"https://open.acast.com/rest/shows/{showId}/episodes","auth":{"type":"apikey","apikey":{"value":"","key":""},"isInherited":true,"source":{"_postman_id":"ef2cd800-f212-423c-a6b9-5893600a3497","id":"ef2cd800-f212-423c-a6b9-5893600a3497","name":"Acast Publishing API","type":"collection"}},"urlObject":{"protocol":"https","path":["rest","shows","{showId}","episodes"],"host":["open","acast","com"],"query":[],"variable":[]}},"response":[{"id":"403d94c4-7868-4699-ac60-293f611ec261","name":"Create an Episode","originalRequest":{"method":"GET","header":[],"url":"https://open.acast.com/rest/shows/{showId}/episodes/{episodeId}"},"_postman_previewlanguage":"Text","header":null,"cookie":[],"responseTime":null,"body":"{\n \"lastEditedDate\": \"2018-10-15T20:23:34.561Z\",\n \"title\": \"Episode Title\",\n \"subtitle\": \"Episode Subtitle\",\n \"status\": \"published\",\n \"owner\": \"59531603ace983f260682fdb\",\n \"show\": \"5bbde56a6916956ba08bc21e\",\n \"audio\": \"https://assets.acast.com/shows/5bbde56a6916956ba08bc21e/aee0ceb6-d49f-11e8-a8d5-f2801f1b9fd1.mp3\",\n \"explicit\": false,\n \"creationDate\": \"2018-10-15T20:23:34.135Z\",\n \"_id\": \"5bc4f746de48d76cff24c6ca\",\n \"streamUrl\": \"https://open.acast.com/public/streams/5bbde56a6916956ba08bc21e/episodes/5bc4f746de48d76cff24c6ca.mp3\",\n \"markers\": [\"preroll\"]\n}"}],"_postman_id":"fd49e95a-1cae-49ed-a562-43485647715d"}],"id":"cdbeebff-965e-477b-bcf6-a699cb356b29","_postman_id":"cdbeebff-965e-477b-bcf6-a699cb356b29","description":"","auth":{"type":"apikey","apikey":{"value":"","key":""},"isInherited":true,"source":{"_postman_id":"ef2cd800-f212-423c-a6b9-5893600a3497","id":"ef2cd800-f212-423c-a6b9-5893600a3497","name":"Acast Publishing API","type":"collection"}}}],"auth":{"type":"apikey","apikey":{"value":"","key":""}},"event":[{"listen":"prerequest","script":{"id":"e5789a4b-20c0-47ae-bfa9-6be91fa22b4a","type":"text/javascript","requests":{},"exec":[""]}},{"listen":"test","script":{"id":"43a42b25-d90e-48ef-8a0e-a4e8a83cb785","type":"text/javascript","requests":{},"exec":[""]}}],"variable":[{"key":"token","value":""}]}