Table of Contents
Entry Type EPG Overview
Entry Type is the most robust EPG type from Wurl, including Channel-level metadata (thumbnails, title, ratings etc) as well as Program and Schedule data. EPG metadata is accessed via JSON API endpoint, one url per channel.
- Authentication:
- No authentication is required for Entry Type EPG; JSON EPG endpoints for each channel are provided as part of Wurl channel hand-off.
- Time Zone Offsets:
- Entry Type EPG can be offset by Wurl, so that stream and EPG will always match for any channel, and Streamers do not need to offset the EPG.
- Daily Update Time:
- Entry Type EPG can be updated once daily at a daily time of the Streamer’s choosing.
- Days of Data:
- The Entry Type API endpoint provides 7 days of data forward from yesterday.
- JSON Output Structure:
- Entry Type EPG delivers Channel, Program and Schedule metadata.
- Program metadata is listed first, organized by entry types ShortForm, Series, TV Special and Movie. A unique identifier is provided per program.
- Schedule data is provided after the program metadata. The unique identifier is provided to allow for metadata mapping between program and schedule.
- Entry Type EPG delivers Channel, Program and Schedule metadata.
- Backup Metadata:
- For certain program fields such as program thumbnails, the EPG sends backup metadata derived from the channel if a Content Company doesn’t provide metadata at the program level.
Sample Entry Type EPGs
- Without DRM: https://epg-prod.wurlintegrationsrdf.wurl.com/wurlintegrationsrdf_wurl_integrationchannel_1_us_cf.json
- With DRM: https://epg-prod.wurlintegrationsrdf.wurl.com/wurlintegrationsrdf_iops_channel_2_1_us_dash_wfo.json
Entry Type EPG Metadata Fields
|
Field Type |
Field |
Description |
Example |
|
Channel
|
title |
Channel Title |
Integration Channel 1 |
|
lastUpdated |
The date that the feed was last modified in the ISO 8601 format: {YYYY}-{MM}-{DD}T{hh}:{mm}:{ss}+{TZ}. |
2021-07-23T12:47:16+0000 |
|
|
dateAdded |
Date of Channel creation within the Wurl platform |
2019-08-01 |
|
|
url |
Channel Stream Playback URL |
https://wurl-integrationchannel-1-us.wurlintegrationsrdf.wurl.tv/playlist.m3u8 |
|
|
thumbnail |
Channel primary thumbnail |
https://dki01q1l7yn3y....s/0-2048/Integration-Channel-1-default_v1.jpg |
|
|
brandedThumbnail |
Channel secondary thumbnail, if provided. If no secondary image is provided, the primary will be sent here as well. |
https://dki01q1l7yn3y...2048/Integration-Channel-1-default_v1.jpg |
|
|
shortDescription |
Channel Short Description, max 200 chars |
A new short channel description |
|
|
longDescription |
Channel Long Description, max 500 chars |
A new long channel description |
|
|
rating |
Channel Parental Rating value |
TVY |
|
|
ratingSource |
Channel Parental Rating Type |
USA_PR |
|
|
|
enableDRM |
Whether Wurl DRM has been enabled on the channel |
true or false |
|
|
drm: -drmType -licenseUrl -customAuthHeaderName -customAuthHeaderValue |
DRM Encryption information for the channel. This sections is only posted if enableDRM=true. |
drmTypes: Fairplay, Widevine or Playready "drm": [ } |
|
Program
|
Program types |
Type of Program |
Movies, series, shortFormVideos, tvSpecials |
|
id |
Unique ID used to map a Program to the Schedule |
US-11401746-14224-1417359 |
|
|
title |
Program Title |
Inside the Nasa World |
|
|
thumbnail |
16:9 artwork for programs, minimum 800x450. If not set at the program level, the Channel thumbnail will be sent. |
https://dki01q1l7yn3y...:episodes/5567-7615/Ask-Nasa-4-default_v5.jpeg |
|
|
shortDescription |
Description of episode, max 200 characters |
Fourth Lorem ipsum dolor sit amet! |
|
|
longDescription |
Description of episode, max 500 characters |
Fourth Descriptionum Lorem ipsum dolor sit amet, consectetur adipiscing elit. |
|
|
releaseDate |
The original air date of the episode. If not set by the Content Company, the program creation date will be sent. |
2021-04-30T14:58:15.432Z |
|
|
tags |
Program keywords. One or more tags (e.g., “dramas”, “korean”, etc.) may be set. |
science |
|
|
genres |
The genre of the program, if available. |
news |
|
|
rating |
Program Parental Rating Type. If none is set, the Channel Rating will be sent. |
TVPG |
|
|
ratingSource |
Program Rating Type. If none is set, the Channel Rating will be sent. |
USA_PR |
|
|
series id |
Wurl Series ID (for Series Entry Types only) |
US-2620 |
|
|
series title |
Series title (for Series Entry Types only) |
NASA's 50th Anniversary |
|
|
seasonNumber |
Season Number (for Series Entry Types only) |
1 |
|
|
episodeNumber |
Episode Number (for Series Entry Types only) |
2 |
|
|
series genre |
Series genre (for Series Entry Types only) |
news |
|
|
series thumbnail |
16:9 artwork for Series, minimum 800x450. If not set at the series level, the Channel thumbnail will be sent. |
https://dki01q1l7yn3y.../0-2048/Integration-Channel-1-default_v1.jpg |
|
|
series releaseDate |
Series Release Date (for Series Entry Types only) |
2020-09-18T19:08:36.466Z |
|
|
series shortDescription |
Description of episode, 200 characters max (for Series Entry Types only) |
Neil Armstrong guides us through the history of the NASA. |
|
|
series rating |
Series Parental Rating (for Series Entry Types only). If none is set on the Series by the Channel Partner, the Channel Rating will be sent. |
TVPG |
|
|
series ratingSource |
Series Parental Rating Type (for Series Entry Types only). If none is set on the Series by the Channel Partner, the Channel Rating will be sent. |
USA_PR |
|
|
externalIds id |
One or more external IDs. |
SH984729384723 |
|
|
externalIds idType |
External ID Type, such as TMS or any custom ID type defined by the Channel Partner. |
TMS |
|
| Schedule |
id |
Unique ID used to map a Program to the Schedule |
US-11246766-1425224-1417359 |
|
durationInSeconds |
Schedule episode duration in seconds |
1800 |
|
|
date |
Schedule date |
2021-07-22 |
|
|
times |
Schedule time |
23:30:00 |
|
|
attributes |
Whether the Content Company has provided Closed Captions for this program to Wurl |
CC |
