TikTok Playlist Videos API

List the posts in a TikTok creator playlist by playlist ID, in playlist order. Page through results with the `cursor` from the previous response's `nextCursor`.

Endpoint: POST /tiktok/get-playlist-videos
Price: 1 credit per result
SDK: client.tiktok.getPlaylistVideos()
MCP tool: tiktok_get_playlist_videos

Start free with 100 credits Read docs →

Terminal

$curl -X POST "https://api.bridgly.app/tiktok/get-playlist-videos" \
  -H "Authorization: Bearer $BRIDGLY_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "playlistId": "7516638364301265695",
  "count": 10
}'

request.py

import os
import requests
response = requests.post(
    "https://api.bridgly.app/tiktok/get-playlist-videos",
    headers={"Authorization": f"Bearer {os.environ['BRIDGLY_KEY']}"},
    json={
        "playlistId": "7516638364301265695",
        "count": 10,
    },
)
data = response.json()

request.js

const response = await fetch("https://api.bridgly.app/tiktok/get-playlist-videos", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.BRIDGLY_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "playlistId": "7516638364301265695",
    "count": 10
  }),
});
const data = await response.json();

request.ts

import { Bridgly } from "@bridgly/sdk";
const client = new Bridgly({ apiKey: "bgly_YOUR_KEY" });
const res = await client.tiktok.getPlaylistVideos({
  playlistId: "7516638364301265695",
  count: 10
});
if (res.type === "success") {
  console.log(res.data);
}

[ REQUEST AND RESPONSE ]

What does the TikTok Playlist Videos API return?

TikTok playlist videos API: list the posts in a TikTok creator playlist by playlist ID, with caption, views, likes, comments, sound and hashtags, as JSON. Every response has the same envelope: the result in data, plus timeMs and the creditsCost of the call.

Request body

cursorstring: The previous response's `nextCursor`, to fetch the next page. Omit it for the first page.
playlistIdstringrequired: Playlist ID, as returned by `getUserPlaylists`, or the playlist URL.
countinteger · 1–20 · default 20: Number of results to return (1–20). Defaults to 20.

Example response

200 OK · application/json

{
  "timeMs": 1840,
  "creditsCost": 1,
  "data": {
    "nextCursor": "string",
    "videos": [
      {
        "id": "string",
        "url": "string",
        "description": "string",
        "createTime": 0,
        "language": "string",
        "duration": 0,
        "width": 0,
        "height": 0,
        "coverUrl": "string",
        "animatedCoverUrl": "string",
        "images": [
          "string"
        ],
        "subtitles": [
          {
            "language": "string",
            "format": "string",
            "autoGenerated": true,
            "url": "string"
          }
        ],
        "stats": {
          "playCount": 0,
          "likeCount": 0,
          "commentCount": 0,
          "shareCount": 0,
          "saveCount": 0,
          "repostCount": 0
        },
        "author": {
          "id": "string",
          "uniqueId": "string",
          "nickname": "string",
          "avatarUrl": "string",
          "signature": "string",
          "verified": true,
          "secUid": "string",
          "privateAccount": true,
          "followerCount": 0,
          "followingCount": 0,
          "heartCount": 0,
          "videoCount": 0
        },
        "sound": {
          "id": "string",
          "title": "string",
          "authorName": "string",
          "original": true,
          "duration": 0,
          "coverUrl": "string",
          "playUrl": "string",
          "album": "string",
          "copyrighted": true,
          "videoCount": 0
        },
        "hashtags": [
          "string"
        ],
        "mentions": [
          "string"
        ],
        "location": {
          "id": "string",
          "name": "string",
          "address": "string",
          "city": "string",
          "category": "string"
        },
        "playlistId": "string",
        "isAd": true,
        "duetEnabled": true,
        "stitchEnabled": true
      }
    ]
  }
}

[ USE CASES ]

What can you build with the TikTok Playlist Videos API?

Follow a series

Get every episode of a creator’s playlist in order.

Compare episodes

See which parts of a series got the most views.

Collect content

Gather captions and covers of a themed collection.

[ FAQ ]

TikTok Playlist Videos API questions

Where do I find a TikTok playlist ID?

Call the playlists endpoint with the creator’s username; each playlist comes back with its id. Posts that belong to a playlist also carry it in playlistId.

How can I build a catalogue of a creator’s series?

First discover collections with the Playlists API. Store each playlist ID and name, then fetch its posts with this endpoint. Keep the playlist ID beside each video ID so the catalogue preserves the collection a post came from, rather than flattening every series into one feed.

How do I use the TikTok Playlist Videos API?

Send a POST request to https://api.bridgly.app/tiktok/get-playlist-videos with playlistId in the JSON body and your API key in the Authorization header. In the TypeScript SDK, call client.tiktok.getPlaylistVideos(). AI agents connected to Bridgly over MCP can call the tiktok_get_playlist_videos tool.

How much does the TikTok Playlist Videos API cost?

Costs 1 credit per result returned, with a minimum of 1 credit per request. Credits cost $2.00 per 1,000 on pay-as-you-go and as low as $1.00 per 1,000 at volume. New accounts on a business email start with 100 free credits, and failed requests are never charged.

[ MORE ENDPOINTS ]

More TikTok endpoints

The same API key works on every endpoint. See all TikTok API endpoints.

Try the TikTok Playlist Videos API

100 free credits on business email, no card. Your first call takes a minute.

APIMCPSDKCLI

free credits

On business email signup. No credit card required.

Start free with 100 credits

Book a demo Read the docs