Search APIs
Loading…
← API Store
Social

TikTok

TikTok

TikTok playlist / collection videos

GET /tiktok/v1/collection/videos
Test this endpoint

Every 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

NameTypeDescription
urlrequiredstring Example: https://www.tiktok.com/@nba/playlist/Playoffs-7499302679324936990
cursorstringValue 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
$.cachedboolean
$.collection_idstring
$.countinteger
$.credits_usedinteger
$.next_cursorstring
$.videosarray
$.videos[]object | string
$.videos[].ai_generatednull
$.videos[].authorobject
$.videos[].author.avatarstring
$.videos[].author.idstring
$.videos[].author.nicknamestring
$.videos[].author.usernamestring
$.videos[].author.verifiedboolean
$.videos[].author_infoobject
$.videos[].author_info.avatar_mediumstring
$.videos[].author_info.avatar_thumbstring
$.videos[].author_info.privateboolean
$.videos[].author_info.sec_uidstring
$.videos[].author_info.signaturestring
$.videos[].author_info.urlstring
$.videos[].author_statsobject
$.videos[].author_stats.diggCountstring
$.videos[].author_stats.followerCountstring
$.videos[].author_stats.followingCountstring
$.videos[].author_stats.friendCountstring
$.videos[].author_stats.heartstring
$.videos[].author_stats.heartCountstring
$.videos[].author_stats.videoCountstring
$.videos[].challengesarray
$.videos[].challenges[]object | string
$.videos[].challenges[].descstring
$.videos[].challenges[].idstring
$.videos[].challenges[].titlestring
$.videos[].coverstring
$.videos[].create_timestring
$.videos[].create_time_unixinteger
$.videos[].descstring
$.videos[].diversification_labelsnull
$.videos[].duet_enabledboolean
$.videos[].durationinteger
$.videos[].hashtagsarray
$.videos[].hashtags[]string
$.videos[].idstring
$.videos[].imagesarray
$.videos[].is_adboolean
$.videos[].location_creatednull
$.videos[].mentionsarray
$.videos[].musicobject
$.videos[].music.authorstring
$.videos[].music.idstring
$.videos[].music.titlestring
$.videos[].music_infoobject
$.videos[].music_info.albumnull
$.videos[].music_info.coverstring
$.videos[].music_info.durationinteger
$.videos[].music_info.originalboolean
$.videos[].music_info.play_urlstring
$.videos[].pinnednull
$.videos[].poinull
$.videos[].private_itemboolean
$.videos[].share_enabledboolean
$.videos[].statsobject
$.videos[].stats.collectCountstring
$.videos[].stats.commentCountstring
$.videos[].stats.diggCountstring
$.videos[].stats.playCountstring
$.videos[].stats.repostCountstring
$.videos[].stats.shareCountstring
$.videos[].stitch_enabledboolean
$.videos[].suggested_wordsnull
$.videos[].urlstring
$.videos[].videoobject
$.videos[].video.bitrateinteger
$.videos[].video.bitratesarray
$.videos[].video.bitrates[]object | string
$.videos[].video.bitrates[].…string
$.videos[].video.codecstring
$.videos[].video.coverstring
$.videos[].video.definitionstring
$.videos[].video.download_urlstring
$.videos[].video.dynamic_coverstring
$.videos[].video.formatstring
$.videos[].video.heightinteger
$.videos[].video.origin_coverstring
$.videos[].video.play_urlstring
$.videos[].video.qualitystring
$.videos[].video.ratiostring
$.videos[].video.sizeinteger
$.videos[].video.subtitlesarray
$.videos[].video.widthinteger