Guide API Up Next

Introduction:

The up_next API returns series-level airing information grouped into 30-minute timeslots suitable for the Discover Now UI view. Data is available looking forward up to 2 weeks (typical) and looking back up to 2 weeks (typical).

API URL:

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

API Parameters:

Parameter	Type	Description
V=2		Request API Version 2 (latest)
DeviceAuth	string	Concatenation of the DeviceAuth strings from all HDHomeRun tuners
Start	int64	Optional. Unix timestamp of the first timeslot to return. Default = current time
Count	uint	Optional. Number of 30 minute timeslots to return. Defualt = 8, Max = 48

Result format:

{
    "1759086000": [
        {
            "SeriesID": "C8204516EN701D",
            "Title": "Sherlock on Masterpiece",
            "ImageURL": "https://img.hdhomerun.com/titles/C8204516EN701D.jpg",
            "RecordingRule": 1,
            "Airings": [
                {
                    "StartTime": 1759084200,
                    "EndTime": 1759089600,
                    "RecordingRule": 1
                }
            ]
        },
        {
            "SeriesID": "C191277EN186U",
            "Title": "NFL Football",
            "ImageURL": "https://img.hdhomerun.com/titles/C191277EN186U.jpg",
            "Airings": [
                {
                    "StartTime": 1759078800,
                    "EndTime": 1759089600
                },
                {
                    "StartTime": 1759078800,
                    "EndTime": 1759091100
                }
            ]
        },
    ],
    "1759095000": [
        ...
    ]
}

Additional Details:

Shows are returned in display order within each timeslot and should not be sorted by the UI.

If a show crosses multiple 30-minute timeslots it is included in each 30-minute timeslot.

If a shows starts within 3 minutes (180 seconds) of the end of a timeslot it will not be included in that timeslot.

For past and current timeslots the UI typically displays all shows. The Airing information from the up_next API is ignored.

For future timeslots the UI typically filters the display to only shows that start within the timeslot as determined by the Airing information. Specifically shows where StartTime >= (Timeslot – 180s) are displayed.

History:

20250928:

• Initial documentation.

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