TikTok Playlist Videos API

Endpoint

GET /v1/tiktok/playlist/videos

Parameters

url

TikTok playlist URL, e.g. https://www.tiktok.com/@natgeo/playlist/Cinematic-7509464647364283178 (max 500 characters). Provide exactly one of url or playlist_id.

playlist_id

Numeric playlist ID: the number at the end of a playlist URL. Provide exactly one of url or playlist_id.

pages

Number of pages to fetch, 1-1000 (default: 1). Each page returns up to 30 videos.

get_sentiment

Set to true to add AI emotion analysis (+$0.001/page)

Response fields

videos

Array of the playlist's videos in playlist order

video_id

Numeric video ID

title

Video caption

url

Direct link to the video

date

Publication date and time

date_timestamp

Publication date as a Unix timestamp

author

Author's TikTok username

source

"TikTok"

domain

"tiktok.com"

snippet

Video caption text

region

2-letter region code the video was posted from

play_count

Number of plays/views

likes

Number of likes

comments

Number of comments

Number of shares

downloads

Number of downloads

saves

Number of saves (favorites)

duration

Video duration in seconds (0 for photo posts)

is_ad

Whether the video is an ad

is_pinned

Whether the video is pinned to the author's profile

author_name

Author's display name

author_id

Author's numeric user ID

author_avatar

Author's avatar URL

author_url

Link to the author's profile

cover

Video cover/thumbnail URL

dynamic_cover

Animated cover URL

origin_cover

Original cover frame URL

video_url

Watermark-free playback/download URL (temporary)

video_url_watermarked

Watermarked playback URL (temporary)

size

File size of the watermark-free video in bytes

size_watermarked

File size of the watermarked video in bytes

images

Image URLs for photo posts; empty for videos

music_url

Playback URL of the sound

mentioned_user_ids

Numeric IDs of the users mentioned in the caption

sentiment

Emotion analysis: emotions, dominant_emotion, emotional_intensity, polarity (when get_sentiment=true)

playlist_id

The playlist's numeric ID

pages

Number of pages returned

count

Number of results returned

Example Request

curl "https://apidirect.io/v1/tiktok/playlist/videos?url=https://www.tiktok.com/@natgeo/playlist/Cinematic-7509464647364283178"   -H "X-API-Key: YOUR_API_KEY"

import requests

response = requests.get(
    "https://apidirect.io/v1/tiktok/playlist/videos",
    headers={"X-API-Key": "YOUR_API_KEY"},
    params={"url": "https://www.tiktok.com/@natgeo/playlist/Cinematic-7509464647364283178"}
)
print(response.json())

Example Response

{
  "videos": [
    {
      "video_id": "7509066418168597791",
      "title": "Spring in Patagonia is a time of abundance, and this puma mother has cubs to feed",
      "url": "https://www.tiktok.com/@natgeo/video/7509066418168597791",
      "date": "2025-05-27 10:14:17",
      "date_timestamp": 1748340857,
      "author": "natgeo",
      "source": "TikTok",
      "domain": "tiktok.com",
      "snippet": "Spring in Patagonia is a time of abundance, and this puma mother has cubs to feed",
      "region": "GB",
      "play_count": 31112,
      "likes": 1268,
      "comments": 31,
      "shares": 44,
      "downloads": 1,
      "saves": 51,
      "duration": 20,
      "is_ad": false,
      "is_pinned": false,
      "author_name": "National Geographic",
      "author_id": "6780344874811442181",
      "author_avatar": "https://p16-common-sign.tiktokcdn-eu.com/.../avatar.jpeg",
      "author_url": "https://www.tiktok.com/@natgeo",
      "cover": "https://p16-common-sign.tiktokcdn-eu.com/.../cover.jpeg",
      "dynamic_cover": "https://p16-common-sign.tiktokcdn-eu.com/.../dynamic_cover.webp",
      "origin_cover": "https://p16-common-sign.tiktokcdn-eu.com/.../origin_cover.jpeg",
      "video_url": "https://v19.tiktokcdn-eu.com/.../video.mp4",
      "video_url_watermarked": "https://v19.tiktokcdn-eu.com/.../video_wm.mp4",
      "size": 3008834,
      "size_watermarked": 0,
      "images": [],
      "music_url": "https://sf16-music.tiktokcdn-eu.com/.../music.mp3",
      "mentioned_user_ids": [
        "6763618106315375621"
      ]
    }
  ],
  "playlist_id": "7509464647364283178",
  "pages": 1,
  "count": 27
}

Frequently asked questions

Where do I find a playlist URL?

On a creator's profile, the Playlists tab links to each playlist. The URL ends in the numeric playlist ID, which you can also pass as playlist_id.

Why are the music fields empty?

TikTok does not include the sound's metadata on playlist lists. Video Details returns it for a single video.

How does pricing work?

You only pay for successful requests. The TikTok Playlist Videos API costs $0.006 per page. There are no monthly fees or commitments. You get 50 free requests per endpoint every month.

Do I need a credit card to start?

No. You can sign up and use the free tier (50 requests/endpoint/month) without adding a payment method. You only need to add a card when you want to exceed the free tier.

Are there rate limits?

Yes, there's a concurrency limit of 10 simultaneous requests per endpoint per user. If you need more, just get in touch.