API : IPTV : App : Programs : List

Introduction

This request is used by the iOS/Android apps and web clients to filter programs

Request

URL	https://api.telecomx.dk/iptv/app/program
Method	GET
Query	token	String	Device token
	profile	Id	ID of DRM profile
	filter	String	Text-based filtering, min. 3 characters
	mode	String (enum)	The search mode/context, allowed values are TV and STREAMING. TV searches in the TV guide, and STREAMING searches in archive/streaming services for the given profile.
	genre	String	`[optional]` Comma-separated list of genres to search for.
	streamingService	String	`[optional]` Comma-separated list of services to search for. Only used in STREAMING mode
	channel	String	`[optional]` Comma-separated list of channels to search for (using base channel ID). Only used in TV mode

NOTE: Filter and mode are both mandatory, else an empty list will be returned.

Query examples

https://api.telecomx.dk/iptv/app/program?profile=1234567890ABCD1234567890&token=123456789asd23&mode=TV&filter=Danmark
https://api.telecomx.dk/iptv/app/program?profile=1234567890ABCD1234567890&token=123456789asd23&mode=TV&filter=Danmark&genres=Sport,Håndbold
https://api.telecomx.dk/iptv/app/program?profile=1234567890ABCD1234567890&token=123456789asd23&mode=TV&filter=Danmark&genres=Sport,Håndbold&channel=1,4
https://api.telecomx.dk/iptv/app/program?profile=1234567890ABCD1234567890&token=123456789asd23&mode=STREAMING&filter=Ozark&genres=Drama
https://api.telecomx.dk/iptv/app/program?profile=1234567890ABCD1234567890&token=123456789asd23&mode=STREAMING&filter=Ozark&genres=Drama&streamingService=NETFLIX,VIAPLAY,ARCHIVE

Response

The response consists is a list of these keys being the ID of a streaming service (or ARCHIVE for content from PlayMaker's archive), and the value being a list of programs.

JSON response
total	Number	Total number of matches
limit	Number	Limit of programs fetched per request
programs	Array	List of programs (definition below)

Program object - Field	Type	Description
_id	ObjectId	Unique program ID
kind	String	Allowed values are SHOW, EPISODE, MOVIE, SPORT, EVENT, ADULT
duration	Number	Length of the program in whole 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 for the program.
genres	Array	List of genres.
date	Date	Date program/movie/series was released/first shown, if available.
year	Number	Year program/move/series was released/first shown, if available.
country	string	Country where program was produced, e.g. 'Amerikansk'. 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, PRESENTER, MUSIC, CONDUCTOR, WRITER e.t.c.
credits[].role	String	Name of the role played, if type is ACTOR.
credits[].name	String	Name of person.
credits[].image	ObjectId	ID of image of the credited person.
imagesIds	Array	List of image IDs from image server
streams	Array	Properties used, if the program is available on streaming services
streams[].streamingService	String (enum)	Which streaming service this url is from. Allowed values are the streaming services listed in IpTvStreamingServices
streams[].url	String	URL/deeplink to content
streams[].name	String	Display name of streaming service
streams[].logo	String	URL of the streaming service logo
streams[].logoId	ObjectId (String)	ID of streaming service logo
ratings	Object	Contains ratings of programs, properties will be the rating database, and the value is a float, eg. “imdb”: 7.4.
epgList	Array	List of EPG calendar objects, showing which channels and at time this program is currently played on

EPG Object - Field	Type	Description
_id	String	Id of program.
channelId	Number	Id of the TV channel carrying this show, from IpTvBaseChannels.
start	Date	Start time.
end	Date	End time.
realStart	Date	Real start time, if available.
realEnd	Date	Real end time, if available.
rerun	Boolean	Is this a re-run of the program, if available.
live	Boolean	Is this program live, if available.
premiere	Boolean	Is this the premiere of the program, if available.
channelName	String	Name of the channel
channelLogo	String	URL of the channel logo

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

Example - normal

{
    total: 1300,
    limit: 100,
    programs: [
        {
            "_id": "1234567890ABCD1234567890",
            "duration": 105,
            "title": "Jagten 2",
            "subTitle": "Prisvindende dansk spillefilm fra 2013",
            "description": null,
            "genres": [
                "Krimi",
                "Drama"
            ],
            "date": null,
            "year": 1990,
            "country": null,
            "credits": [
                {
                    "name": "Kevin Whately",
                    "type": "ACTOR",
                    "role": "Lewis"
                },
                {
                    "name": "John Thaw",
                    "type": "ACTOR",
                    "role": "Morse"
                },
                {
                    "name": "Tom Wilkinson",
                    "type": "ACTOR",
                    "role": "Jake Normington"
                },
                {
                    "name": "John Madden",
                    "type": "DIRECTOR",
                    "role": null
                }
            ],
            "imageIds": [
                "1234567890ABCD1234567890"
            ],
            "ratings": {
                "imdb": 8.2
            },
            "streams": [],
            "epgList": []	
           },
           { ... }    
    ],
    _id: 'NETFLIX',
    name: 'Netflix',
    logo: 'https://image.powernet.tv/1234567890ABCD1234567890.png',
    logoId: '1234567890ABCD1234567890',
    programs: [
        { ... }
    ],
    _id: 'HBO',
    name: 'HBO',
    logo: 'https://image.powernet.tv/1234567890ABCD1234567890.png',
    logoId: '1234567890ABCD1234567890',
    programs: [ { ... }, { ... } ]
}

Errors

Error code	Message	Description
403	access_denied	Insufficient access level
500	internal_error	<Unspecified>

WIKI

Table of Contents