YouTube Info API - Documents

Base Information

BASE_URL_API: https://api.maelyn.eu/api
Path / Endpoint: /download/youtube/info
Method: POST
Credit Usage: 1

Authentication

Gunakan header berikut pada setiap request:

x-maelyn-auth: YOUR_API_KEY
Content-Type: application/json

Description

Endpoint ini digunakan untuk mengambil informasi lengkap dari video YouTube tanpa melakukan proses download.

API akan mengembalikan berbagai metadata seperti:

judul video
durasi
channel
thumbnail
daftar format (audio/video)
kualitas yang tersedia

Cocok digunakan untuk:

preview sebelum download
memilih kualitas video/audio
menampilkan metadata video

Request Body

{
  "url": "https://www.youtube.com/watch?v=xxxxxxxxxxx"
}

Body Parameters

Name	Type	Required	Description
`url`	`string`	Yes*	URL video YouTube
`link`	`string`	Yes*	Alternatif dari `url`

Salah satu dari url atau link wajib diisi.

Notes

Body request harus berupa JSON.
URL harus valid dan berasal dari YouTube.
Endpoint ini tidak melakukan download file.
Menggunakan sistem queue untuk menjaga stabilitas server.

Example Usage

{
  "url": "https://www.youtube.com/watch?v=abcdefghijk"
}

Success Response

{
  "success": true,
  "message": "Berhasil mengambil info YouTube",
  "result": {
    "id": "abcdefghijk",
    "title": "Sample YouTube Video",
    "duration": "00:30",
    "thumbnail": "https://i.ytimg.com/vi/abcdefghijk/maxresdefault.jpg",
    "channel": "Sample Channel",
    "views": 123456,
    "upload_date": "2026-04-01",
    "formats": [
      {
        "type": "video",
        "quality": "720p",
        "ext": "mp4",
        "filesize": "15 MB"
      },
      {
        "type": "audio",
        "quality": "128kbps",
        "ext": "mp3",
        "filesize": "3 MB"
      }
    ]
  }
}

Response Fields

Field	Type	Description
`success`	`boolean`	Status request
`message`	`string`	Pesan hasil request
`result`	`object`	Informasi video
`id`	`string`	ID video YouTube
`title`	`string`	Judul video
`duration`	`string`	Durasi video
`thumbnail`	`string`	URL thumbnail
`channel`	`string`	Nama channel
`views`	`number`	Jumlah views
`upload_date`	`string`	Tanggal upload
`formats`	`array`	Daftar format yang tersedia
`type`	`string`	Tipe format (`video` / `audio`)
`quality`	`string`	Kualitas
`ext`	`string`	Format file
`filesize`	`string`	Ukuran file

Error Response

Invalid JSON

{
  "success": false,
  "message": "Body JSON tidak valid"
}

URL Required

{
  "success": false,
  "message": "url wajib diisi"
}

Internal Server Error

{
  "success": false,
  "message": "Internal server error"
}

Playground

Youtube Video Downloader