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

List LINGTU music favorites

Returns the LINGTU music favorites library for the current company, user and TIKTOK_SHOP platform, newest first. The library is stored by LINGTU and is not a TikTok official favorite. Title matching is case-insensitive. Cover and playback snapshots may expire; publish using the music ID.

GET/v1/creator/tiktokshop/music/favorites
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.

Query parameters

FieldTypeRequiredDescription
pageNumberintegerNoPage number; default 1
pageSizeintegerNoItems per page
titlestringNoTitle; case-insensitive matching for favorites
The LINGTU favorites library is stored by LINGTU, not by TikTok, and is scoped to the current company, user and TIKTOK_SHOP platform, newest first.
Cover and playback URLs are snapshots taken when the track was added and may expire; publish with musicId.
Optional title filters by snapshot title, case-insensitively; an empty title returns the whole library.
Success response
{
  "code": 0,
  "message": "success",
  "data": {
    "list": [
      {
        "id": "7567668059796720391",
        "platform": "TIKTOK_SHOP",
        "title": "Sunrise",
        "author": "Example artist",
        "duration": "30",
        "coverUrl": "https://cdn.example.com/music-cover.jpg",
        "playUrl": "https://cdn.example.com/music.mp3",
        "favorited": true
      }
    ],
    "total": 1,
    "pageNumber": 1,
    "pageSize": 10,
    "totalPages": 1
  },
  "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—
dataobjectNo—
data.listobject[]No—
data.list[].idstringNoPlatform musicId
data.list[].platformstringNoFor example TIKTOK_SHOP
data.list[].titlestringNo—
data.list[].authorstringNo—
data.list[].durationstringNo—
data.list[].coverUrlstringNoCover URL snapshot
data.list[].playUrlstringNoPlayback/preview URL snapshot
data.list[].favoritedbooleanNoAlways true; Fixed value: true
data.totalintegerNo—
data.pageNumberintegerNo—
data.pageSizeintegerNo—
data.totalPagesintegerNo—
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