您的浏览器不支持JavaScript,请启用JavaScript以获得最佳体验。
Add to LINGTU music favorites
Developer docs / Music and locations

Add to LINGTU music favorites

Idempotently adds a track to the LINGTU music favorites library for TIKTOK_SHOP. This library is stored by LINGTU and is not a TikTok official favorite. Existing entries refresh non-empty title, author, duration, coverUrl and playUrl. Use coverThumb.urlList[0] and playUrl.urlList[0] from music search for URL snapshots.

POST/v1/creator/tiktokshop/music/favorite
Authentication:
Request header x-api-key: <YOUR_API_KEY>; keep the key on the server and never expose it in client code, logs or shared files.
Success criteria:
HTTP 2xx with code=0; for asynchronous tasks, also query the final status.

Request body fields

FieldTypeRequiredDescription
musicIdstringYesPlatform music ID
titlestringNoTitle; case-insensitive matching for favorites
authorstringNoArtist or author
durationstringNoDuration snapshot
coverUrlstringNoCover URL snapshot
playUrlstringNoPlayback URL snapshot
The LINGTU favorites library is stored by LINGTU, not by TikTok, and is scoped to the current company, user and TIKTOK_SHOP platform.
Idempotent: existing entries refresh non-empty title, author, duration, coverUrl and playUrl.
Use coverThumb.urlList[0] and playUrl.urlList[0] from music search for URL snapshots; snapshots may expire, so publish with musicId.
Request body
{
  "musicId": "7567668059796720391",
  "title": "Sunrise",
  "author": "Example artist",
  "duration": "30",
  "coverUrl": "https://cdn.example.com/music-cover.jpg",
  "playUrl": "https://cdn.example.com/music.mp3"
}
Success response
{
  "code": 0,
  "message": "success",
  "data": null,
  "timestamp": 1790640000000
}

Response and errors

Main response fields come from the published contract; see the JSON Schema. Required refers to the constraint in the containing object.

FieldTypeRequiredDescription
codeintegerNo—
messagestringNo—
datanullNo—
timestampintegerNo—

Fix parameter, permission or authorization errors before retrying. If task creation times out, query existing tasks first and do not submit duplicates after an interrupted poll.

Last updated · 2026-11-16