drain.lat API

GET /categories

Get all Medal.tv game categories.

GET /api/v1/medal/categories

curl "https://drain.lat/api/v1/medal/categories" \
  -H "x-api-key: YOUR_API_KEY"

const res = await fetch("https://drain.lat/api/v1/medal/categories", {
  headers: { "x-api-key": "YOUR_API_KEY" }
});
const data = await res.json();

import requests

res = requests.get(
    "https://drain.lat/api/v1/medal/categories",
    headers={"x-api-key": "YOUR_API_KEY"}
)
print(res.json())

array

Show category object

number

Category ID. Use this in /clips?categoryId=.

string

Game name.

string

Category thumbnail URL.

number

Number of followers.

boolean

Whether the category is featured.

Response

{
  "categories": [
    { "id": 41, "name": "PUBG", "thumbnail": "https://medal.tv/images/categories/...", "followers": 84200, "isFeatured": true },
    { "id": 1, "name": "Fortnite", "thumbnail": "https://medal.tv/images/categories/...", "followers": 412000, "isFeatured": true }
  ],
  "scrapedAt": "2026-05-05T12:00:00.000Z"
}

GET /clips

Get top or random clips from Medal.tv.

GET /api/v1/medal/clips

number

Filter by game category ID. Get IDs from /categories.

number

Number of clips to return. Max 50. Default 10.

boolean

Return random clips instead of top clips. Default false.

curl "https://drain.lat/api/v1/medal/clips?categoryId=41&limit=5" \
  -H "x-api-key: YOUR_API_KEY"

const res = await fetch(
  "https://drain.lat/api/v1/medal/clips?categoryId=41&limit=5",
  { headers: { "x-api-key": "YOUR_API_KEY" } }
);
const data = await res.json();

import requests

res = requests.get(
    "https://drain.lat/api/v1/medal/clips",
    params={"categoryId": 41, "limit": 5},
    headers={"x-api-key": "YOUR_API_KEY"}
)
print(res.json())

array

Show clip object

string

Clip ID.

string

Clip title.

string

Link to the clip.

string

Thumbnail image URL.

number

Clip duration in seconds.

number

Like count.

number

View count.

number

Game category ID.

number

Number of clips returned.

Response

{
  "clips": [
    {
      "id": "cl_abc123",
      "title": "insane 1v4 clutch",
      "url": "https://medal.tv/clips/abc123",
      "thumbnail": "https://cdn.medal.tv/thumbnails/...",
      "duration": 18,
      "likes": 4200,
      "views": 98400,
      "categoryId": 41
    }
  ],
  "total": 5,
  "scrapedAt": "2026-05-05T12:00:00.000Z"
}

Category ID 41 is PUBG. Use /categories to find IDs for other games.

Get Started

Social

Gaming

Media

Finance

Utilities

Developer Tools

Medal

Medal

​Medal

Medal