Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.drain.lat/llms.txt

Use this file to discover all available pages before exploring further.

​
Medal

Base URL: https://drain.lat/api/v1/medal All endpoints require the x-api-key header.

​
GET /categories

Get all Medal.tv game categories. Endpoint 
GET /api/v1/medal/categories

curl "https://drain.lat/api/v1/medal/categories" \
  -H "x-api-key: YOUR_API_KEY"
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. Endpoint 
GET /api/v1/medal/clips
Query Parameters
ParameterTypeDefaultDescription
categoryIdnumber-Filter by game category (get IDs from /categories)
limitnumber10Number of clips to return (max 50)
randombooleanfalseReturn random clips instead of top clips
curl "https://drain.lat/api/v1/medal/clips?categoryId=41&limit=5" \
  -H "x-api-key: YOUR_API_KEY"
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.