drain.lat API

GET /profile/:username

Fetch a Twitch channel profile including live status.

GET /api/v1/twitch/profile/:username

string

required

The Twitch channel username.

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

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

import requests

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

string

Twitch user ID.

string

Twitch username.

string

Display name.

string

Channel description.

string

Avatar image URL.

string

Offline banner image URL.

string

Account type: partner, affiliate, or empty string.

number

Total all-time view count.

string

Account creation date (ISO 8601).

boolean

Whether the channel is currently live.

string

Current stream title. Empty string when offline.

string

Game or category being streamed. Empty string when offline.

number

Current viewer count. null when offline.

string

Stream language code.

string[]

Stream tags.

string

Link to the Twitch channel.

Response

{
  "id": "12345678",
  "username": "twitch",
  "displayName": "Twitch",
  "description": "Twitch is where thousands of communities come together.",
  "avatarUrl": "https://...",
  "offlineBannerUrl": "https://...",
  "broadcasterType": "partner",
  "viewCount": 420000000,
  "created": "2011-06-22T00:00:00Z",
  "isLive": false,
  "streamTitle": "",
  "category": "",
  "viewerCount": null,
  "language": "en",
  "tags": ["English"],
  "profileUrl": "https://www.twitch.tv/twitch",
  "scrapedAt": "2026-05-08T10:00:00.000Z"
}

GET /profile/:username/clips

Get top clips for a Twitch channel.

GET /api/v1/twitch/profile/:username/clips

string

required

The Twitch channel username.

number

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

curl "https://drain.lat/api/v1/twitch/profile/xqc/clips?limit=10" \
  -H "x-api-key: YOUR_API_KEY"

const res = await fetch("https://drain.lat/api/v1/twitch/profile/xqc/clips?limit=10", {
  headers: { "x-api-key": "YOUR_API_KEY" }
});
const data = await res.json();

import requests

res = requests.get(
    "https://drain.lat/api/v1/twitch/profile/xqc/clips",
    params={"limit": 10},
    headers={"x-api-key": "YOUR_API_KEY"}
)
print(res.json())

string

Twitch username.

array

Show clip object

string

Clip ID.

string

Clip title.

string

Link to the clip.

string

Embed URL.

string

Thumbnail image URL.

number

View count.

number

Duration in seconds.

string

Creation date (ISO 8601).

string

Username of who clipped it.

string

Game or category at time of clip.

number

Number of clips returned.

Response

{
  "username": "xqc",
  "clips": [
    {
      "id": "AbcDef123",
      "title": "insane play",
      "url": "https://clips.twitch.tv/AbcDef123",
      "embedUrl": "https://clips.twitch.tv/embed?clip=AbcDef123",
      "thumbnailUrl": "https://...",
      "viewCount": 420000,
      "duration": 30.0,
      "createdAt": "2026-04-01T12:00:00Z",
      "creatorName": "xqc",
      "gameName": "Just Chatting"
    }
  ],
  "total": 10,
  "scrapedAt": "2026-05-08T10:00:00.000Z"
}

GET /profile/:username/videos

Get past broadcasts and VODs for a Twitch channel.

GET /api/v1/twitch/profile/:username/videos

string

required

The Twitch channel username.

number

Number of videos to return. Max 20. Default 10.

curl "https://drain.lat/api/v1/twitch/profile/xqc/videos?limit=10" \
  -H "x-api-key: YOUR_API_KEY"

const res = await fetch("https://drain.lat/api/v1/twitch/profile/xqc/videos?limit=10", {
  headers: { "x-api-key": "YOUR_API_KEY" }
});
const data = await res.json();

import requests

res = requests.get(
    "https://drain.lat/api/v1/twitch/profile/xqc/videos",
    params={"limit": 10},
    headers={"x-api-key": "YOUR_API_KEY"}
)
print(res.json())

string

Twitch username.

array

Show video object

string

Video ID.

string

Video title.

string

Video description.

string

Link to the video.

string

Thumbnail image URL.

number

View count.

string

Duration (e.g. 8h30m0s).

string

Publish date (ISO 8601).

string

Video type: archive, highlight, or upload.

number

Number of videos returned.

Response

{
  "username": "xqc",
  "videos": [
    {
      "id": "1234567890",
      "title": "!prime | xQcOW",
      "description": "",
      "url": "https://www.twitch.tv/videos/1234567890",
      "thumbnailUrl": "https://...",
      "viewCount": 85000,
      "duration": "8h30m0s",
      "publishedAt": "2026-05-07T18:00:00Z",
      "type": "archive"
    }
  ],
  "total": 10,
  "scrapedAt": "2026-05-08T10:00:00.000Z"
}

Get Started

Social

Gaming

Media

Finance

Utilities

Developer Tools

Twitch

Twitch

​Twitch

Twitch