Guide API Episodes

Introduction:

The episodes API returns series information and airing information of all upcoming episodes within the next 2 weeks (typical).

API URL:

GET https://api.hdhomerun.com/api/episodes

API Parameters:

Parameter	Type	Description
V=2		Request API Version 2 (latest)
DeviceAuth	string	Concatenation of the DeviceAuth strings from all HDHomeRun tuners
SeriesID	string	SeriesID identifying the series or movie

Result format:

{
    "Series": {
        "SeriesID": "C191261ENJPCF",
        "Title": "College Football",
        "Synopsis": "American college football action.",
        "Category": "sport",
        "ImageURL": "https://img.hdhomerun.com/titles/C191261ENJPCF.jpg",
        "BannerURL": "https://img.hdhomerun.com/banners/C191261ENJPCF.jpg",
        "EpisodeImageURLTemplate": "https://img.hdhomerun.com/episodes/{ProgramID}.jpg"
        "MovieScore": "3.5/4.0"
    },
    "RecordingRules": [
        {
            "RecordingRuleID": "12345",
            "DateTimeOnly": 1760205600,
            "ChannelOnly": "51.1",
            "StartPadding": 30,
            "EndPadding": 30
        }
    ],
    "Channels": {
        "15.1": {
            "ChannelName": "KNXVDT",
            "ChannelImageURL": "https://img.hdhomerun.com/channels/US21210.png"
        },
        "10.1": {
            "ChannelName": "KSAZDT",
            "ChannelImageURL": "https://img.hdhomerun.com/channels/US21209.png"
        }
    },
    "Teams": [
        "Georgia",
        "Kentucky",
        "Michigan"
        "Wisconsin",
    ],
    "Episodes": [
        {
            "ProgramID": "EP043373526826",
            "EpisodeTitle": "Kentucky at Georgia",
            "EpisodeImageURL": "https://img.hdhomerun.com/episodes/EP043373526826.jpg",
            "Team1": "Kentucky",
            "Team2": "Georgia",
            "OriginalAirdate": 1759536000,
            "First": 1,
            "Airings": [
                {
                    "StartTime": 1759593600,
                    "EndTime": 1759604400,
                    "Channels": [
                        "15.1",
                        "10.1",
                    ]
                },
                {
                    "StartTime": 1759620600,
                    "EndTime": 1759633200,
                    "Channels": [
                        "15.1",
                        "10.1",
                    ]
                }
            ]
        },
        {
            "ProgramID": "EP043373526829",
            "EpisodeTitle": "Wisconsin at Michigan",
            "EpisodeImageURL": "https://img.hdhomerun.com/episodes/EP043373526829.jpg",
            "Team1": "Wisconsin",
            "Team2": "Michigan",
            "OriginalAirdate": 1759536000,
            "First": 1,
            "Airings": [
                {
                    "StartTime": 1759593600,
                    "EndTime": 1759606200,
                    "Channels": [
                        "15.1",
                        "10.1"
                    ]
                }
            ]
        }
    ]
}

Additional Details:

ProgramID is not always unique to each episode - separate episodes may have the same ProgramID when First is set. This is most commonly seen with news programming and sporting events.

If the record engine does not report EpisodeImageURL for a recorded episode use EpisodeImageURLTemplate from the episodes API (if present) to compute the EpisodeImageURL. Replace {ProgramID} with the ProgramID of the recorded episode.

History:

20250928:

• Initial documentation.

Copyright © 2016-2025 Silicondust USA Inc. <www.silicondust.com>.