TikTok

TikTok Playlist Videos

Get a playlist's videos in playlist order by playlist URL or numeric playlist ID. Returns the same fields as User Videos for each video, 30 per page. Supports fetching multiple pages in a single API call (billed per page).

Price: $0.006 per page. Free tier: 50 requests/month.

get/v1/tiktok/playlist/videos

Request

  • Base URL: https://apidirect.io
  • URL: https://apidirect.io/v1/tiktok/playlist/videos
  • Auth: API key in header X-API-Key

Query parameters

urlstring

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_idstring

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

pagesinteger

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

get_sentimentboolean

Set to true to add AI emotion analysis to each item. Adds a sentiment object containing emotions (joy, trust, fear, surprise, sadness, disgust, anger and anticipation, each scored 0-100), dominant_emotion, emotional_intensity (0-10), and polarity (positive, negative or neutral). Any item that cannot be scored returns sentiment: null.

Response

Successful response

playlist_idstring nullable
pagesnumber nullable
countnumber nullable

Changes

No recorded changes to this operation across all 1 revision of this API.