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.
• sources (array): Stream sources. Each has name (e.g. "BBC One", "FOX 4K") and embed URL.
• iframe (string): Direct embed iframe URL.
• embed (string): Embed URL for the stream.

Example response

{
  "success": true,
  "timestamp": 1781600000,
  "READ_ME": "Free public API by DAMITV.",
  "performance": 0.12,
  "streams": [
    {
      "category": "football",
      "id": 1,
      "streams": [
        {
          "id": "wc/2026-06-16/fra-sen",
          "name": "France vs. Senegal",
          "poster": "https://api.ppv.to/assets/thumb/...",
          "starts_at": 1781625600,
          "ends_at": 1781652600,
          "category_name": "football",
          "status": "live",
          "league": "FIFA World Cup 2026",
          "teams": {
            "home": {"name": "France", "badge": ""},
            "away": {"name": "Senegal", "badge": ""}
          },
          "viewers": 1250,
          "sources": [
            {"source": "hls", "id": "s1", "name": "Server 1", "embed": "https://damitv.app/embed/?id=wc/2026-06-16/fra-sen"},
            {"source": "hls", "id": "s2", "name": "BBC One", "embed": "https://damitv.app/embed/?id=wc/2026-06-16/fra-sen/uk"},
            {"source": "hls", "id": "s3", "name": "Telemundo", "embed": "https://damitv.app/embed/?id=wc/2026-06-16/fra-sen/telemundo"},
            {"source": "hls", "id": "s4", "name": "FOX 4K", "embed": "https://damitv.app/embed/?id=wc/2026-06-16/fra-sen/fox-4k"}
          ],
          "iframe": "https://damitv.app/embed/?id=wc/2026-06-16/fra-sen",
          "embed": "https://damitv.app/embed/?id=wc/2026-06-16/fra-sen"
        }
      ]
    }
  ]
}

Embed Usage

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

<iframe src="https://damitv.app/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 Telegram