TikTok Playlist Details

GET /v1/tiktok/playlist

Try in Playground Documentation

Get a playlist's details by playlist URL or numeric playlist ID. Returns its name, creator, and video count.

Cost

$0.006 per request

Free tier

50 requests/month

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.

Example Request

curl "https://apidirect.io/v1/tiktok/playlist?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",
    headers={"X-API-Key": "YOUR_API_KEY"},
    params={"url": "https://www.tiktok.com/@natgeo/playlist/Cinematic-7509464647364283178"}
)
print(response.json())

Example Response

{
  "playlist": {
    "playlist_id": "7509464647364283178",
    "name": "Cinematic",
    "video_count": 27,
    "author": "natgeo",
    "author_url": "https://www.tiktok.com/@natgeo",
    "url": "https://www.tiktok.com/@natgeo/playlist/Cinematic-7509464647364283178"
  }
}

Your Usage

Free tier this month

Recent Activity