browse

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.
  • 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 EPG

https://epg-prod.wurlintegrationsrdf.wurl.com/wurlintegrationsrdf_wurl_integrationchannel_1_us_cf.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

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

 

 

Previous
Next

Was this article helpful?

1 out of 1 found this helpful