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
| Field | Type | Required | Description |
|---|---|---|---|
pageNumber | integer | No | Page number; default 1 |
pageSize | integer | No | Items per page |
title | string | No | Title; 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.
| Field | Type | Required | Description |
|---|---|---|---|
code | integer | No | — |
message | string | No | — |
data | object | No | — |
data.list | object[] | No | — |
data.list[].id | string | No | Platform musicId |
data.list[].platform | string | No | For example TIKTOK_SHOP |
data.list[].title | string | No | — |
data.list[].author | string | No | — |
data.list[].duration | string | No | — |
data.list[].coverUrl | string | No | Cover URL snapshot |
data.list[].playUrl | string | No | Playback/preview URL snapshot |
data.list[].favorited | boolean | No | Always true; Fixed value: true |
data.total | integer | No | — |
data.pageNumber | integer | No | — |
data.pageSize | integer | No | — |
data.totalPages | integer | No | — |
timestamp | integer | No | — |
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