TikTok Collection API Documentation
The TikTok Collection API returns the videos saved in a public TikTok collection, a folder of videos a
creator shares from their profile, together with the collection's name, cover, video count and owner.
Each video carries its author, caption, publish time, engagement counts and sound. Page through the
whole collection with pagination.next_page_token.
API Parameters
Collection
-
- Name
-
collection_id - Required
- Optional
- Description
-
The numeric ID of a public TikTok collection (e.g.
7394627756635573022), the trailing number of its page link. Returns the collection's name, cover, video count and owner, and its videos in the order the collection lists them. Required unlessurlornext_page_tokenis set.
-
- Name
-
url - Required
- Optional
- Description
-
The collection's page link, used instead of
collection_id(e.g.https://www.tiktok.com/@tiktok/collection/Summer-of-Sports-7394627756635573022). Pass eitherurlorcollection_id, not both.
Pagination
-
- Name
-
next_page_token - Required
- Optional
- Description
-
Token for the next page of up to 15 videos, returned as
pagination.next_page_tokenwhilepagination.has_moreistrue. The token carries the collection, socollection_idandurlcan be left out. A page can hold fewer than 15 videos when TikTok withholds some of them, so page untilpaginationis no longer returned.
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_collection.
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 collection block names the collection and its owner, and videos_count
is the number of videos TikTok counts in it. Each video is numbered by its position on
the page.
https://www.searchapi.io/api/v1/search?collection_id=7394627756635573022&engine=tiktok_collection
- 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_collection",
"collection_id": "7394627756635573022"
}
response = requests.get(url, params=params)
print(response.text)
{
"search_metadata": {
"id": "search_bsbS1Cph8XdGSBCl61GOfMTw",
"status": "Success",
"created_at": "2026-10-01T02:39:38Z",
"request_time_taken": 2.14,
"parsing_time_taken": 0.02,
"total_time_taken": 2.16,
"request_url": "https://www.tiktok.com/@tiktok/collection/Summer-of-Sports-7394627756635573022",
"html_url": "https://www.searchapi.io/api/v1/searches/search_bsbS1Cph8XdGSBCl61GOfMTw.html",
"json_url": "https://www.searchapi.io/api/v1/searches/search_bsbS1Cph8XdGSBCl61GOfMTw"
},
"search_parameters": {
"engine": "tiktok_collection",
"collection_id": "7394627756635573022"
},
"collection": {
"id": "7394627756635573022",
"name": "Summer of Sports",
"link": "https://www.tiktok.com/@tiktok/collection/Summer-of-Sports-7394627756635573022",
"cover": "https://p16-common-sign.tiktokcdn-us.com/tos-useast5-p-0068-tx/oYQIDWNuYCYeHwMTg8ffGkBAQLFT0YdJD7qAj...",
"videos_count": 139,
"owner": {
"id": "107955",
"username": "tiktok",
"link": "https://www.tiktok.com/@tiktok"
}
},
"videos": [
{
"position": 1,
"id": "7399631056783035690",
"link": "https://www.tiktok.com/@nojo18/video/7399631056783035690",
"type": "video",
"language": "un",
"iso_date": "2024-08-05T12:27:54Z",
"duration": 48,
"width": 768,
"height": 576,
"is_duet_enabled": true,
"is_stitch_enabled": true,
"views": 3300000,
"likes": 500800,
"comments": 3099,
"shares": 22600,
"saves": 39009,
"thumbnail": "https://p19-common-sign.tiktokcdn-us.com/tos-useast5-p-0068-tx/oYQIDWNuYCYeHwMTg8ffGkBAQLFT0YdJD7qAj...",
"dynamic_thumbnail": "https://p19-common-sign.tiktokcdn-us.com/tos-useast5-p-0068-tx/b10f3518bf2f42519e0b7e1e4069050f_1722...",
"video_meta": {
"definition": "540p",
"ratio": "540p",
"format": "mp4",
"codec_type": "h264",
"size": 7171166,
"bitrate": 1179662,
"bitrates": [
{
"gear_name": "normal_540_0",
"bitrate": 1179662,
"fps": 23,
"codec_type": "h264",
"format": "mp4"
},
"..."
]
},
"music": {
"id": "7399631020024285998",
"title": "original sound",
"author": "Noah Lyles",
"cover": "https://p19-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/16b25128fbffca038bc04db11c0fd800~tp...",
"duration": 48,
"play_url": "https://v16m.tiktokcdn-us.com/cbd33aa21bbeca1d4b91b1f3553ee902/6abe1c7b/video/tos/useast5/tos-useast...",
"is_original": true,
"is_copyrighted": true,
"link": "https://www.tiktok.com/music/original-sound-7399631020024285998"
},
"subtitles": [
{
"language": "eng-US",
"format": "webvtt",
"source": "ASR",
"url": "https://v16m-webapp.tiktokcdn-us.com/ae485a5f6a456b955d53747503200a02/6ac06b1b/video/tos/useast5/tos...",
"url_expires_at": "2026-10-03T02:40:27Z"
},
"..."
],
"author": {
"id": "6791598551904076805",
"sec_uid": "MS4wLjABAAAAH10iXqncdQ9WqgUozawE5UFvRGS_WuS7bqXNwCmYyURFVweqtROjIPuZOB6ctng1",
"username": "nojo18",
"link": "https://www.tiktok.com/@nojo18",
"name": "Noah Lyles",
"bio": "Official TikTok of Noah Lyles \nOlympian, World Champion, Adidas athletes",
"avatar": "https://p19-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/16b25128fbffca038bc04db11c0fd800~tp...",
"avatar_hd": "https://p19-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/16b25128fbffca038bc04db11c0fd800~tp...",
"is_verified": true,
"followers": 442600,
"following": 274,
"hearts": 4500000,
"posts": 63
}
},
"..."
],
"pagination": {
"has_more": true,
"next_page_token": "eyJjdXJzb3IiOiIxNSIsImNvbGxlY3Rpb25faWQiOiI3Mzk0NjI3NzU2NjM1NTczMDIyIn0="
}
}
Next Page using next_page_token parameter
Pass the previous page's pagination.next_page_token on its own to get the next page.
The last page returns no pagination block.
https://www.searchapi.io/api/v1/search?engine=tiktok_collection&next_page_token=eyJjdXJzb3IiOiIxNSIsImNvbGxlY3Rpb25faWQiOiI3Mzk0NjI3NzU2NjM1NTczMDIyIn0%3D
- 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_collection",
"next_page_token": "eyJjdXJzb3IiOiIxNSIsImNvbGxlY3Rpb25faWQiOiI3Mzk0NjI3NzU2NjM1NTczMDIyIn0="
}
response = requests.get(url, params=params)
print(response.text)
{
"search_metadata": {
"id": "search_X6qTcioOP5J6MB3cPUT41qLd",
"status": "Success",
"created_at": "2026-10-01T02:39:40Z",
"request_time_taken": 2.92,
"parsing_time_taken": 0.01,
"total_time_taken": 2.93,
"request_url": "https://www.tiktok.com/@tiktok/collection/Summer-of-Sports-7394627756635573022",
"html_url": "https://www.searchapi.io/api/v1/searches/search_X6qTcioOP5J6MB3cPUT41qLd.html",
"json_url": "https://www.searchapi.io/api/v1/searches/search_X6qTcioOP5J6MB3cPUT41qLd"
},
"search_parameters": {
"engine": "tiktok_collection",
"collection_id": "7394627756635573022",
"next_page_token": "eyJjdXJzb3IiOiIxNSIsImNvbGxlY3Rpb25faWQiOiI3Mzk0NjI3NzU2NjM1NTczMDIyIn0="
},
"videos": [
{
"position": 1,
"id": "7398123541402570015",
"link": "https://www.tiktok.com/@itsgabbythomas/video/7398123541402570015",
"type": "video",
"caption": "What we’ve all been waiting for 😃 @Alexis Holmes @ #fyp #olympics #paris2024 #track #running #usa ",
"language": "en",
"hashtags": [
"fyp",
"olympics",
"paris2024",
"track",
"running",
"usa"
],
"mentions": [
"trackqueenlex"
],
"iso_date": "2024-08-01T10:58:34Z",
"duration": 5,
"width": 576,
"height": 1024,
"is_duet_enabled": true,
"is_stitch_enabled": true,
"views": 877000,
"likes": 86400,
"comments": 371,
"shares": 812,
"saves": 1750,
"thumbnail": "https://p19-common-sign.tiktokcdn-us.com/tos-useast8-p-0068-tx2/197e374b3ea741ed9d71b919cbdcf872_172...",
"dynamic_thumbnail": "https://p19-common-sign.tiktokcdn-us.com/tos-useast8-p-0068-tx2/2ec6eae1f72b4563ae715732f375fef7_172...",
"video_meta": {
"definition": "540p",
"ratio": "540p",
"format": "mp4",
"codec_type": "h264",
"size": 1494162,
"bitrate": 2308923,
"bitrates": [
{
"gear_name": "normal_540_0",
"bitrate": 2308923,
"fps": 30,
"codec_type": "h264",
"format": "mp4"
},
"..."
]
},
"music": {
"id": "7237212440625253163",
"title": "original sound",
"author": "kardashianshulu",
"cover": "https://p16-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/b050d65942d0f6316e870607d5378cc4~tp...",
"duration": 30,
"play_url": "https://v16m.tiktokcdn-us.com/59b13eb6f23a22ea46c91c889263ba3c/6abe1c6c/video/tos/useast5/tos-useast...",
"is_original": true,
"link": "https://www.tiktok.com/music/original-sound-7237212440625253163"
},
"subtitles": [
{
"language": "eng-US",
"format": "webvtt",
"source": "ASR",
"url": "https://v16m-webapp.tiktokcdn-us.com/9556102cba637debf61de970c7bab9dd/6ac06af3/video/tos/useast8/tos...",
"url_expires_at": "2026-10-03T02:39:47Z"
},
"..."
],
"author": {
"id": "6728812859868693509",
"sec_uid": "MS4wLjABAAAAS4hBNOW02ZXlm98_JtheBmO5lVpWZoY4t9Nqz3ToPZb0A948HmOMHOg34L8U66XQ",
"username": "itsgabbythomas",
"link": "https://www.tiktok.com/@itsgabbythomas",
"name": "Gabby Thomas",
"bio": "🏃🏾♀️ 🤓",
"avatar": "https://p16-common-sign.tiktokcdn-us.com/tos-useast8-avt-0068-tx2/1cf585f28f97c4d32aab2577c73e0ad6~t...",
"avatar_hd": "https://p19-common-sign.tiktokcdn-us.com/tos-useast8-avt-0068-tx2/1cf585f28f97c4d32aab2577c73e0ad6~t...",
"is_verified": true,
"followers": 358200,
"following": 343,
"hearts": 11600000,
"posts": 579
}
},
"..."
],
"pagination": {
"has_more": true,
"next_page_token": "eyJjdXJzb3IiOiIzMCIsImNvbGxlY3Rpb25faWQiOiI3Mzk0NjI3NzU2NjM1NTczMDIyIn0="
}
}