API : IPTV : App : Epg

Introduction

This request is used by the iOS/Android apps and web clients to get full EPG for a single program.

Request

URL	https://api.telecomx.dk/iptv/app/epg/EPG_ID
Method	GET
Param	EPG_ID	String	Id of program to return
Query	token	String	Session token.
	noimages	Boolean	`[optional]` True to not include images (default false).
	profile	String	`[optional]` Id of profile to show EPG for. Used to determine if this profile has recorded EPG, position, etc.

Query examples

https://api.telecomx.dk/iptv/app/epg/1_56475678?token=12345678901234567890ABCD

Response

EPG object (JSON)
_id	String	Id of EPG.
programId	ObjectId	Unique program ID (if known)
start	Date	Start time.
end	Date	End time.
duration	Number	Length in minutes.
title	String	Title of the program.
subTitle	String	Teaser/sub title - short description or episode title for a series episode.
description	String	Long description.
genres	Array	List of genres, in danish language.
series	Object	Episode data - only available for series.
series.episode	Number	Episode number in the season, if available.
series.episodesInSeason	Number	Number of episodes in the season, if available.
series.season	Number	Season number, if available.
date	Date	Date program/movie/series was released/first shown, if available.
availableUntil	Date	Date that this broadcasting expires from the archive.
country	String	Country of origin (ISO3166-2 country code). If multiple countries, comma separated string, if available.
credits	Array	List of credited persons for this program.
credits[].type	String	What the person is credited for: ACTOR, DIRECTOR, PRODUCER, DIRECTOR-PRODUCER e.t.c.
credits[].role	String	Name of the role played, if type is ACTOR.
credits[].name	String	Name of person.
imageIds	Array	List of id's of images for the program.
recording	Boolean	True if program has been recorded or marked for recording by the customer.
watchList	Boolean	If true, then this profile has this program in their watchlist. Only relevant for IPTV private, using profiles
position	Number	If previously played, then this is the position in seconds where playback stopped.
streams	Array	Properties used, if the program is available on streaming services
streams[].streamingService	String (enum)	Which streaming service this stream is from.
streams[].logo	String	URL to logo of the streaming service
streams[].logoId	ObjectId	ID of logo
streams[].name	String	Display name of streaming service
streams[].url	String	URL/deeplink to content

Note that properties holding no value may be omitted from the object.

Example

      {
        _id: '7_1484358000',
        programId: '1234567890ABCD1234567890'
        start: '2017-01-14T01:40:00.000Z',
        end: '2017-01-14T02:30:00.000Z',
        duration: 50,
        title: 'Cold Case',
        subTitle: 'Frank\'s Best',
        description: 'Krimiserie. Rush og Valens genåbner en sag fra 2001 om en vellidt lokal viktualieforretningsejer, Frank Dicenzio, som tilsyneladende blev banket ihjel af en ansat. Valens kontaktes af broderen til en dømt morder og overbevises om at genåbne sagen. Alle elskede Frank, og ingen kunne forestille sig, at nogen ville slå ham ihjel. Alle beviser peger mod Fransk bedste medarbejder - indtil en person endelig står frem og fortæller sandheden.',
        genres: [
          'Drama',
          'Krimi'
        ],
        series: {
          episode: 10,
          episodesInSeason: 23,
          id: '237655889',
          season: 3
        },
        credits: [
          { type: 'ACTOR', name: 'Kathryn Morris', role: 'Lilly Rush' },
          { type: 'ACTOR', name: 'Danny Pino', role: 'Scotty Valens' },
          { type: 'ACTOR', name: 'John Finn', role: 'John Stillman' },
          { type: 'ACTOR', name: 'Jeremy Ratchford', role: 'Nick Vera' },
          { type: 'ACTOR', name: 'Thom Barry', role: 'Will Jeffries' },
          { type: 'ACTOR', name: 'Tracie Thoms', role: 'Kat Miller' },
          { type: 'ACTOR', name: 'Bahni Turpin', role: 'Lindsey Dunlay' },
          { type: 'ACTOR', name: 'Ramon Franco', role: 'Ricardo Munoz' },
          { type: 'ACTOR', name: 'James DiStefano', role: 'Frank Dicenzio' },
          { type: 'ACTOR', name: 'Sandra Purpuro', role: 'Antonia Difara' },
          { type: 'ACTOR', name: 'Eduardo Yanez', role: 'Felix Darosa' },
          { type: 'DIRECTOR', name: 'Michael Schultz' }
        ],
        imageIds: [ '12345678901234567890BBBB' ],
        images: [],
        recording: false,
        watchList: true,
        position: 342,
        availableUntil: '2022-01-05T21:00:00.000Z'
        streams: [
          {
            streamingService: 'NETFLIX',
            name: 'Netflix',
            url: 'https://example.com/video/12937129739/',
            logo: 'https://image.powernet.tv/1234567890ABCD1234567890.png',
            logoId: '1234567890ABCD1234567890'
          }
        ]
      }

Errors

Error code	Message	Description
403	access_denied	Insufficient access level
404	not_found	Not found
500	internal_error	<Unspecified>

WIKI

Table of Contents

API : IPTV : App : Epg

Introduction

Request

Query examples

Response

Example

Errors