TikTok API endpoint
Returns one playlist's record unmodified in `mix`: `mix_id`, `name`, `mix_type`, `creator_name`, `author`, `share_info`, `statistic.total` and `status`, plus `is_collect`. `mix_id` is the web playlist id namespace; the owner identity selector (`user_id` or `sec_user_id`) is required as well (the mobile route rejects `mix_id` alone with `status_code 5`).
/tiktok/mobile/playlist/detailReturns one playlist's record unmodified in mix: mix_id, name, mix_type, creator_name, author,
share_info, statistic.total (video count), status and last_add_video_timestamp, plus is_collect.
mix_id belongs to the same id namespace as the web playlist URL.
Query parameters:
mix_id: required. The playlist id (web playlist id namespace).user_id: optional. The playlist owner's numeric uid. One identity selector of the owner is required as well
as mix_id: the upstream answers status_code 5 "Invalid parameters" for mix_id alone.sec_user_id: optional. The owner's sec_user_id (alternative to user_id).Measured 2026-10-24: mix_id=7681171537575824159 with the owner
identity answers 2.8 KB, status_code: 0, mix.name "Songs Of The Summer 2026", mix.creator_name "tiktok",
mix.statistic.total 3 and mix.status.status 1.
Example request:
GET /api/v1/tiktok/mobile/playlist/detail?mix_id=7681171537575824159&sec_user_id=MS4wLjABAAAAv7iSuuXDJGDvJkmH_vz1qkDZYo1apxgzaxdBSeIuPiM
Example response (truncated):
{
"code": 200,
"msg": "OK",
"data": {
"mix": {
"mix_id": "7681171537575824159",
"name": "Songs Of The Summer 2026",
"mix_type": 1,
"creator_name": "tiktok",
"statistic": {"total": 3},
"status": {"status": 1}
},
"is_collect": false,
"status_code": 0
}
}
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| x-api-key (header) | string | Yes | API key required | ||
| mix_id | string | Yes | Playlist id (web playlist id namespace) | 7681171537575824159 | |
| user_id | string | No | Playlist owner's numeric user id (one of user_id / sec_user_id is required) | 107955 | |
| sec_user_id | string | No | Playlist owner's sec_user_id (one of user_id / sec_user_id is required) |
curl -X GET "https://api.crawlora.net/api/v1/tiktok/mobile/playlist/detail?mix_id=7681171537575824159" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"mix": {
"mix_id": "7681171537575824159",
"name": "Songs Of The Summer 2026",
"mix_type": 1,
"creator_name": "tiktok",
"statistic": {
"total": 3
},
"status": {
"status": 1
}
},
"is_collect": false,
"status_code": 0
}
}Request schema
No body schema
Response schema
#/definitions/tiktokmobile.playlistDetailResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | tiktokmobile.PlaylistDetailResponse | No | ||||
| data.extra | unknown | No | ||||
| data.is_collect | boolean | No | ||||
| data.log_pb | unknown | No | ||||
| data.mix | tiktokmobile.PlaylistSummary | No | PlaylistSummary record, 9 fields: author, creator_name, last_add_video_timestamp, mix_id, mix_type, name, share_info, statistic, status. Described under List a creator's TikTok playlists API. | |||
| data.status_code | integer | No | ||||
| data.status_msg | string | No | ||||
| msg | string | No | OK |
| Status | Description | Schema |
|---|---|---|
| 400 | Invalid input | #/definitions/app.Response |
| 429 | Rate limit exceeded | #/definitions/app.Response |
| 500 | Internal server error | #/definitions/app.Response |
Use environment variables for secrets and keep Crawlora API keys server-side.
curl -X GET "https://api.crawlora.net/api/v1/tiktok/mobile/playlist/detail?mix_id=7681171537575824159" \
-H "x-api-key: $CRAWLORA_API_KEY"