TikTok Profile Playlists API Documentation
The TikTok Profile Playlists API returns the public playlists of a TikTok creator: each playlist's name, number of videos, cover thumbnail and link, together with a summary of the profile. A creator without playlists returns an empty playlists list with the error TikTok Profile has no playlists. When more playlists are available, pagination.next_page_token retrieves the next page.
API Parameters
Search Query
-
- Name
-
username - Required
- Required
- Description
-
Parameter defines the TikTok username whose playlists you want to retrieve. You can use the username with or without the
@symbol.
For example,@tiktokandtiktokwill both retrieve the same creator's playlists.
Pagination
-
- Name
-
next_page_token - Required
- Optional
- Description
-
Parameter defines the token used to retrieve the next page of playlists. It is returned as
pagination.next_page_tokenwhen more playlists are available.
Engine
-
- Name
-
engine - Required
- Required
- Description
-
Parameter defines an engine that will be used to retrieve real-time data. It must be set to
tiktok_profile_playlists.
API key
-
- Name
-
api_key - Required
- Required
- Description
-
The
api_keyauthenticates your requests. Use it as a query parameter (https://www.searchapi.io/api/v1/search?api_key=YOUR_API_KEY) or in the Authorization header (Bearer YOUR_API_KEY).
Zero Data Retention
-
- Name
-
zero_retention - Enterprise Only
- Enterprise Only
- Required
- Optional
- Description
-
Set this parameter to
trueto disable all logging and persistent storage. No request parameters, HTML, or JSON responses are stored or logged. Suitable for high-compliance use cases. Debugging and support may be limited while enabled.
API Examples
Full Response
Each playlist carries its position, id, name, videos_count, cover and a link that opens the playlist on TikTok.
https://www.searchapi.io/api/v1/search?engine=tiktok_profile_playlists&username=tiktok
- Python
- Node
- Ruby
- Java
- Go
- PHP
- Bash
- R
- Kotlin
- Swift
- C#
- C
- C++
- requests
import requests
url = "https://www.searchapi.io/api/v1/search"
params = {
"engine": "tiktok_profile_playlists",
"username": "tiktok"
}
response = requests.get(url, params=params)
print(response.text)
{
"search_metadata": {
"id": "search_6KHUkOzJEjsP6oLBRd3FKyVt",
"status": "Success",
"created_at": "2026-10-01T02:24:40Z",
"request_time_taken": 4.37,
"parsing_time_taken": 0.02,
"total_time_taken": 4.38,
"request_url": "https://www.tiktok.com/@tiktok",
"html_url": "https://www.searchapi.io/api/v1/searches/search_6KHUkOzJEjsP6oLBRd3FKyVt.html",
"json_url": "https://www.searchapi.io/api/v1/searches/search_6KHUkOzJEjsP6oLBRd3FKyVt"
},
"search_parameters": {
"engine": "tiktok_profile_playlists",
"username": "tiktok"
},
"profile": {
"id": "107955",
"username": "tiktok",
"link": "https://www.tiktok.com/@tiktok",
"name": "TikTok",
"bio": "Your next discovery is waiting on TikTok.",
"avatar": "https://p16-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/ba67b11de451691939223e9d978e613a~tp...",
"is_verified": true,
"followers": 95985147,
"following": 1,
"hearts": 464813888,
"posts": 1508
},
"playlists": [
{
"position": 1,
"id": "7681171537575824159",
"name": "Songs Of The Summer 2026",
"link": "https://www.tiktok.com/@tiktok/playlist/Songs%20Of%20The%20Summer%202026-7681171537575824159",
"videos_count": 3,
"cover": "https://p16-common-sign.tiktokcdn-us.com/tos-useast8-p-0068-tx2/o8UZ7AA11Ciogu5XByiiAPBcCSAIMnAIEBfa..."
},
"..."
]
}