Skip to main content

​
Medal

Base URL: https://drain.lat/api/v1/medal
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"
​
categories
array
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 top or random clips from Medal.tv.
GET /api/v1/medal/clips
​
categoryId
number
Filter by game category ID. Get IDs from /categories.
​
limit
number
Number of clips to return. Max 50. Default 10.
​
random
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"
​
clips
array
​
total
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.