MEO EPG

MEO EPG

EPG for MEO IPTV channels.

Free subscription

Technical Overview

EPG Service

Returns EPG for different channels from MEO.

API Reference

Service Operation Description
EPG GetChannelByDateInterval Accepts a channel sigla and two date strings in format yyyy-mm-dd hh:mm:ss and returns a list of channel programs for the period between given dates
GetChannelDetail Accepts a channel sigla and returns all details about that channel.
GetChannelList Returns a list of providers channels offerts
GetChannelListByDateInterval Accepts a list of channels siglas separated by commas and two date strings in format yyyy-mm-dd hh:mm:ss and returns a list of the channels programs for the period between given dates.
GetChannelListOrderByName Returns a list of providers channels offerts ordered by channel name.
GetProgramById Accepts a program identifier (Id) and returns all details about that program.
GetProgramListByChannelDateInterval Accepts a channel sigla and two date strings in format yyyy-mm-dd hh:mm:ss and returns all details about the programs assigned to that period.

EPG Service

Operations

GetChannelByDateInterval

Accepts a channel sigla and two date strings in format yyyy-mm-dd hh:mm:ss and returns a list of channel programs for the period between given dates
Request Parameters
channelSigla : string (optional)
The channel identifier.
startDate : string (optional)
The start date and time for the programs listing.
endDate : string (optional)
The end date and time for the programs listing.
Response Parameters
GetChannelByDateIntervalResult : Channel (optional)

The Channel type is composed by the following elements:

Name : string (required)
Sigla : string (required)
Type : string (optional)
Providers : ArrayOfProvider (required)
Programs : ArrayOfProgram (required)
Examples

SOAP Sample

The following example shows how to retrieve EPG for a specific channel in a give date interval. And the corresponding, successful, response:

HTTP GET Sample

The following example shows how to retrieve EPG for a specific channel in a give date interval. And the corresponding, successful, response:
Go to top

GetChannelDetail

Accepts a channel sigla and returns all details about that channel.
Request Parameters
channelSigla : string (optional)
The channel identifier.
Response Parameters
GetChannelDetailResult : Channel (optional)

The Channel type is composed by the following elements:

Name : string (obrigatório)
Sigla : string (obrigatório)
Type : string (opcional)
Providers : ArrayOfProvider (obrigatório)
Programs : ArrayOfProgram (obrigatório)
Examples

SOAP Sample

The following example shows how to retrieve the details for a specific channel. And the corresponding, successful, response:

HTTP GET Sample

The following example shows how to retrieve the details for a specific channel. And the corresponding, successful, response:
Go to top

GetChannelList

Returns a list of providers channels offerts
Response Parameters
GetChannelListResult : ArrayOfChannel (optional)

A list of Channels.

The Channel type is composed by the following elements:

Name : string (required)
Sigla : string (required)
Type : string (optional)
Providers : ArrayOfProvider (required)
Programs : ArrayOfProgram (required)
Examples

SOAP Sample

The following example shows how to retrieve Meo channels list. And the corresponding, successful, response:

HTTP GET Sample

The following example shows how to retrieve Meo channels list. And the corresponding, successful, response:
Go to top

GetChannelListByDateInterval

Accepts a list of channels siglas separated by commas and two date strings in format yyyy-mm-dd hh:mm:ss and returns a list of the channels programs for the period between given dates.
Request Parameters
channelSiglas : string (optional)
A list of channels identifiers (siglas) separated by commas.
startDate : string (optional)
The start date and time for the programs listing.
endDate : string (optional)
The end date and time for the programs listing.
Response Parameters
GetChannelListByDateIntervalResult : ArrayOfChannel (optional)

A list of Channels.

The Channel type is composed by the following elements:

Name : string (required)
Sigla : string (required)
Type : string (optional)
Providers : ArrayOfProvider (required)
Programs : ArrayOfProgram (required)
Examples

SOAP Sample

The following example shows how to retrieve the EPG for a given list of channels identifiers and in a given date interval. And the corresponding, successful, response:

HTTP GET Sample

The following example shows how to retrieve the EPG for a given list of channels identifiers and in a given date interval. And the corresponding, successful, response:
Go to top

GetChannelListOrderByName

Returns a list of providers channels offerts ordered by channel name.
Response Parameters
GetChannelListOrderByNameResult : ArrayOfChannel (optional)

A list of Channels.

The Channel type is composed by the following elements:

Name : string (required)
Sigla : string (required)
Type : string (optional)
Providers : ArrayOfProvider (required)
Programs : ArrayOfProgram (required)
Examples

SOAP Sample

The following example shows how to retrieve Meo channels list order by name. And the corresponding, successful, response:

HTTP GET Sample

Returns a list of providers channels offerts ordered by channel name. And the corresponding, successful, response:
Go to top

GetProgramById

Accepts a program identifier (Id) and returns all details about that program.
Request Parameters
programId : int (optional)
The program identifier. You can get this value in any other operation that returns a channel with the corresponding programs.
Response Parameters
GetProgramByIdResult : Program (optional)
Examples

SOAP Sample

The following example shows how to retrieve details about a specific program. And the corresponding, successful, response:

HTTP GET Sample

The following example shows how to retrieve details about a specific program. And the corresponding, successful, response:
Go to top

GetProgramListByChannelDateInterval

Accepts a channel sigla and two date strings in format yyyy-mm-dd hh:mm:ss and returns all details about the programs assigned to that period.
Request Parameters
channelSigla : string (optional)
The channel identifier (sigla).
startDate : string (optional)
The start date and time for the programs listing.
endDate : string (optional)
The end date and time for the programs listing.
Response Parameters
GetProgramListByChannelDateIntervalResult : ArrayOfProgram (optional)

A list of Programs.

Go to top

EPG Entities

ArrayOfChannel

Attribute Name Description
List of Channel : Channel (optional)
Go to top

ArrayOfFlag

Attribute Name Description
List of Flag : Flag (optional)
Go to top

ArrayOfProgram

Attribute Name Description
List of Program : Program (optional)
Go to top

ArrayOfProvider

Attribute Name Description
List of Provider : Provider (optional)
Go to top

ArrayOfValue

Attribute Name Description
List of Value : Value (optional)
Go to top

Channel

Attribute Name Description
Name : string (optional)
Sigla : string (optional)
Type : string (optional)
Providers : ArrayOfProvider (optional)
Programs : ArrayOfProgram (optional)
Genre : string (optional)
Description : string (optional)
TunerPosition : int (optional)
IsHD : boolean (optional)
CanonicalName : string (optional)
PresentationId : string (optional)
ProductId : string (optional)
Image : string (optional)
Go to top

Flag

Attribute Name Description
Id : int (optional)
Name : string (optional)
PName : string (optional)
Description : string (optional)
Language : string (optional)
Go to top

Program

Attribute Name Description
Id : int (optional)
Title : string (optional)
Description : string (optional)
Category : string (optional)
Culture : string (optional)
Actor : string (optional)
Director : string (optional)
ExecutiveProducer : string (optional)
GuestStar : string (optional)
Producer : string (optional)
Writer : string (optional)
StartTime : string (optional)
Duration : int (optional)
ChannelName : string (optional)
ChannelSigla : string (optional)
EndTime : string (optional)
EpisodeTitle : string (optional)
ShortDescription : string (optional)
Flags : ArrayOfFlag (optional)
Values : ArrayOfValue (optional)
Go to top

Provider

Attribute Name Description
Name : string (optional)
Go to top

Value

Attribute Name Description
Id : int (optional)
Name : string (optional)
PName : string (optional)
Description : string (optional)
Language : string (optional)
ValueOf : string (optional) The value of the ProgramValue.
Go to top

SOAP API Authentication

Authenticating SOAP Request

Every request must contain authentication information to establish the identity of whom making the request and a autorization token called ESB Access Key.

ESB Access Key

Correct with the path to the access key

The ESB Access Key is what will authorize the usage of the API and is available when the buying process ends. In the costumer area you can find the product details where you can generate an ESB Access Key for you usage, another user registered on SAPO Services or even for everyone.

The element ESBAccessKey must appear on the message SOAP Header after the complex type ESBCredentials

Example:

ESBCredentials

ESBCredentials is a complex type that is used to pass the credentials in order to authenticate a SOAP request.

Request with username and password
Elements Description
ESBUsername The e-mail of the account that is used to access the API
ESBPassword The password that in combination with the ESBUsername is used to access the corresponding account

Example:

Request with ESBToken

Using a token instead of your username and password can be useful if you don't want to give your credentials to whom is using the API.

In order to generate a ESB Token you must use SAPO Security Token Service (STS). The ESBtoken is valid for 12 hours.

Requesting with an ESBtoken
Go to top