# List LINGTU music favorites

- API version: 1.11.0
- Last updated: 2026-11-16
- Server: `https://api.ailingtu.com`
- Web document: [List LINGTU music favorites](/en/openapi/favorite-music-list)
- Full schema: [JSON Schema](/en/openapi/operations/listTikTokShopFavoriteMusic.json)
- Discovery: [Operation index](/en/openapi/operations/index.json)

## GET /v1/creator/tiktokshop/music/favorites

Operation ID: `listTikTokShopFavoriteMusic`

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.

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 parameters

| Field | Location | Type | Required | Description |
|---|---|---|---|---|
| `pageNumber` | query | integer | No | Page number; default 1 |
| `pageSize` | query | integer | No | Items per page |
| `title` | query | string | No | Title; case-insensitive matching for favorites |

### Success response

```json
{
  "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 fields

Main levels are listed below. The endpoint JSON Schema is authoritative for the full structure, unions and validation rules; Required refers to 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 | — |

### Integration notes and limits

- 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.

### Related endpoints

- [Search TikTok Shop music](/en/openapi/search-music) · [Markdown](/en/openapi/operations/searchTikTokShopMusic.md)
- [Add to LINGTU music favorites](/en/openapi/favorite-music) · [Markdown](/en/openapi/operations/favoriteTikTokShopMusic.md)
- [Remove from LINGTU music favorites](/en/openapi/unfavorite-music) · [Markdown](/en/openapi/operations/unfavoriteTikTokShopMusic.md)
