TikTok / Douyin Metadata API

Dokumentasi resmi TikTok / Douyin Metadata API dari Maelyn API untuk mengambil informasi lengkap video atau foto dari TikTok

Base Information

  • BASE_URL_API: https://api.maelyn.eu
  • Path / Endpoint: /downloader/tiktok/metadata
  • Full URL: https://api.maelyn.eu/downloader/tiktok/metadata
  • Method: GET
  • Credit Usage: 1

Authentication

Gunakan header berikut pada setiap request:

maelyn_auth: YOUR_API_KEY

Query Parameters

Endpoint ini digunakan untuk mengambil metadata lengkap dari video atau foto TikTok / Douyin.

Example Request

GET /downloader/tiktok/metadata?url=https://www.tiktok.com/@user/video/123456789

Parameters

NameTypeRequiredDescription
urlstringYesURL video atau foto TikTok

Example Usage

GET /downloader/tiktok/metadata?url=https://www.tiktok.com/@user/video/123456789

Success Response (Hybrid)

{
  "success": true,
  "type": "video",
  "source": "hybrid",
  "metadata": {
    "title": "Contoh video TikTok",
    "author": {
      "username": "username",
      "nickname": "User Name"
    },
    "video": {
      "nwm_url": "https://video-url-no-watermark.mp4",
      "wm_url": "https://video-url-watermark.mp4"
    },
    "music": {
      "title": "Original Sound",
      "url": "https://audio-url.mp3"
    },
    "statistics": {
      "plays": 10000,
      "likes": 500,
      "comments": 50
    }
  }
}

Success Response (Fallback ID)

{
  "success": true,
  "type": "video",
  "source": "id",
  "metadata": {
    "author": {
      "nickname": "User Name"
    },
    "video": {
      "url": "https://video-url.mp4"
    }
  }
}

Error Response

Missing URL

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

Invalid TikTok URL

{
  "success": false,
  "message": "URL TikTok tidak valid"
}

Metadata Not Found

{
  "success": false,
  "message": "Gagal mengambil metadata TikTok"
}

Internal Server Error

{
  "success": false,
  "message": "Terjadi kesalahan saat memproses permintaan"
}

Playground