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
| Field | Type | Required | Description |
|---|---|---|---|
musicId | string | Yes | Platform music ID |
title | string | No | Title; case-insensitive matching for favorites |
author | string | No | Artist or author |
duration | string | No | Duration snapshot |
coverUrl | string | No | Cover URL snapshot |
playUrl | string | No | Playback 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.
| Field | Type | Required | Description |
|---|---|---|---|
code | integer | No | — |
message | string | No | — |
data | null | 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