Guide API Search

Introduction:

The search API returns series-level information for shows matching the given search words suitable for the Discover Search UI view. Title, Episode Tile, Series Synopsis, and Episode Synopsis fields are searched.

If the first search word is a number that number is treated as a channel number and the search is restricted to that channel.

Search words less than 3 characters long are ignored.

A maximum of 100 results are returned.

API URL:

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

API Parameters:

Parameter	Type	Description
DeviceAuth	string	Concatenation of the DeviceAuth strings from all HDHomeRun tuners
Search	string	Search words

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>.