Tham chiếu

Smartlink

Smartlink là một bài hát của nghệ sĩ, kèm link tới các nền tảng.

Object smartlink

Trường	Kiểu	Mô tả
id	string (UUID)	Mã smartlink.
url	string	Link công khai, dạng `https://{username}.nhac.to/{slug}`.
slug	string	Đường dẫn của bài trong trang nghệ sĩ.
title	string	Tên bài.
artist_name	string	Dòng tên nghệ sĩ hiển thị, vd "A, B (ft. C)".
status	string	`public`, `unlisted`, `draft` hoặc `scheduled`.
isrc	string	Mã ISRC (12 ký tự, chữ in hoa).
scheduled_at	string \| null	Giờ phát hành khi đang lên lịch (UTC).
release_date	string \| null	Ngày phát hành, YYYY-MM-DD.
cover_url	string	Ảnh bìa.
targets	array	Link nền tảng: `[{ "platform", "url" }]`.
tags	array	Nghệ sĩ được gắn thẻ: `[{ "username", "name", "avatar_url" }]`.
lyrics	string	Lời bài hát.
composer	string	Tác giả.
theme	string	Giao diện trang bài: `blur`, `dark` hoặc `light`.
view_count	integer	Lượt xem trang bài.
click_count	integer	Lượt bấm sang nền tảng.
created_at, updated_at	string	Thời điểm tạo và sửa gần nhất (UTC).

GET/links

Liệt kê smartlink của nghệ sĩ, mới tạo trước, 20 smartlink mỗi trang.

Tham số	Kiểu	Yêu cầu	Mô tả
q	string	Tuỳ chọn	Tìm theo tên bài hoặc dòng tên nghệ sĩ, không phân biệt hoa thường.
page	integer	Tuỳ chọn	Trang, bắt đầu từ 1.

Request

curl "https://link.kick.vn/v1/links?q=lac%20troi&page=1" \
  -H "Authorization: Bearer $KICK_API_TOKEN"

Response · 200

{
  "links": [
    {
      "id": "01a0f1c2-…",
      "url": "https://sontung.nhac.to/lac-troi",
      "slug": "lac-troi",
      "title": "Lạc Trôi",
      "status": "public",
      "click_count": 120,
      …
    }
  ],
  "total": 1,
  "page_size": 20
}

POST/links

Tạo smartlink. Trả 201 kèm link. Chỉ gửi isrc thì KICK tự điền, xem Tạo smartlink từ ISRC.

Trường	Kiểu	Yêu cầu	Mô tả
title	string	Bắt buộc trừ khi chỉ gửi `isrc`	1–200 ký tự.
slug	string	Tuỳ chọn	a-z, 0-9 và dấu -, tối đa 100 ký tự, không trùng trong nghệ sĩ. Bỏ trống thì tạo từ tên bài.
status	string	Tuỳ chọn	Mặc định `draft`; chỉ gửi `isrc` thì mặc định `public`.
artist_name	string	Tuỳ chọn	Tối đa 200 ký tự.
isrc	string	Bắt buộc khi `status` là `scheduled`	12 ký tự; dấu - và khoảng trắng được bỏ qua.
scheduled_at	string	Bắt buộc khi `status` là `scheduled`	RFC 3339 kèm múi giờ, ở tương lai, vd `2026-10-20T20:00:00+07:00`.
release_date	string	Tuỳ chọn	YYYY-MM-DD. Gửi `""` để xoá.
cover_url	string	Tuỳ chọn	Link `https://` hoặc `url` trả về từ /uploads.
targets	array	Tuỳ chọn	Mỗi nền tảng tối đa một link, link phải đúng domain của nền tảng. Xem giá trị platform.
tags	array of string	Tuỳ chọn	Username nghệ sĩ trên KICK (có hoặc không có @), tối đa 10.
lyrics	string	Tuỳ chọn	Tối đa 20.000 ký tự.
composer	string	Tuỳ chọn	Tối đa 200 ký tự.
theme	string	Tuỳ chọn	`blur` (mặc định), `dark` hoặc `light`.

Request

curl -X POST "https://link.kick.vn/v1/links" \
  -H "Authorization: Bearer $KICK_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"title":"Lạc Trôi","artist_name":"Sơn Tùng M-TP","status":"public","targets":[{"platform":"spotify","url":"https://open.spotify.com/track/…"}]}'

GET/links/{id}

Lấy một smartlink. Trả 404 not_found nếu smartlink không thuộc nghệ sĩ của token.

Request

curl "https://link.kick.vn/v1/links/{id}" \
  -H "Authorization: Bearer $KICK_API_TOKEN"

PATCH/links/{id}

Sửa smartlink. Chỉ gửi trường cần đổi, trường không gửi giữ nguyên. targets và tags thay thế toàn bộ danh sách cũ. Nhận cùng các trường như POST /links.

Request

curl -X PATCH "https://link.kick.vn/v1/links/{id}" \
  -H "Authorization: Bearer $KICK_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"status":"unlisted","tags":["den"]}'

DELETE/links/{id}

Xoá vĩnh viễn smartlink. Link công khai ngừng hoạt động ngay.

Request

curl -X DELETE "https://link.kick.vn/v1/links/{id}" \
  -H "Authorization: Bearer $KICK_API_TOKEN"

Giá trị platform

spotifyapple_musicyoutube_musicyoutubezing_mp3nhaccuatuikeengtiktoksoundclouddeezeramazon_musicitunestidalfacebookinstagramaudiomackbandcampshazampandoranapsterqobuzbeatportiheartradiomixcloudaudiusanghamiboomplayjiosaavngaanakkboxjooxline_musicawamelongenieflobugsqq_musicnetease_musickugouyandex_music

Lên lịch phát hành Dò bài, ảnh bìa, nghệ sĩ

Link by KICK