XMLTV Guide Data

Introduction:

XMLTV guide data is available for HDHomeRun customers to use with third party apps. 2 days for everyone, or 14 days if you have a HDHomeRun DVR guide subscription.

API URL:

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

API Parameters:

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

OR

Parameter	Type	Description
Email	string	Email address associated with the DVR account
DeviceIDs	string	Comma-separated list of DeviceIDs

Additional requirements:

• The HTTP client must accept gzip encoding.
• The DeviceAuth changes regularly and is valid for 16-24 hours. If using the DeviceAuth access approach the DeviceAuth must be read from the HDHomeRun tuner(s) to get the latest value each time this API is invoked.
• Do not schedule the download for midnight or a fixed time each day - requests should be made at a random interval. For example, after downloading the xmltv guide, schedule the next download for 20 to 28 hours (randomized delay) in the future.

Example:

curl --compressed "https://api.hdhomerun.com/api/xmltv?DeviceAuth=xxx" > guide.xml

curl --compressed "https://api.hdhomerun.com/api/xmltv?Email=xxx&DeviceIDs=xxx,xxx,xxx" > guide.xml

History:

20260520:

• API is now available without a HDHomeRun DVR guide subscription.

20251026:

• URL must be quoted in most shells.

20251025:

• New Email+DeviceIDs access approach.
• Clarifications.

20251023:

• Add note regarding scheduling the download.

20250928:

• Initial documentation.

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