API: EPG

EPG API

There is an EPG api available for the main website that we can integrate with the VTM GO API.

• https://vtm.be/tv-gids/api/v2/broadcasts/{date}

  • {date} is a date in the format YEAR-MONTH-DAY, for example 2019-12-31

• https://vtm.be/tv-gids/api/v2/channel/{channel}

  • Channel is one of the following: vtm, q2, vitaya, caz, vtm-kids, vtm-kids-jr or qmusic

The structure of a listing is as follows:

{
  "from":1582862400000,
  "to":1582948800000,
  "timestamp":1582413787163,
  "channels":[
  {
    "name":"VTM",
    "seoKey":"vtm",
    "uuid":"d8659669-b964-414c-aa9c-e31d8d15696b",
    "channelLogoUrl":"https://images0.persgroep.net/rcs/Zf3yTn3Of_CPnC-ZUMnu1YYk7Pg/diocontent/148415384/_fitwidth/500?appId=da11c75db9b73ea0f41f0cd0da631c71",
    "broadcasts":[...],
    "liveStreamLinks":[
    {
      "url":"https://vtm.be/vtmgo/live-kijken/vtm?app-context=vtmgo://playvideo/live?id%3Dvtm",
      "title":"Kijk op VTM GO",
      "iconImageUrl":"https://images3.persgroep.net/rcs/NfNaogTFRuNGrlz994CNSrvm5oA/diocontent/157152201/_fitheight/150?appId=da11c75db9b73ea0f41f0cd0da631c71"
    }
    ],
    "order":1
  },
  ...
]
}

There is also an API to get details, but it seems all these details are already in the overview from the APIs above.

• https://vtm.be/tv-gids/api/v2/detail/{type}/{uuid}
  • {type} can be oneoff, episode or movie
  • {uuid} is the UUID that is used in a overview from above

The structure of a broadcast is as follows:

{
  "uuid":"6884ac0e-4bed-48a5-9a98-1dbea06fd3da",
  "playableUuid":"1db7cc07-2b17-40a4-9c01-f8b26dcb5661",
  "programUuid":"043dd3d6-218e-4d3b-9582-36880e0d36fb",
  "channelUuid":"d8659669-b964-414c-aa9c-e31d8d15696b",
  "from":1582918800000,
  "to":1582925400000,
  "title":"The Voice Kids",
  "live":false,
  "rerun":false,
  "legalIcons":[
    "PGAL"
  ],
  "duration":6600,
  "synopsis":"Vierde Blind Auditions waarin de jonge kandidaten het beste van zichzelf geven in de hoop een plaatsje te krijgen in het team van coaches Laura Tesoro, Sean Dhondt, Gers Pardoel of K3.",
  "imageUrl":"https://images4.persgroep.net/rcs/44vfPqwE05uFmxEApFvyC_m1Psk/diocontent/166258585/_fill/600/400?appId=da11c75db9b73ea0f41f0cd0da631c71",
  "imageFormat":"LANDSCAPE",
  "playableType":"episodes",
  "genre":"Muziek",
  "subGenres":[
  ],
  "tip":false,
  "rating":null,
  "videoOnDemandLinks":[
  ],
  "fromIso":"2020-02-28T19:40:00",
  "toIso":"2020-02-28T21:30:00"
}

• playableUuid and playableType can be used to directly play the item from the VTM GO Catalog.
• programUuid can be used to go to the program listing.
• channelUuid can be used to play the live channel.