API Documentation

LUXHDR provides a simple API to query HDR content, assets, and delivery statistics across our global CDN network.

https://api.cdn.luxhdr.top/v1

📑 Endpoints

#1 — Browse Assets #2 — Get Asset Details #3 — Get Version Details #4 — Delivery Statistics #5 — Platform Status #6 — Error Responses

Browse all assets GET

The /assets endpoint returns a JSON object with all HDR assets available on the LUXHDR CDN. Use optional query parameters to search, filter, and limit results.

GET https://api.cdn.luxhdr.top/v1/assets

Query Parameters

ParameterTypeRequiredDescription
search string optional Search for assets by name, description, or keywords.
format string optional Filter by format: hdr10, hlg, h265.
platform string optional Filter by platform: social, vertical, shortform.
limit integer optional Limit the number of results returned (default: 20, max: 100).
fields comma-separated optional Specific fields to return: name,description,version,size,format.
Example Request
// Search for HDR10 content optimized for social platforms GET https://api.cdn.luxhdr.top/v1/assets?search=brand&format=hdr10&platform=social&limit=5
Example Response
{ "results": [ { "name": "brand_reel_4k", "description": "Luxury brand HDR reel for social platforms", "format": "hdr10", "version": "2.1.0", "size": 245, "url": "https://cdn.luxhdr.top/assets/brand_reel_4k.mov" }, { "name": "social_ad_1080p", "description": "HDR social ad optimized for mobile-first platforms", "format": "hdr10", "version": "1.4.2", "size": 89, "url": "https://cdn.luxhdr.top/assets/social_ad_1080p.mp4" } ], "total": 47, "available": 47 }

Get asset details GET

The /assets/:name endpoint returns detailed information about a specific asset, including all available versions, formats, and delivery metadata.

GET https://api.cdn.luxhdr.top/v1/assets/{name}

Response Properties

name string The full name of the asset as stored on LUXHDR.
description string A description of the asset content and intended use.
format string The HDR format: hdr10, hlg, or h265.
version string The latest version of the asset available on the CDN.
versions array<string> All versions of the asset available on the CDN.
platforms array<string> Platforms this asset is optimized for: social, vertical, shortform.
size integer File size in megabytes (MB).
url string The CDN URL for the default file of the latest version.
sri string SRI hash for the default file, if available.
Example Request
GET https://api.cdn.luxhdr.top/v1/assets/brand_reel_4k
Example Response
{ "name": "brand_reel_4k", "description": "Luxury brand HDR reel for social platforms", "format": "hdr10", "version": "2.1.0", "platforms": ["social", "vertical"], "size": 245, "url": "https://cdn.luxhdr.top/assets/brand_reel_4k.mov", "sri": "sha256-abc123def456...", "versions": [ "2.1.0", "2.0.1", "2.0.0", "1.3.2" ] }

Get version details GET

The /assets/:name/:version endpoint returns details for a specific version of an asset. This endpoint is immutable — versions never change once published.

GET https://api.cdn.luxhdr.top/v1/assets/{name}/{version}

Response Properties

name string The name of the asset.
version string The version of the asset requested.
files array<string> All files available for this version.
sri object SRI hashes for each file, where available.
Example Request
GET https://api.cdn.luxhdr.top/v1/assets/brand_reel_4k/2.1.0
Example Response
{ "name": "brand_reel_4k", "version": "2.1.0", "files": [ "brand_reel_4k.mov", "brand_reel_4k_h265.mp4", "brand_reel_4k_preview.mp4" ], "sri": { "brand_reel_4k.mov": "sha256-abc123...", "brand_reel_4k_h265.mp4": "sha256-def456..." } }

Delivery statistics GET

The /stats endpoint returns real-time delivery statistics for the LUXHDR CDN network.

GET https://api.cdn.luxhdr.top/v1/stats

Response Properties

assets integer Total number of assets available on the CDN.
pops integer Number of global Points of Presence (POPs).
bandwidth string Total network bandwidth capacity.
delivered_24h integer Assets delivered in the last 24 hours.
uptime string Current uptime percentage.
Example Request
GET https://api.cdn.luxhdr.top/v1/stats
Example Response
{ "assets": 1247, "pops": 150, "bandwidth": "2.5 Tbps", "delivered_24h": 38472, "uptime": "99.97%" }

Platform status GET

The /status endpoint returns the current operational status of all platforms on the LUXHDR network.

GET https://api.cdn.luxhdr.top/v1/status
Example Request
GET https://api.cdn.luxhdr.top/v1/status
Example Response
{ "platforms": [ { "name": "Global Social", "status": "operational", "uptime": "99.98%" }, { "name": "Short-Form Video", "status": "operational", "uptime": "99.95%" }, { "name": "Vertical Platforms", "status": "degraded", "uptime": "97.20%" }, { "name": "Social Networks", "status": "operational", "uptime": "99.92%" }, { "name": "Regional Networks", "status": "degraded", "uptime": "96.80%" } ] }

Error responses GET

All errors generated by the LUXHDR API return with a unified structure for easy detection and processing.

Response Properties

error boolean Always true to indicate an error occurred.
status integer HTTP status code for the error.
message string A message explaining what error occurred.
Example — Asset Not Found
{ "error": true, "status": 404, "message": "Asset not found" }
Example — Invalid Request
{ "error": true, "status": 400, "message": "Invalid 'format' parameter. Allowed: hdr10, hlg, h265" }
Example — Rate Limited
{ "error": true, "status": 429, "message": "Rate limit exceeded. Please wait 60 seconds." }

Quick reference

EndpointMethodDescription
/assets GET Browse all assets with search and filters
/assets/:name GET Get detailed information about a specific asset
/assets/:name/:version GET Get details for a specific version of an asset
/stats GET Get real-time CDN delivery statistics
/status GET Get platform operational status