📺 Channels & Sports API Documentation

Welcome to the Lista Preta.site API. This API provides:

A list of valid TV channels with streaming links.
Live sports events schedule with channels mapped to our platform.

🌐 Base URL

https://listapreta.site/developer-api

📝 Channels Endpoints

1. GET /channels

https://listapreta.site/developer-api/channels

Sample Response

[{
  "id": 16,
  "name": "20 Minutes TV",
  "link": "https://listapreta.site/developer-api/player.php?id=16",
  "country": "FR",
  "image": "https://listapreta.site/developer-api/images/20minutes.png"
}]

🎬 Example Video

Below is a live preview of one of our channel links:

ℹ️ Player Features

Our embedded player comes with a Switch Channel button. This button is visible only when there is more than one available option (e.g., Option 2) for the currently selected channel. Click it to toggle between available streams of the same channel.

📱 Mobile Experience: On mobile devices, the player does not display ads, providing a clean viewing experience. On desktop, a maximum of 2 ads per channel is shown.

ℹ️ Note: Switch Channel button appears only when multiple options exist. Mobile devices have no ads.

2. GET /channels/country/{COUNTRY}

https://listapreta.site/developer-api/channels/country/PT

Sample Response

[{
  "id": 21,
  "name": "News Channel PT",
  "link": "https://listapreta.site/developer-api/player.php?id=21",
  "country": "PT",
  "image": "https://listapreta.site/developer-api/defimage.png"
}]

📂 Channels Response Structure

Field	Type	Description
id	integer	Unique channel ID
name	string	Channel name
link	string	Streaming link starting with `player.php`
country	string	Country code (PT, FR, etc.)
image	string	URL to the channel image. Defaults to `defimage.png` if not found.

📝 Sports Endpoints

1. GET /sports

https://listapreta.site/developer-api/sports

Sample Response

{
  "Soccer": [
    {
      "gameID": "a1b2c3d4e5f6",
      "homeTeam": "Csikszereda",
      "awayTeam": "Unirea Slobozia",
      "homeTeamIMG": "https://listapreta.site/developer-api/images/img.php?url=...",
      "awayTeamIMG": "https://listapreta.site/developer-api/images/img.php?url=...",
      "time": "15:30",
      "tournament": "Liga I",
      "country": "Romania",
      "countryIMG": "https://listapreta.site/developer-api/images/img.php?url=...",
      "status": "finished",
      "start": "2025-11-21 15:30",
      "end": "2025-11-21 18:09",
      "channels": [
        {
          "channel_name": "Arena Sport 2",
          "channel_code": "HR",
          "viewers": 0,
          "url": "https://listapreta.site/developer-api/player.php?id=372",
          "image": "https://listapreta.site/developer-api/images/img.php?url=..."
        }
      ]
    }
  ]
}

📂 Sports Response Structure

Field	Type	Description
gameID	string	Unique ID generated by our API.
homeTeam / awayTeam	string	Names of the competing teams.
homeTeamIMG / awayTeamIMG / countryIMG	string	All images via `/images/img.php`.
time	string	Match start time (HH:MM).
tournament	string	Name of the tournament or league.
country	string	Country of the event.
status	string	Event status (e.g., finished, live).
start / end	string	Full start/end datetime.
channels	array	Mapped channels available for this event.
channel_name / channel_code	string	Channel name and country code.
url	string	Player link on our platform.
image	string	Channel image.

💻 Usage Example (JavaScript)

fetch('https://listapreta.site/developer-api/sports')
  .then(res => res.json())
  .then(events => {
      events.Soccer.forEach(event => {
          console.log(event.homeTeam, event.awayTeam, event.channels);
      });
  });