Help Wizard

Step 1


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:

Episode without "restriction"-key:

1 Reply

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,


HuboSpotify Star
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.

Suggested posts