This document describes the custom RSS elements (tags) for the Wurl namespace.
Namespace declaration
<rss version="2.0" xmlns:wurl="http://api.wurl.com/wurlrss/1.0">
channel tags
Series Info
If the feed contains a series, this tag may be used to include additional series information. If this tag is added on the channel level, only the <wurl:episode> tag has to be added on the item level.
| Element | Description | Data type | Example |
|---|---|---|---|
<wurl:series> |
wurl:series start element. | ||
<wurl:officialTitle> |
Required. Official series title. | String | Game of Thrones |
<wurl:startYear> |
Required. The year the series started. | Integer | 2011 |
<wurl:studio> |
Optional. The studio name. | String | HBO |
<wurl:season> |
wurl:season start element. Required if the series has seasons. | ||
<wurl:seasonNumber> |
Required. The series season number. | Integer | 1 |
<wurl:seasonTitle> |
Optional. The season title. | String | Join the Game |
</wurl:season> |
wurl:season end element. | ||
</wurl:series> |
wurl:series end element. |
item tags
Episode Info
If the item is an episode belonging to a series, this tag may be used to include additional episode information.
| Element | Description | Data type | Example |
|---|---|---|---|
<wurl:episode> |
wurl:episode start element. | ||
<wurl:officialTitle> |
Required. Official episode title. | String | Winter Is Coming |
<wurl:seasonNumber> |
Required The series season number, if it has one. | String | 1 |
<wurl:episodeNumber> |
Required. The episode number. | Integer | 3 |
<wurl:firstAired> |
Optional. When the episode was first aired. RFC-822 date-time. | Date | Thu, 10 Sep 2015 12:00:00 GMT |
</wurl:episode> |
wurl:episode end element. |
Movie Info
If the item is a VOD movie, this tag may be used to include additional movie related information.
| Element | Description | Data type | Example |
|---|---|---|---|
<wurl:movie> |
wurl:movie start element. | ||
<wurl:officialTitle> |
Required. Official movie title. | String | Star Wars: The Force Awakens |
<wurl:year> |
Required. The year the movie was released. | Integer | 2015 |
<wurl:firstAired> |
Optional. When the movie first premiered. RFC-822 date-time. | Date | Thu, 10 Sep 2015 12:00:00 GMT |
</wurl:movie> |
wurl:movie end element. |
Cue Points
This item-level tag signals where mid-roll ads may be inserted into your video.
| Element | Attribute | Description | Data type | Example |
|---|---|---|---|---|
<wurl:cuepoints> |
n/a |
Comma-separated cue points in seconds/milliseconds. (hh:mm:ss.MMM) Cue points will need to be in sequential order. |
String | 00:00:10.123,00:00:20.456,00:00:30.789 |
Closed Captions
This item-level tag is intended for including closed captions.
| Element | Attribute | Description | Data type | Example |
|---|---|---|---|---|
<wurl:closedCaptions> |
type | SCC, SRT | String | SCC |
<wurl:closedCaptions> |
lang | Language given in RFC 3066. | String | en-us |
<wurl:closedCaptions> |
href | URL to a closed captions file. | String | http://wurl.com/en-us.scc |