YouTube Thumbnail API

Dokumentasi resmi YouTube Thumbnail API dari Maelyn API untuk thumbnail video YouTube 5 resolusi (validitas per resolusi dicek)

Base Information

  • BASE_URL_API: https://api.maelyn.eu/api
  • Path / Endpoint: /downloader/youtube/thumbnail
  • Method: GET
  • Credit Usage: 1

Authentication

Gunakan header berikut pada setiap request:

x-maelyn-auth: YOUR_API_KEY

Query Parameters

Endpoint ini mengembalikan 5 resolusi thumbnail (maxres, sd, hq, mq, default). Tiap URL diverifikasi — maxres sering 404 untuk video lama dan dilaporkan jujur.

Example Request

GET /downloader/youtube/thumbnail?id=dQw4w9WgXcQ

Parameters

NameTypeRequiredDescription
idstringYesID video (11 karakter) atau URL YouTube/watch/shorts/embed. Alias: url

Example Usage

GET /downloader/youtube/thumbnail?id=dQw4w9WgXcQ

Success Response

{
  "success": true,
  "data": {
    "platform": "youtube",
    "video_id": "dQw4w9WgXcQ",
    "watch_url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
    "thumbnails": [
      {
        "quality": "maxres",
        "url": "https://i.ytimg.com/vi/dQw4w9WgXcQ/maxresdefault.jpg",
        "width": 1280,
        "height": 720,
        "valid": true,
        "content_type": "image/jpeg",
        "size": 123456
      },
      {
        "quality": "sd",
        "url": "https://i.ytimg.com/vi/dQw4w9WgXcQ/sddefault.jpg",
        "width": 640,
        "height": 480,
        "valid": true,
        "content_type": "image/jpeg",
        "size": 45678
      }
    ],
    "best": {
      "quality": "maxres",
      "url": "https://i.ytimg.com/vi/dQw4w9WgXcQ/maxresdefault.jpg",
      "width": 1280,
      "height": 720,
      "valid": true
    }
  }
}

Playground