Unexpected "restriction" key for new "podcast with music" episodes


Unexpected "restriction" key for new "podcast with music" episodes


Expected behavior:

Return a full episode object as documented for every episode.


Current behavior:

Returns a additional "restriction" key for podcasts containing music. This might had some internal usage to exclude this episode before the feature was public. Podcasts without music don´t contain this key.




"restriction": { "reason": "product" }



Possible solution:

Document key as optional or exclude it from the publicly exposed API.



Episode with "restriction"-key: https://developer.spotify.com/console/get-episode/?id=2syAQo6ud2AjKXWctWsTXR

Episode without "restriction"-key: https://developer.spotify.com/console/get-episode/?id=4LN3xZqmFAkWoJdkZppfa4

1 Reply

Rock Star 16
Rock Star 16

Hey @tudi, thanks for coming to the Developer board to share this information!


Good question! I've taken a look and the restrictions element might be passed back when a track/album is unavailable (for the given market). Here is some information about this object from the "Get a Track"-endpoint documentation:

restrictionsa restrictions objectPart of the response when Track Relinking is applied, the original track is not available in the given market, and Spotify did not have any tracks to relink it with. The track response will still contain metadata for the original track, and a restrictions object containing the reason why the track is not available: "restrictions" : {"reason" : "market"}


Let me know if this answers your question!


Have a good one,


HuboRock Star 16
Help others find this answer and click "Accept as Solution".
If you appreciate my answer, maybe give me a Like.
Note: I'm not a Spotify employee.