TikTok Video Details API

Endpoint

GET /v1/tiktok/video

Parameters

url

TikTok video URL, e.g. https://www.tiktok.com/@tiktok/video/7516594811734854943 (max 500 characters). Provide exactly one of url or video_id.

video_id

Numeric TikTok video ID, as returned by Search Videos. Provide exactly one of url or video_id.

Response fields

video

Video data object

video_id

TikTok video ID

url

Link to the video

title

Video caption

region

2-letter region code the video was posted from

date

Date and time the video was published

date_timestamp

Unix timestamp of the publish date, or null

duration

Video length in seconds

play_count

Number of plays

likes

Number of likes

comments

Number of comments

Number of shares

downloads

Number of downloads

saves

Number of times the video was saved / favorited

is_ad

Whether the video is a paid ad

cover

URL to the video cover image

dynamic_cover

URL to the animated cover image

origin_cover

URL to the original still cover frame

video_url

Watermark-free MP4 URL (temporary signed link)

video_url_hd

Original-quality MP4 URL (temporary signed link), or empty string

video_url_watermarked

Watermarked MP4 URL (temporary signed link)

size

File size of the watermark-free MP4 in bytes

size_hd

File size of the original-quality MP4 in bytes

size_watermarked

File size of the watermarked MP4 in bytes

author

Author's TikTok username

author_name

Author's display name

author_id

Author's TikTok user ID

author_avatar

URL to the author's profile picture

author_url

Link to the author's profile

music_id

TikTok ID of the music track

music_title

Music track title

music_author

Music track artist / creator

music_url

MP3 URL for the music track (temporary signed link)

music_cover

URL to the music track's cover image

music_album

Album name, or empty string

music_original

Whether the track is an original sound

music_duration

Music track length in seconds

mentioned_user_ids

User IDs of accounts mentioned in the caption

Example Request

curl "https://apidirect.io/v1/tiktok/video?url=https://www.tiktok.com/@tiktok/video/7516594811734854943" \
  -H "X-API-Key: YOUR_API_KEY"

import requests

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

Example Response

{
  "video": {
    "video_id": "7516594811734854943",
    "url": "https://www.tiktok.com/@tiktok/video/7516594811734854943",
    "title": "🌈🐬🦄 life after @Zara Larsson Symphony vocals 🌈🐬🦄",
    "region": "US",
    "date": "2025-06-16 17:07:10",
    "date_timestamp": 1750093630,
    "duration": 66,
    "play_count": 18912653,
    "likes": 879920,
    "comments": 4382,
    "shares": 17420,
    "downloads": 1003,
    "saves": 38685,
    "is_ad": true,
    "cover": "https://p16-common-sign.tiktokcdn-us.com/.../cover.jpeg",
    "dynamic_cover": "https://p16-common-sign.tiktokcdn-us.com/.../dynamic.image",
    "origin_cover": "https://p16-common-sign.tiktokcdn-us.com/.../origin.webp",
    "video_url": "https://v16m.tiktokcdn-us.com/.../video.mp4",
    "video_url_hd": "https://v16.tokcdn.com/.../7516594811734854943_original.mp4",
    "video_url_watermarked": "https://v16m.tiktokcdn-us.com/.../video_wm.mp4",
    "size": 7786703,
    "size_hd": 38711004,
    "size_watermarked": 7988034,
    "author": "tiktok",
    "author_name": "TikTok",
    "author_id": "107955",
    "author_avatar": "https://p19-common-sign.tiktokcdn-us.com/.../avatar.jpeg",
    "author_url": "https://www.tiktok.com/@tiktok",
    "music_id": "7516599978421209887",
    "music_title": "original sound - tiktok",
    "music_author": "TikTok",
    "music_url": "https://v16-ies-music.tiktokcdn-us.com/.../audio.mp3",
    "music_cover": "https://p16-common-sign.tiktokcdn-us.com/.../music.jpeg",
    "music_album": "",
    "music_original": true,
    "music_duration": 66,
    "mentioned_user_ids": ["205879097384816641"]
  }
}

Frequently asked questions

Can I look up a video by ID instead of URL?

Yes. Provide exactly one of url (the full video URL) or video_id (the numeric ID, e.g. 7516594811734854943). Video IDs are returned by the Search Videos endpoint.

Are the video download URLs permanent?

No. video_url, video_url_hd, video_url_watermarked, and music_url are temporary signed CDN links that expire after a few hours. Request the video again whenever you need fresh links.

What's the difference between the three video URLs?

video_url is the standard watermark-free MP4, video_url_hd is the original upload quality, and video_url_watermarked includes the TikTok watermark. Their file sizes are in size, size_hd, and size_watermarked.

What happens if the video doesn't exist?

The endpoint returns 404 with code: "not_found". You are not charged for not_found responses.

How does pricing work?

You only pay for successful requests. The TikTok Video 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 3 simultaneous requests per endpoint per user. If you need more, just get in touch.