Skip to content

Guide API Suggest

nickkelsey edited this page Sep 28, 2025 · 2 revisions

Introduction:

The suggest API returns series-level information for a given Category of show suitable for the Discover Shows/Movies/Sports UI view.

API URL:

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

API Parameters:

Parameter Type Description
DeviceAuth string Concatenation of the DeviceAuth strings from all HDHomeRun tuners
Category string One of series, movie, sport, news

Result format:

[
    {
        "SeriesID": "MV003775480000",
        "Title": "Skyfall",
        "ImageURL": "https://img.hdhomerun.com/titles/MV003775480000.jpg",
        "PosterURL": "https://img.hdhomerun.com/posters/MV003775480000.jpg",
        "RecordingRule": 1
    },
    {
        "SeriesID": "MV001171630000",
        "Title": "Minority Report",
        "ImageURL": "https://img.hdhomerun.com/titles/MV001171630000.jpg",
        "PosterURL": "https://img.hdhomerun.com/posters/MV001171630000.jpg",
        "RecordingRule": 1
    },
    {
        ...
    }
]

Additional Details:

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

History:

20250928:

  • Initial documentation.

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

Clone this wiki locally