Tham chiếu
Dò bài, ảnh bìa, nghệ sĩ
POST/scan
Dò thông tin bài để điền form, chưa tạo smartlink. Mỗi link kèm confidence (0–100) là độ khớp. Tính vào giới hạn 30 lần mỗi 10 phút.
| Trường | Kiểu | Yêu cầu | Mô tả |
|---|---|---|---|
| query | string | Bắt buộc | Link Spotify / Apple Music / Deezer, mã ISRC, hoặc tên bài kèm tên nghệ sĩ. |
Request
curl -X POST "https://link.kick.vn/v1/scan" \
-H "Authorization: Bearer $KICK_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{"query":"https://open.spotify.com/track/…"}'Response · 200
{
"track": {
"title": "Lạc Trôi",
"artist": "Sơn Tùng M-TP",
"cover_url": "https://…",
"release_date": "2017-01-01",
"lyrics": "…",
"targets": [{ "platform": "spotify", "url": "…", "confidence": 100 }]
}
}POST/uploads
Tải lên một ảnh PNG, JPEG, WEBP hoặc GIF, tối đa 5 MB. Gán url trả về vào cover_url của smartlink.
Request
curl -X POST "https://link.kick.vn/v1/uploads" \ -H "Authorization: Bearer $KICK_API_TOKEN" \ -F "file=@cover.jpg"
Response · 200
{ "url": "https://cdn.kick.vn/images/01a0f3….jpg" }GET/artists/search
Tìm nghệ sĩ trên KICK theo đầu username để gắn thẻ vào tags. Trả tối đa 3 kết quả, trùng khớp hoàn toàn đứng đầu.
| Tham số | Kiểu | Yêu cầu | Mô tả |
|---|---|---|---|
| q | string | Bắt buộc | Phần đầu username, có hoặc không có @. |
Request
curl "https://link.kick.vn/v1/artists/search?q=den" \ -H "Authorization: Bearer $KICK_API_TOKEN"
Response · 200
{ "artists": [{ "username": "den", "name": "Đen", "avatar_url": "https://…" }] }Link by KICK