TikTok Profile Playlists API Documentation

GET   /api/v1/search?engine=tiktok_profile_playlists

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, @tiktok and tiktok will 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_token when 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_key authenticates 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 true to 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

Full Response

Each playlist carries its position, id, name, videos_count, cover and a link that opens the playlist on TikTok.

GET
https://www.searchapi.io/api/v1/search?engine=tiktok_profile_playlists&username=tiktok
Request
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)
Response
{
  "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..."
    },
    "..."
  ]
}