← API Store
Social
TikTok
TikTok
TikTok playlist / collection videos
GET /tiktok/v1/collection/videosEvery response includes credits_used: the credits this call cost.
Each call costs 1 credits; failed calls are free. Run it in the console playground to see a live result.
Parameters
| Name | Type | Description |
|---|---|---|
urlrequired | string | Example: https://www.tiktok.com/@nba/playlist/Playoffs-7499302679324936990 |
cursor | string | Value of `next_cursor` from the previous page. |
Every endpoint also takes: raw、fields、fresh、output、records
{
"cached": false,
"collection_id": "7499302679324936990",
"count": 20,
"credits_used": 1,
"next_cursor": "20",
"videos": [
{
"ai_generated": null,
"author": {
"avatar": "https://p19-common-sign.tiktokcdn-us.com/tos-useast8-avt-0068-tx2/8beb8b849e725f2776a11575b1e7aebf~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr…",
"id": "134941634731003904",
"nickname": "NBA",
"username": "nba",
"verified": true
},
"author_info": {
"avatar_medium": "https://p19-common-sign.tiktokcdn-us.com/tos-useast8-avt-0068-tx2/8beb8b849e725f2776a11575b1e7aebf~tplv-tiktokx-cropcenter:720:720.jpeg?dr=9…",
"avatar_thumb": "https://p19-common-sign.tiktokcdn-us.com/tos-useast8-avt-0068-tx2/8beb8b849e725f2776a11575b1e7aebf~tplv-tiktokx-cropcenter:100:100.jpeg?dr=9…",
"private": false,
"sec_uid": "MS4wLjABAAAAsny0dcfyctb1_fdyyiu7JOLnblf8y3jd64yTHQLQoc9O5m57HhjT94OdgfSmNgaG",
"signature": "The 2026-27 NBA season continues FRIDAY on Prime!\n🏀 7:00pm/et: Knicks/Celtics\n🏀 9:30pm/et: Rockets/Spurs",
"url": "https://www.tiktok.com/@nba"
},
"author_stats": {
"diggCount": "14900",
"followerCount": "27300000",
"followingCount": "268",
"friendCount": "0",
"heart": "1200000000",
"heartCount": "1200000000",
"videoCount": "24600"
},
"challenges": [
{
"desc": "The 2026-27 NBA season is officially here, so practice your form, pull on a jersey, and get ready to celebrate the best in the #NBA.",
"id": "12744",
"title": "NBA"
},
{
"desc": "Congrats ... you’re in the #NBAPlayoffs! Grab your friends and use the NBA Playoffs filter to show how you’re feeling about your chance at t…",
"id": "25322",
"title": "nbaplayoffs"
},
"… 3 more"
],
"cover": "https://p19-common-sign.tiktokcdn-us.com/tos-useast8-p-0068-tx2/oEieEPfDVEhcR8oE5Y6uAEXGQChAqEIAFAAYIA~tplv-tiktokx-dmt-logom:tos-useast8-i-…",
"create_time": "2025-04-29T05:22:33.000Z",
"create_time_unix": 1745904153,
"desc": "Draymond + Steph feeling good after the dub! ⭐️ #NBA #NBAPlayoffs #basketball #StephCurry #Warriors ",
"diversification_labels": null,
"duet_enabled": true,
"duration": 11,
"hashtags": [
"nba",
"nbaplayoffs",
"… 3 more"
],
"id": "7498601171280514335",
"images": [],
"is_ad": true,
"location_created": null,
"mentions": [],
"music": {
"author": "NBA",
"id": "7498601014195473182",
"title": "original sound"
},
"music_info": {
"album": null,
"cover": "https://p19-common-sign.tiktokcdn-us.com/tos-useast8-avt-0068-tx2/8beb8b849e725f2776a11575b1e7aebf~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr…",
"duration": 11,
"original": true,
"play_url": "https://v16m.tiktokcdn-us.com/4af2ca93dbdea0b50fb6012527c1f3af/6adc0df4/video/tos/useast8/tos-useast8-v-27dcd7-tx2/oEB2AizAEEYCMiQKRqmfAXuhw…"
},
"pinned": null,
"poi": null,
"private_item": false,
"share_enabled": true,
"stats": {
"collectCount": "3604",
"commentCount": "386",
"diggCount": "91000",
"playCount": "689900",
"repostCount": "0",
"shareCount": "1368"
},
"stitch_enabled": true,
"suggested_words": null,
"url": "https://www.tiktok.com/@nba/video/7498601171280514335",
"video": {
"bitrate": 1446423,
"bitrates": [
{
"…": "8 fields"
},
{
"…": "8 fields"
},
"… 2 more"
],
"codec": "h264",
"cover": "https://p19-common-sign.tiktokcdn-us.com/tos-useast8-p-0068-tx2/oEieEPfDVEhcR8oE5Y6uAEXGQChAqEIAFAAYIA~tplv-tiktokx-dmt-logom:tos-useast8-i-…",
"definition": "540p",
"download_url": "https://v16-webapp-prime.us.tiktok.com/video/tos/useast8/tos-useast8-ve-0068c001-tx2/o8LiFCASIYIqwECKLf10QEDq0iCYsBFaCQiAAi/?a=1988&bti=ODsz…",
"dynamic_cover": "https://p16-common-sign.tiktokcdn-us.com/tos-useast8-p-0068-tx2/oEieEPfDVEhcR8oE5Y6uAEXGQChAqEIAFAAYIA~tplv-tiktokx-origin.image?dr=9636&x-e…",
"format": "mp4",
"height": 1024,
"origin_cover": "https://p16-common-sign.tiktokcdn-us.com/tos-useast8-p-0068-tx2/oABoAYWEhFMSpEGCQoEDrhfKQeooAIUZEVQVkR~tplv-tiktokx-origin.image?dr=9636&x-e…",
"play_url": "https://v16-webapp-prime.us.tiktok.com/video/tos/useast8/tos-useast8-ve-0068c003-tx2/o4fUgeVAEgBEAkAprIDWVoIDEQEIoxRAGFKEAZ/?a=1988&bti=ODsz…",
"quality": "normal",
"ratio": "540p",
"size": 2097314,
"subtitles": [],
"width": 576
}
},
{
"ai_generated": null,
"author": {
"avatar": "https://p19-common-sign.tiktokcdn-us.com/tos-useast8-avt-0068-tx2/8beb8b849e725f2776a11575b1e7aebf~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr…",
"id": "134941634731003904",
"nickname": "NBA",
"username": "nba",
"verified": true
},
"author_info": {
"avatar_medium": "https://p19-common-sign.tiktokcdn-us.com/tos-useast8-avt-0068-tx2/8beb8b849e725f2776a11575b1e7aebf~tplv-tiktokx-cropcenter:720:720.jpeg?dr=9…",
"avatar_thumb": "https://p19-common-sign.tiktokcdn-us.com/tos-useast8-avt-0068-tx2/8beb8b849e725f2776a11575b1e7aebf~tplv-tiktokx-cropcenter:100:100.jpeg?dr=9…",
"private": false,
"sec_uid": "MS4wLjABAAAAsny0dcfyctb1_fdyyiu7JOLnblf8y3jd64yTHQLQoc9O5m57HhjT94OdgfSmNgaG",
"signature": "The 2026-27 NBA season continues FRIDAY on Prime!\n🏀 7:00pm/et: Knicks/Celtics\n🏀 9:30pm/et: Rockets/Spurs",
"url": "https://www.tiktok.com/@nba"
},
"author_stats": {
"diggCount": "14900",
"followerCount": "27300000",
"followingCount": "268",
"friendCount": "0",
"heart": "1200000000",
"heartCount": "1200000000",
"videoCount": "24600"
},
"challenges": [
{
"desc": "The 2026-27 NBA season is officially here, so practice your form, pull on a jersey, and get ready to celebrate the best in the #NBA.",
"id": "12744",
"title": "NBA"
},
{
"desc": "Congrats ... you’re in the #NBAPlayoffs! Grab your friends and use the NBA Playoffs filter to show how you’re feeling about your chance at t…",
"id": "25322",
"title": "nbaplayoffs"
},
"… 2 more"
],
"cover": "https://p16-common-sign.tiktokcdn-us.com/tos-useast8-p-0068-tx2/osZ9VFPEEQAIA2E0DgfPkALARA8YoDVREAe5CQ~tplv-tiktokx-dmt-logom:tos-useast8-i-…",
"create_time": "2025-04-29T02:05:00.000Z",
"create_time_unix": 1745892300,
"desc": "Yeah it’s gonna be one of those nights 🤩 #NBA #NBAPlayoffs #basketball #StephCurry ",
"diversification_labels": null,
"duet_enabled": true,
"duration": 59,
"hashtags": [
"nba",
"nbaplayoffs",
"… 2 more"
],
"id": "7498550281232256287",
"images": [],
"is_ad": true,
"location_created": null,
"mentions": [],
"music": {
"author": "NBA",
"id": "7498550262979332894",
"title": "original sound"
},
"music_info": {
"album": null,
"cover": "https://p19-common-sign.tiktokcdn-us.com/tos-useast8-avt-0068-tx2/8beb8b849e725f2776a11575b1e7aebf~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr…",
"duration": 59,
"original": true,
"play_url": "https://v16m.tiktokcdn-us.com/6c31fb451f4b08e947ae2a480655e4cf/6adc0e24/video/tos/useast8/tos-useast8-v-27dcd7-tx2/oAAEoPoCAZJvEP0UFDCA5IIDg…"
},
"pinned": null,
"poi": null,
"private_item": false,
"share_enabled": true,
"stats": {
"collectCount": "540",
"commentCount": "56",
"diggCount": "10600",
"playCount": "223800",
"repostCount": "0",
"shareCount": "225"
},
"stitch_enabled": true,
"suggested_words": null,
"url": "https://www.tiktok.com/@nba/video/7498550281232256287",
"video": {
"bitrate": 1225519,
"bitrates": [
{
"…": "8 fields"
},
{
"…": "8 fields"
},
"… 2 more"
],
"codec": "h264",
"cover": "https://p16-common-sign.tiktokcdn-us.com/tos-useast8-p-0068-tx2/osZ9VFPEEQAIA2E0DgfPkALARA8YoDVREAe5CQ~tplv-tiktokx-dmt-logom:tos-useast8-i-…",
"definition": "540p",
"download_url": "https://v16-webapp-prime.us.tiktok.com/video/tos/useast8/tos-useast8-ve-0068c004-tx2/oEPEALCITTBMiO0MJiBUCriJQB89fpA5IQAmMq/?a=1988&bti=ODsz…",
"dynamic_cover": "https://p19-common-sign.tiktokcdn-us.com/tos-useast8-p-0068-tx2/osZ9VFPEEQAIA2E0DgfPkALARA8YoDVREAe5CQ~tplv-tiktokx-origin.image?dr=9636&x-e…",
"format": "mp4",
"height": 1024,
"origin_cover": "https://p16-common-sign.tiktokcdn-us.com/tos-useast8-p-0068-tx2/oISMZGfMGQY5YgxZAfLDqFjTyCe3QoIQIaAlII~tplv-tiktokx-origin.image?dr=9636&x-e…",
"play_url": "https://v16-webapp-prime.us.tiktok.com/video/tos/useast8/tos-useast8-pve-0068-tx2/oEIAYCIGeyGRjIAyZMbfLCgIexqgwQIIZMQTlr/?a=1988&bti=ODszNWY…",
"quality": "normal",
"ratio": "540p",
"size": 9140386,
"subtitles": [],
"width": 576
}
},
"… 18 more"
]
} Response fields (92)
Field paths and types observed in the sample response; the live response is authoritative.
$ | object |
$.cached | boolean |
$.collection_id | string |
$.count | integer |
$.credits_used | integer |
$.next_cursor | string |
$.videos | array |
$.videos[] | object | string |
$.videos[].ai_generated | null |
$.videos[].author | object |
$.videos[].author.avatar | string |
$.videos[].author.id | string |
$.videos[].author.nickname | string |
$.videos[].author.username | string |
$.videos[].author.verified | boolean |
$.videos[].author_info | object |
$.videos[].author_info.avatar_medium | string |
$.videos[].author_info.avatar_thumb | string |
$.videos[].author_info.private | boolean |
$.videos[].author_info.sec_uid | string |
$.videos[].author_info.signature | string |
$.videos[].author_info.url | string |
$.videos[].author_stats | object |
$.videos[].author_stats.diggCount | string |
$.videos[].author_stats.followerCount | string |
$.videos[].author_stats.followingCount | string |
$.videos[].author_stats.friendCount | string |
$.videos[].author_stats.heart | string |
$.videos[].author_stats.heartCount | string |
$.videos[].author_stats.videoCount | string |
$.videos[].challenges | array |
$.videos[].challenges[] | object | string |
$.videos[].challenges[].desc | string |
$.videos[].challenges[].id | string |
$.videos[].challenges[].title | string |
$.videos[].cover | string |
$.videos[].create_time | string |
$.videos[].create_time_unix | integer |
$.videos[].desc | string |
$.videos[].diversification_labels | null |
$.videos[].duet_enabled | boolean |
$.videos[].duration | integer |
$.videos[].hashtags | array |
$.videos[].hashtags[] | string |
$.videos[].id | string |
$.videos[].images | array |
$.videos[].is_ad | boolean |
$.videos[].location_created | null |
$.videos[].mentions | array |
$.videos[].music | object |
$.videos[].music.author | string |
$.videos[].music.id | string |
$.videos[].music.title | string |
$.videos[].music_info | object |
$.videos[].music_info.album | null |
$.videos[].music_info.cover | string |
$.videos[].music_info.duration | integer |
$.videos[].music_info.original | boolean |
$.videos[].music_info.play_url | string |
$.videos[].pinned | null |
$.videos[].poi | null |
$.videos[].private_item | boolean |
$.videos[].share_enabled | boolean |
$.videos[].stats | object |
$.videos[].stats.collectCount | string |
$.videos[].stats.commentCount | string |
$.videos[].stats.diggCount | string |
$.videos[].stats.playCount | string |
$.videos[].stats.repostCount | string |
$.videos[].stats.shareCount | string |
$.videos[].stitch_enabled | boolean |
$.videos[].suggested_words | null |
$.videos[].url | string |
$.videos[].video | object |
$.videos[].video.bitrate | integer |
$.videos[].video.bitrates | array |
$.videos[].video.bitrates[] | object | string |
$.videos[].video.bitrates[].… | string |
$.videos[].video.codec | string |
$.videos[].video.cover | string |
$.videos[].video.definition | string |
$.videos[].video.download_url | string |
$.videos[].video.dynamic_cover | string |
$.videos[].video.format | string |
$.videos[].video.height | integer |
$.videos[].video.origin_cover | string |
$.videos[].video.play_url | string |
$.videos[].video.quality | string |
$.videos[].video.ratio | string |
$.videos[].video.size | integer |
$.videos[].video.subtitles | array |
$.videos[].video.width | integer |