Channels

Here you can find all endpoints that retrieves channels data.

Getting channel data

By making this request you will get your channel data in different formats, right now this request is mainly used to integrate your channel in Roku.

Returns the channel atributes.

get

/channel/{channel_id}

Path parameters

channel_idstringrequired

Represents the channel id, it is composed by 32 hexadecimal characters. Where can I find the channel ID? You can find your channel id on your dashboard, click over the channel name and the ID will be copied on your by editing your channel and getting it from the url.

Example: {"summary":"Channel identificator","value":"a68a72d5abdb040c7b279c707ed5477e"}

Query parameters

formatstring · enum · default: json

Return format for the response, the default value is json. If you want to use the response in Direct Publisher in Roku, you must use roku_json.

Example: {"summary":"Return format for the response, must be one of this: json, roku_json. Default value: json","value":"json"}

Options: json, roku_json

Responses

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://deliver.viloud.tv/channel/{channel_id}'

200

404

200

The body depends on the format param

It will return the channel in the format specified, for roku_json the response is compatible with Direct Publisher in Roku.

Returns the channel content

get

/channel/{channel_id}/schedule

Path parameters

channel_idstringrequired

Represents the channel id, it is composed by 32 hexadecimal characters. Where can I find the channel ID? You can find your channel id on your dashboard, click over the channel name and the ID will be copied on your by editing your channel and getting it from the url.

Example: {"summary":"Channel identificator","value":"a68a72d5abdb040c7b279c707ed5477e"}

Query parameters

daystring · enum

Returns the content of the channel for a given day, if the channel is not a weekly scheduler this param will be ignored. Values available: monday, tuesday, wednesday, thursday, friday, saturday and sunday. The default value is monday.

Example: monday

Options: monday, tuesday, wednesday, thursday, friday, saturday, sunday

Responses

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://deliver.viloud.tv/channel/{channel_id}/schedule'

200

404

200

The body depends on the format param

It will return the content of the channel for a given day, if the channel is not a weekly scheduler it will return the whole content instead.

Returns the channel EPG (Electronic Program Guide)

get

/channel/{channel_id}/epg

Path parameters

channel_idstringrequired

Represents the channel id, it is composed by 32 hexadecimal characters. Where can I find the channel ID? You can find your channel id on your dashboard, click over the channel name and the ID will be copied on your by editing your channel and getting it from the url.

Example: {"summary":"Channel identificator","value":"a68a72d5abdb040c7b279c707ed5477e"}

Query parameters

formatstring · enum · default: xmltvrequired

Return format for the response, it's required and must be xmltv.

Example: {"summary":"Return format for the response, it's required and must be xmltv.","value":"xmltv"}

Options: xmltv

days_backwardinteger

Set the backward days to get the content, the default value is 3.

Example: 3

days_forwardinteger

Set the forward days to get the content, the default value is 7.

Example: 7

Responses

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://deliver.viloud.tv/channel/{channel_id}/epg?format=xmltv'

200

404

200

text

It will return the content of the channel in XMLTV format.