TikTok Playlist API Documentation

GET   /api/v1/search?engine=tiktok_playlist

The TikTok Playlist API returns the videos of a TikTok playlist in playlist order, together with the owner of the playlist, the creator who made it. Pass the playlist page url, as shared from the Playlists tab of a creator's profile, or its numeric playlist_id, and page through the full playlist with pagination.next_page_token. Each video has the same shape as the TikTok Profile Videos API, so a video's link can be passed as url to the TikTok Video API or the TikTok Transcripts API.

API Parameters

Search Query

  • Name
    url
    Required
    Optional
    Description

    Parameter defines the TikTok playlist page URL, for example https://www.tiktok.com/@tiktok/playlist/In-The-Mix-7516638364301265695. The numeric id at the end of the URL identifies the playlist.
    Either url or playlist_id is required; provide one of them, not both.

  • Name
    playlist_id
    Required
    Optional
    Description

    Parameter defines the numeric TikTok playlist id, the number at the end of the playlist page URL, for example 7516638364301265695.
    Either url or playlist_id is required; provide one of them, not both.

Pagination

  • Name
    next_page_token
    Required
    Optional
    Description

    Parameter defines the token used to retrieve the next page of videos. It is returned as pagination.next_page_token when more videos are available. The token identifies the playlist, so url and playlist_id can be omitted when it is set.

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

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

The playlist object carries the playlist id, page link and owner, the creator who made it, and videos the posts in playlist order with their position, caption, iso_date, engagement counts, thumbnail, music and the hashtags and mentions parsed from the caption. Up to 20 videos are returned per page.

GET
https://www.searchapi.io/api/v1/search?engine=tiktok_playlist&url=https%3A%2F%2Fwww.tiktok.com%2F%40tiktok%2Fplaylist%2FIn-The-Mix-7516638364301265695
Request
import requests

url = "https://www.searchapi.io/api/v1/search"
params = {
  "engine": "tiktok_playlist",
  "url": "https://www.tiktok.com/@tiktok/playlist/In-The-Mix-7516638364301265695"
}

response = requests.get(url, params=params)
print(response.text)
Response
{
  "search_metadata": {
    "id": "search_7t9SzU36ewxlfkvGX2L5GSMJ",
    "status": "Success",
    "created_at": "2026-10-01T01:09:08Z",
    "request_time_taken": 2.16,
    "parsing_time_taken": 0.02,
    "total_time_taken": 2.18,
    "request_url": "https://www.tiktok.com/@tiktok/playlist/In-The-Mix-7516638364301265695",
    "html_url": "https://www.searchapi.io/api/v1/searches/search_9ctpFmaodHQlG48aAlwrAKqw.html",
    "json_url": "https://www.searchapi.io/api/v1/searches/search_fpbMGLhX2saSrBvii3kpTI3p"
  },
  "search_parameters": {
    "engine": "tiktok_playlist",
    "url": "https://www.tiktok.com/@tiktok/playlist/In-The-Mix-7516638364301265695"
  },
  "playlist": {
    "id": "7516638364301265695",
    "link": "https://www.tiktok.com/@tiktok/playlist/In-The-Mix-7516638364301265695",
    "owner": {
      "id": "107955",
      "username": "tiktok",
      "link": "https://www.tiktok.com/@tiktok",
      "name": "TikTok",
      "bio": "Your next discovery is waiting on TikTok.",
      "avatar": "https://p19-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/ba67b11de451691939223e9d978e613a~tp...",
      "is_verified": true,
      "followers": 96000000,
      "following": 1,
      "hearts": 464800000,
      "posts": 1508
    }
  },
  "videos": [
    {
      "position": 1,
      "id": "7516636731223837983",
      "link": "https://www.tiktok.com/@tiktok/video/7516636731223837983",
      "type": "video",
      "caption": "ty @Zara Larsson for yapping about TikTok and music with us and Jack Coyne for In The Mix! 💖🌈",
      "language": "en",
      "mentions": [
        "zaralarsson"
      ],
      "iso_date": "2025-06-16T19:49:53Z",
      "duration": 1560,
      "width": 576,
      "height": 1024,
      "views": 871700,
      "likes": 15800,
      "comments": 4959,
      "shares": 991,
      "saves": 1437,
      "thumbnail": "https://p16-common-sign.tiktokcdn-us.com/tos-useast8-p-0068-tx2/oMr6rAA6QCIh5zBgE2FEAqDfIoAjTeAQIifX...",
      "dynamic_thumbnail": "https://p19-common-sign.tiktokcdn-us.com/tos-useast8-p-0068-tx2/oMr6rAA6QCIh5zBgE2FEAqDfIoAjTeAQIifX...",
      "video_meta": {
        "definition": "540p",
        "ratio": "540p",
        "format": "mp4",
        "codec_type": "h264",
        "size": 148214410,
        "bitrate": 759674,
        "bitrates": [
          {
            "gear_name": "normal_540_0",
            "bitrate": 759674,
            "fps": 23,
            "codec_type": "h264",
            "format": "mp4"
          },
          "..."
        ]
      },
      "music": {
        "id": "7516636859129137951",
        "title": "original sound",
        "author": "TikTok",
        "cover": "https://p19-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/ba67b11de451691939223e9d978e613a~tp...",
        "duration": 1560,
        "play_url": "https://v16m.tiktokcdn-us.com/f93cd38ea6ad5b6c5536377b00af97ea/6abe0d2e/video/tos/useast8/tos-useast...",
        "is_original": true,
        "link": "https://www.tiktok.com/music/original-sound-7516636859129137951"
      },
      "subtitles": [
        {
          "language": "eng-US",
          "format": "webvtt",
          "source": "ASR",
          "url": "https://v16m-webapp.tiktokcdn-us.com/b5cbc4228dc1d29a855e2707f528ff41/6ac05bce/video/tos/useast8/tos...",
          "url_expires_at": "2026-10-03T01:35:10Z"
        },
        "..."
      ]
    },
    "..."
  ],
  "pagination": {
    "has_more": true,
    "next_page_token": "eyJjdXJzb3IiOiIyMCIsInBsYXlsaXN0X2lkIjoiNzUxNjYzODM2NDMwMTI2NTY5NSJ9"
  }
}

Playlist by playlist_id

The numeric id at the end of a playlist page URL identifies the playlist on its own, so playlist_id can replace url.

GET
https://www.searchapi.io/api/v1/search?engine=tiktok_playlist&playlist_id=6954279265768639237
Request
import requests

url = "https://www.searchapi.io/api/v1/search"
params = {
  "engine": "tiktok_playlist",
  "playlist_id": "6954279265768639237"
}

response = requests.get(url, params=params)
print(response.text)
Response
{
  "search_metadata": {
    "id": "search_SJBXeBiASNpWrDUj2frqqahI",
    "status": "Success",
    "created_at": "2026-10-01T01:09:27Z",
    "request_time_taken": 2.59,
    "parsing_time_taken": 0.02,
    "total_time_taken": 2.61,
    "request_url": "https://www.tiktok.com/explore",
    "html_url": "https://www.searchapi.io/api/v1/searches/search_QC3NZl8aCcDkU7QbXTji3Apl.html",
    "json_url": "https://www.searchapi.io/api/v1/searches/search_BTwZt2g61wt5Wija3hVxj7zp"
  },
  "search_parameters": {
    "engine": "tiktok_playlist",
    "playlist_id": "6954279265768639237"
  },
  "playlist": {
    "id": "6954279265768639237",
    "link": "https://www.tiktok.com/@tiktok/playlist/playlist-6954279265768639237",
    "owner": {
      "id": "107955",
      "username": "tiktok",
      "link": "https://www.tiktok.com/@tiktok",
      "name": "TikTok",
      "bio": "Your next discovery is waiting on TikTok.",
      "avatar": "https://p19-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/ba67b11de451691939223e9d978e613a~tp...",
      "is_verified": true,
      "followers": 96000000,
      "following": 1,
      "hearts": 464800000,
      "posts": 1508
    }
  },
  "videos": [
    {
      "position": 1,
      "id": "7165922997524516138",
      "link": "https://www.tiktok.com/@tiktok/video/7165922997524516138",
      "type": "video",
      "caption": "Manage screen time, privacy and more on TikTok. Start the convo with your teen today & activate #FamilyPairing in your settings. #TikTokFamilyPairing",
      "language": "en",
      "hashtags": [
        "familypairing",
        "tiktokfamilypairing"
      ],
      "iso_date": "2022-11-14T17:21:29Z",
      "duration": 15,
      "width": 576,
      "height": 1024,
      "is_ad": true,
      "is_duet_enabled": true,
      "is_stitch_enabled": true,
      "views": 342500000,
      "likes": 541800,
      "comments": 0,
      "shares": 19600,
      "saves": 63731,
      "thumbnail": "https://p19-common-sign.tiktokcdn-us.com/tos-useast5-p-0068-tx/4d2daa285a0942b1b5b3065fe6e49715_1668...",
      "dynamic_thumbnail": "https://p16-common-sign.tiktokcdn-us.com/tos-useast5-p-0068-tx/fbc8a815d54a4d1e969b6c32a5f4ef43_1668...",
      "video_meta": {
        "definition": "540p",
        "ratio": "540p",
        "format": "mp4",
        "codec_type": "h264",
        "size": 1452992,
        "bitrate": 765740,
        "bitrates": [
          {
            "gear_name": "adapt_lowest_1080_1",
            "bitrate": 1340269,
            "fps": 23,
            "codec_type": "h265_hvc1",
            "format": "mp4"
          },
          "..."
        ]
      },
      "music": {
        "id": "7165923096850549546",
        "title": "original sound",
        "author": "TikTok",
        "cover": "https://p16-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/ba67b11de451691939223e9d978e613a~tp...",
        "duration": 15,
        "play_url": "https://v16m.tiktokcdn-us.com/06e8d2872586cecee1c51781ea81b43e/6abe0738/video/tos/useast5/tos-useast...",
        "is_original": true,
        "link": "https://www.tiktok.com/music/original-sound-7165923096850549546"
      },
      "subtitles": [
        {
          "language": "eng-US",
          "format": "webvtt",
          "source": "ASR",
          "url": "https://v16m-webapp.tiktokcdn-us.com/3f15db4488681b5f4b85fdf416d3e2ae/6ac055d8/video/tos/useast5/tos...",
          "url_expires_at": "2026-10-03T01:09:44Z"
        },
        "..."
      ]
    },
    "..."
  ],
  "pagination": {
    "has_more": true,
    "next_page_token": "eyJjdXJzb3IiOiIyMCIsInBsYXlsaXN0X2lkIjoiNjk1NDI3OTI2NTc2ODYzOTIzNyJ9"
  }
}

Next Page using next_page_token parameter

When more videos are available, pagination.has_more is true and pagination.next_page_token holds the token for the following page. The token identifies the playlist, so it can be sent on its own. Each page numbers its videos from a position of 1, and the last page carries no pagination object.

GET
https://www.searchapi.io/api/v1/search?engine=tiktok_playlist&next_page_token=eyJjdXJzb3IiOiIyMCIsInBsYXlsaXN0X2lkIjoiNzM4MDA3MjgzNTYxMzg1NDUwNiJ9
Request
import requests

url = "https://www.searchapi.io/api/v1/search"
params = {
  "engine": "tiktok_playlist",
  "next_page_token": "eyJjdXJzb3IiOiIyMCIsInBsYXlsaXN0X2lkIjoiNzM4MDA3MjgzNTYxMzg1NDUwNiJ9"
}

response = requests.get(url, params=params)
print(response.text)
Response
{
  "search_metadata": {
    "id": "search_FiefCr0hm29AwPH9B1gYAAYb",
    "status": "Success",
    "created_at": "2026-10-01T02:25:37Z",
    "request_time_taken": 3.52,
    "parsing_time_taken": 0.02,
    "total_time_taken": 3.54,
    "request_url": "https://www.tiktok.com/explore",
    "html_url": "https://www.searchapi.io/api/v1/searches/search_uAOa1vIj5kOs1FB9J4IoL8Q1.html",
    "json_url": "https://www.searchapi.io/api/v1/searches/search_WMiJfkn2Y2Fzzje6WCUKFf1K"
  },
  "search_parameters": {
    "engine": "tiktok_playlist",
    "playlist_id": "7380072835613854506",
    "next_page_token": "eyJjdXJzb3IiOiIyMCIsInBsYXlsaXN0X2lkIjoiNzM4MDA3MjgzNTYxMzg1NDUwNiJ9"
  },
  "playlist": {
    "id": "7380072835613854506",
    "link": "https://www.tiktok.com/@nfl/playlist/playlist-7380072835613854506",
    "owner": {
      "id": "6634193109470593029",
      "username": "nfl",
      "link": "https://www.tiktok.com/@nfl",
      "name": "NFL",
      "bio": "football szn is the best szn 🏈",
      "avatar": "https://p19-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/7310653399928668206~tplv-tiktokx-cr...",
      "is_verified": true,
      "followers": 20900000,
      "following": 545,
      "hearts": 1800000000,
      "posts": 8091
    }
  },
  "videos": [
    {
      "position": 1,
      "id": "7527068007131057463",
      "link": "https://www.tiktok.com/@nfl/video/7527068007131057463",
      "type": "video",
      "caption": "#jordanchiles vs. the flag reaction test 👀 #flagfootball #nfl @jordanchiles",
      "language": "en",
      "hashtags": [
        "jordanchiles",
        "flagfootball",
        "nfl"
      ],
      "mentions": [
        "jordanchiles"
      ],
      "iso_date": "2025-07-14T22:28:42Z",
      "duration": 49,
      "width": 576,
      "height": 1024,
      "is_duet_enabled": true,
      "is_stitch_enabled": true,
      "views": 191300,
      "likes": 5207,
      "comments": 37,
      "shares": 36,
      "saves": 141,
      "thumbnail": "https://p19-common-sign.tiktokcdn-us.com/tos-useast5-p-0068-tx/o4vLy4XabAg9yOzBA0lDE1MhkEWBMHgiAIAAi...",
      "dynamic_thumbnail": "https://p16-common-sign.tiktokcdn-us.com/tos-useast5-p-0068-tx/o4vLy4XabAg9yOzBA0lDE1MhkEWBMHgiAIAAi...",
      "video_meta": {
        "definition": "540p",
        "ratio": "540p",
        "format": "mp4",
        "codec_type": "h264",
        "size": 9078081,
        "bitrate": 1462290,
        "bitrates": [
          {
            "gear_name": "normal_540_0",
            "bitrate": 1462290,
            "fps": 29,
            "codec_type": "h264",
            "format": "mp4"
          },
          "..."
        ]
      },
      "music": {
        "id": "7527068117457980173",
        "title": "original sound - NFL",
        "author": "NFL",
        "cover": "https://p16-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/7310653399928668206~tplv-tiktokx-cr...",
        "duration": 49,
        "play_url": "https://v19.tiktokcdn-us.com/b10dc62738881ca9644c2f5c8b21952d/6abe1934/video/tos/useast5/tos-useast5...",
        "is_original": true,
        "link": "https://www.tiktok.com/music/original-sound-nfl-7527068117457980173"
      },
      "subtitles": [
        {
          "language": "eng-US",
          "format": "webvtt",
          "source": "ASR",
          "url": "https://v16m-webapp.tiktokcdn-us.com/24aec06fd0c14100477c72bbac274b9c/6ac067d4/video/tos/useast5/tos...",
          "url_expires_at": "2026-10-03T02:26:28Z"
        },
        "..."
      ]
    },
    "..."
  ],
  "pagination": {
    "has_more": true,
    "next_page_token": "eyJjdXJzb3IiOiI0MCIsInBsYXlsaXN0X2lkIjoiNzM4MDA3MjgzNTYxMzg1NDUwNiJ9"
  }
}