TikTok Playlist API Documentation
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.
Eitherurlorplaylist_idis 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.
Eitherurlorplaylist_idis 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_tokenwhen more videos are available. The token identifies the playlist, sourlandplaylist_idcan 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_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
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.
https://www.searchapi.io/api/v1/search?engine=tiktok_playlist&url=https%3A%2F%2Fwww.tiktok.com%2F%40tiktok%2Fplaylist%2FIn-The-Mix-7516638364301265695
- 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_playlist",
"url": "https://www.tiktok.com/@tiktok/playlist/In-The-Mix-7516638364301265695"
}
response = requests.get(url, params=params)
print(response.text)
{
"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.
https://www.searchapi.io/api/v1/search?engine=tiktok_playlist&playlist_id=6954279265768639237
- 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_playlist",
"playlist_id": "6954279265768639237"
}
response = requests.get(url, params=params)
print(response.text)
{
"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.
https://www.searchapi.io/api/v1/search?engine=tiktok_playlist&next_page_token=eyJjdXJzb3IiOiIyMCIsInBsYXlsaXN0X2lkIjoiNzM4MDA3MjgzNTYxMzg1NDUwNiJ9
- 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_playlist",
"next_page_token": "eyJjdXJzb3IiOiIyMCIsInBsYXlsaXN0X2lkIjoiNzM4MDA3MjgzNTYxMzg1NDUwNiJ9"
}
response = requests.get(url, params=params)
print(response.text)
{
"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"
}
}