contentLink+JSON.md

Content Link (with JSON)

<podcast:contentLink>

The contentLink tag allows podcasters to provide links to external platforms where their content can be consumed. As a child of the channel tag, this allows podcasters to verify their presence on various platforms via their feed. As a child of the item tag, this allows podcasters to link to that episode on alternate platforms. As a child of the liveItem tag, this allows podcasters to provide fallback destinations when an app doesn't fully support live streaming content.

Podcasts apps would have little incentive to link out to competing apps, but this would be very useful to universal link services attempting to locate podcasts on platforms without any lookup method.

Parent

<channel> or <item> or <podcast:liveItem>

Count

Multiple

Node Value

The node value is a free form string meant to explain to the user where this content link points.

Attributes

The url and href attributes are mutually-exclusive.

• href: (optional) A URL pointing to a single external platform representing the same content as its parent tag (channel/item/liveItem).
• url: (optional) A URL pointing to a JSON file listing multiple external platforms representing the same content as its parent tag (channel/item/liveItem).

Examples

Channel-level contentLink

<podcast:contentLink href="https://podcasts.apple.com/podcast/id1584274529">Listen on Apple Podcasts</podcast:contentLink>
<podcast:contentLink href="https://truefans.fm/podcasting-20">Listen on TrueFans</podcast:contentLink>

Item-level contentLink

<podcast:contentLink href="https://patreon.com/posts/public-episode-83079838">Listen on Patreon</podcast:contentLink>
<podcast:contentLink href="https://music.youtube.com/watch?v=RWPmCpKVPS8&list=PLKLAQeES5doHtEgyGyAInyDDlG-MljkMX">Listen on YouTube Music</podcast:contentLink>

liveItem contentLink

<podcast:contentLink href="https://youtube.com/pc20/livestream">Watch live on YouTube</podcast:contentLink>
<podcast:contentLink href="https://twitch.com/pc20/livestream">Watch live on Twitch</podcast:contentLink>

contentLink url attribute

<podcast:contentLink url="https://examplehost.com/feed/12345678/contentlinks.json">Listen wherever you get your podcasts</podcast:contentLink>

---

JSON Links Format

Instead of including the URLs in the feed directly, alternatively they can be provided in a linked JSON file. This alleviates concerns of feed bloat and doesn’t require updating the feed just to update the linked JSON file.

JSON Object Properties

• version: (required) A string of the version number.
• links: (required) An array of link objects defined below.

"Link" Object Properties

• href: (required) A URL pointing to a single external platform representing the same content as the parent tag (channel/item/liveItem) where this JSON file was linked from.
• text: (optional) A free form string meant to explain to the user where this content link points.

Basic Example

{
	"version": "1.0.0",
	"links": [
		{
			"href": "https://podcasts.apple.com/us/podcast/feed/id1325018583?ls=1&at=11lo6V&ct=i8xe9",
			"text": "Listen on Apple Podcasts!"
		},
		{
			"href": "https://open.spotify.com/show/5s9hHFr8VJARyg0QkghSF1",
			"text": "Listen on Spotify!"
		},
		{
			"href": "https://music.youtube.com/playlist?list=PLusOJN4fPK_u0dMxl_xRCTNT1GKaM6vtU",
			"text": "Listen on YouTube Music!"
		},
		{
			"href": "https://music.amazon.com/podcasts/bfe17258-0f9d-43db-8a31-c7f921fd7c5f/podnews-daily---podcasting-news",
			"text": "Listen on Amazon Music!"
		}
	]
}