GET short-epg

Parameters: id (the channel id, required), limit (default 10, 1-200). From the program airing now onwards.

{
  "channel_id": 123,
  "programs": [
    { "start": 978307200, "end": 4102444800, "title": "News at 6",
      "description": "The day in an hour.", "lang": "en", "now_playing": true,
      "category": "News", "icon": null, "season": null, "episode": null,
      "year": null, "rating": null }
  ]
}
  • start/end: unix seconds (UTC). now_playing: on air now; there may be none if the guide has a gap.
  • category, icon, season, episode, year and rating (a parental rating such as TV-G, as text) are null when the guide does not have them.
  • A channel without guide data returns an empty list; a channel outside the line's package, 403 not_in_package.

GET epg

Parameters: id (required), from and to (unix; default from now to 24 h later; to - from at most 7 days). Programs overlapping that range, including past ones, up to 500. Same body as short-epg.

GET epg-now

Parameter: ids (comma-separated channel ids, up to 100). The program on air and the next one for each channel, in one request: what a guide grid needs.

{ "channels": { "123": [ { "start": 978307200, "end": 4102444800, "title": "News at 6", "now_playing": true, "…": "…" },
                         { "start": 4102444800, "end": 4102446600, "title": "Weather", "now_playing": false, "…": "…" } ] } }

Keys are channel ids as strings. Channels without guide data, or outside the line's package, are left out. The next program is included only if it starts within 12 hours; for a longer gap use epg.