drain.lat API

GET /profile/:handle

Fetch a YouTube channel profile. Handle can be with or without @.

GET /api/v1/youtube/profile/:handle

string

required

YouTube channel handle. Both MrBeast and @MrBeast are valid.

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

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

import requests

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

string

YouTube channel ID.

string

Channel handle (with @).

string

Channel display name.

string

Channel description.

string

Channel avatar URL.

string

Country code.

string

Channel creation date (ISO 8601).

number

Subscriber count.

number

Total view count.

number

Total number of videos.

string

Link to the YouTube channel.

Response

{
  "id": "UCX6OQ3DkcsbYNE6H8uQQuVA",
  "username": "@MrBeast",
  "displayName": "MrBeast",
  "description": "SUBSCRIBE FOR A COOKIE",
  "avatarUrl": "https://yt3.googleusercontent.com/...",
  "country": "US",
  "created": "2012-02-19T21:23:10Z",
  "subscribers": 340000000,
  "totalViews": 65000000000,
  "videoCount": 812,
  "profileUrl": "https://www.youtube.com/@MrBeast",
  "scrapedAt": "2026-05-05T12:00:00.000Z"
}

GET /profile/:handle/videos

Get the last 10 uploaded videos from a YouTube channel.

GET /api/v1/youtube/profile/:handle/videos

string

required

YouTube channel handle.

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

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

import requests

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

string

Channel handle.

array

Show video object

string

Video ID.

string

Video title.

string

Video description.

string

Thumbnail image URL.

string

Publish date (ISO 8601).

string

Link to the video.

number

Number of videos returned.

Response

{
  "handle": "MrBeast",
  "videos": [
    {
      "id": "dQw4w9WgXcQ",
      "title": "I Spent 7 Days Buried Alive",
      "description": "This was insane...",
      "thumbnailUrl": "https://i.ytimg.com/vi/dQw4w9WgXcQ/hqdefault.jpg",
      "publishedAt": "2026-04-15T18:00:00Z",
      "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ"
    }
  ],
  "total": 10,
  "scrapedAt": "2026-05-05T12:00:00.000Z"
}

GET /channel/:channelId

Fetch a YouTube channel by raw channel ID.

GET /api/v1/youtube/channel/:channelId

string

required

The YouTube channel ID (starts with UC).

curl "https://drain.lat/api/v1/youtube/channel/UCBcRF18a7Qf58cCRy5xuWwQ" \
  -H "x-api-key: YOUR_API_KEY"

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

import requests

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

string

Channel ID.

string

Channel handle (with @).

string

Channel display name.

string

Channel description.

string

Channel avatar URL.

string

Channel banner image URL.

string

Country code.

string

Channel creation date (ISO 8601).

number

Subscriber count.

number

Total view count.

number

Total number of videos.

string

Link to the YouTube channel.

Response

{
  "id": "UCxxxxxx",
  "username": "@mkbhd",
  "displayName": "Marques Brownlee",
  "description": "Quality Tech Videos.",
  "avatarUrl": "https://...",
  "bannerUrl": "https://yt3.googleusercontent.com/banner/...",
  "country": "US",
  "created": "2009-03-21T00:00:00.000Z",
  "subscribers": 18500000,
  "totalViews": 4200000000,
  "videoCount": 1600,
  "profileUrl": "https://www.youtube.com/@mkbhd",
  "scrapedAt": "2026-05-08T10:00:00.000Z"
}

GET /video/:videoId

Get stats and metadata for a single YouTube video.

GET /api/v1/youtube/video/:videoId

string

required

The YouTube video ID (e.g. dQw4w9WgXcQ).

curl "https://drain.lat/api/v1/youtube/video/dQw4w9WgXcQ" \
  -H "x-api-key: YOUR_API_KEY"

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

import requests

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

string

Video ID.

string

Video title.

string

Video description.

string

Channel ID.

string

Channel name.

string

Publish date (ISO 8601).

string

Thumbnail image URL.

string[]

List of tags.

string

Duration in ISO 8601 format (e.g. PT3M33S).

number

View count.

number

Like count.

number

Comment count.

string

Link to the video.

Response

{
  "id": "dQw4w9WgXcQ",
  "title": "Rick Astley - Never Gonna Give You Up",
  "description": "The official video...",
  "channelId": "UCxxxxxx",
  "channelTitle": "Rick Astley",
  "publishedAt": "2009-10-25T06:57:33.000Z",
  "thumbnailUrl": "https://...",
  "tags": ["rick astley", "pop"],
  "duration": "PT3M33S",
  "views": 1400000000,
  "likes": 16000000,
  "comments": 2400000,
  "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
  "scrapedAt": "2026-05-08T10:00:00.000Z"
}

GET /search

Search YouTube videos.

GET /api/v1/youtube/search

string

required

Search query.

number

Number of results. Max 25. Default 10.

curl "https://drain.lat/api/v1/youtube/search?q=linux+tutorial&limit=10" \
  -H "x-api-key: YOUR_API_KEY"

const res = await fetch("https://drain.lat/api/v1/youtube/search?q=linux+tutorial&limit=10", {
  headers: { "x-api-key": "YOUR_API_KEY" }
});
const data = await res.json();

import requests

res = requests.get(
    "https://drain.lat/api/v1/youtube/search",
    params={"q": "linux tutorial", "limit": 10},
    headers={"x-api-key": "YOUR_API_KEY"}
)
print(res.json())

string

The search query used.

array

Show video object

string

Video ID.

string

Video title.

string

Video description snippet.

string

Channel ID.

string

Channel name.

string

Publish date (ISO 8601).

string

Thumbnail image URL.

string

Link to the video.

number

Number of results returned.

Response

{
  "query": "linux tutorial",
  "videos": [
    {
      "id": "abc123",
      "title": "Linux for Beginners",
      "description": "Learn Linux...",
      "channelId": "UCxxxxxx",
      "channelTitle": "TechChannel",
      "publishedAt": "2026-01-01T00:00:00.000Z",
      "thumbnailUrl": "https://...",
      "url": "https://www.youtube.com/watch?v=abc123"
    }
  ],
  "total": 10,
  "scrapedAt": "2026-05-08T10:00:00.000Z"
}

Get Started

Social

Gaming

Media

Finance

Utilities

Developer Tools

YouTube

YouTube

​YouTube

YouTube