YT Toolkit API

Base URL and response shape

All endpoints are under https://www.yttools.pro/api and respond with JSON in a consistent envelope:

// success
{ "success": true, "data": { ... }, "meta": {} }

// error
{ "success": false, "error": { "code": "VIDEO_NOT_FOUND", "message": "..." } }

Rate limits

Requests are limited per IP address to keep the service fair and to stay within YouTube API quota. Standard read endpoints allow roughly 60 requests per minute. Exceeding the limit returns HTTP 429 with a Retry-After header. Do not build production workloads on top of these endpoints — they are intended for light, interactive use.

Endpoints

GET /api/youtube/thumbnail

Returns thumbnail URLs in every available quality for a video.

curl "https://www.yttools.pro/api/youtube/thumbnail?v=VIDEO_ID"

GET /api/youtube/video-stats

Public video metadata and statistics. The JSON data includes id, title, description, thumbnail, channelId, channelTitle, publishedAt (ISO 8601), formatted duration, category (YouTube category ID), numeric view/like/comment counts, availability flags for those counters, and tags. An unavailable counter has a false availability flag; it is not the same as a returned count of zero.

{
  "success": true,
  "data": {
    "id": "VIDEO_ID",
    "title": "Video title",
    "description": "Public video description",
    "thumbnail": "https://...",
    "channelId": "UC...",
    "channelTitle": "Channel name",
    "publishedAt": "2026-09-29T12:34:56Z",
    "duration": "12:34",
    "category": "27",
    "viewCount": 12345,
    "likeCount": 321,
    "commentCount": 45,
    "tags": ["example"],
    "viewCountAvailable": true,
    "likeCountAvailable": true,
    "commentCountAvailable": true
  },
  "meta": {}
}

curl "https://www.yttools.pro/api/youtube/video-stats?v=VIDEO_ID"

GET /api/youtube/channel-stats

Public channel statistics: subscribers, total views, video count, recent uploads.

curl "https://www.yttools.pro/api/youtube/channel-stats?c=UC_CHANNEL_ID"

GET /api/youtube/playlist

Total duration, video count, and average length for a playlist.

curl "https://www.yttools.pro/api/youtube/playlist?list=PLAYLIST_ID"

Examples

JavaScript (fetch)

const res = await fetch(
  "https://www.yttools.pro/api/youtube/video-stats?v=VIDEO_ID"
);
const json = await res.json();
if (json.success) console.log(json.data);

Python (requests)

import requests

r = requests.get(
    "https://www.yttools.pro/api/youtube/video-stats",
    params={"v": "VIDEO_ID"},
)
data = r.json()
if data["success"]:
    print(data["data"])

Terms of use

These endpoints return only public YouTube data and are provided as-is, without warranty, for light interactive use. Respect the rate limits, do not scrape at scale, and cache responses on your side where possible. See our Terms for details. YT Toolkit is independent and not affiliated with YouTube or Google.

Prefer the tools?

Most people do not need the API. Use the Video Statistics, Channel Statistics, or Thumbnail Downloader tools directly.