Response structure

The endpoint returns server status and health check.

• success (boolean): Indicates if the request was successful.
• timestamp (integer): Current server time.

Base URL

The base URL to access the API. Returns categories with their streams and metadata.

Response structure

• success (boolean): Indicates if the request was successful.
• timestamp (integer): Unix timestamp for when the response was generated.
• READ_ME (string): Informational note for API users.
• performance (float): Performance metric for the request.
• streams (array): Array of stream-category objects.

Stream category object

• category (string): Category name (e.g. "Basketball", "Football").
• id (integer): Unique category identifier.
• streams (array): List of stream objects for this category.

Stream object

• id (string): Unique stream identifier.
• name (string): Stream or event title.
• poster (string): Poster image URL.
• starts_at (integer): Stream start time (Unix timestamp).
• ends_at (integer): Stream end time (Unix timestamp).
• category_name (string): Parent category name.
• status (string): "live" or "upcoming".
• league (string): League/tournament name.
• teams (object): Home and away team data with names and badges.
• viewers (integer): Current viewer count.
• always_live (integer): 1 for 24/7 channels, otherwise 0.
• sources (array): Stream sources. Each has name (e.g. "TNT Sports 3 UK") and embed URL, plus source, id, sd and hd.
• embed (string): Main embed URL. Put it in an <iframe> on your site.

Example response

{
  "success": true,
  "timestamp": 1793438310,
  "READ_ME": "Free public API by DAMITV. Use embed URLs to show streams on your site.",
  "performance": 0.12,
  "streams": [
    {
      "category": "football",
      "id": 1,
      "streams": [
        {
          "id": "mm-au-aus1-401892147",
          "name": "Macarthur FC vs Western Sydney Wanderers FC",
          "poster": "https://ondemand.st/img/cards/aus.1/401892147.jpg",
          "starts_at": 1793436000,
          "ends_at": 1793446800,
          "category_name": "football",
          "status": "live",
          "league": "A-League Men",
          "teams": {
            "home": {"name": "Macarthur FC", "badge": "https://a.espncdn.com/i/teamlogos/soccer/500/19340.png"},
            "away": {"name": "Western Sydney Wanderers FC", "badge": "https://a.espncdn.com/i/teamlogos/soccer/500/13696.png"}
          },
          "viewers": 1250,
          "always_live": 0,
          "sources": [
            {"source": "manual", "id": "dm1", "name": "TNT Sports 3 UK", "sd": 0, "hd": 1, "embed": "https://damitv.st/player/hls/?v=542&url=%2Fc%2F33.m3u8&name=TNT%20Sports%203%20UK"},
            {"source": "manual", "id": "dm2", "name": "Sky Sport 3 NZ", "sd": 0, "hd": 1, "embed": "https://damitv.st/player/hls/?v=542&url=%2Fc%2F590.m3u8&name=Sky%20Sport%203%20NZ"}
          ],
          "embed": "https://damitv.st/embed/?id=mm-au-aus1-401892147"
        }
      ]
    }
  ]
}

Embed Usage

Use the iframe field from the API response to embed streams:

<iframe src="https://damitv.st/embed/?id=MATCH_ID"
  width="100%" height="500" frameborder="0"
  allowfullscreen></iframe>

Notes

• starts_at, ends_at, and timestamp are Unix timestamps (seconds).
• Poll this endpoint approximately every 1-2 minutes for updates.
• Use the poster URL to render event imagery in your UI.
• Use iframe URL to embed streams directly.
• No rate limits. Please implement caching (60s recommended).
• Abuse will result in IP block.

Questions? Contact us on Discord