TikTok Playlist Details API

Endpoint

GET /v1/tiktok/playlist

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.

Response fields

playlist

Playlist data

playlist_id

Numeric playlist ID

name

Playlist name

video_count

Number of videos in the playlist

author

Creator's TikTok username

author_url

Link to the creator's profile

url

Link to the playlist

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"
  }
}

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.

How does pricing work?

You only pay for successful requests. The TikTok Playlist Details API costs $0.006 per request. 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.