Skip to content

Get TikTok video (POST)

POST
/v1/tiktok-video

Extract video metadata, engagement stats, and music info from a TikTok video URL.

Credits: 1 per request.

Accepts the same fields as JSON instead of query parameters.

object
url
required

TikTok video URL.

string

Extracted data.

object
id
string
description
string
create_time
number
author
object
id
string
unique_id
string
nickname
string
verified
boolean
stats
object
play_count
number
like_count
number
comment_count
number
share_count
number
video
object
duration
number
cover
string
play_url
string
music
object
id
string
title
string
author
string
X-Credits-Used
integer

Credits consumed.

X-Credits-Remaining
integer

Remaining credit balance.

Missing or invalid API key.

object
error
required
string
Example
invalid request
field

Field that failed validation.

string
detail
string
hint
string

Insufficient unreserved credits.

object
error
required
string
Example
insufficient credits
required
required
integer
available
required
integer

Request, concurrency, or plan limit exceeded.

One of:
object
error
required
string
Example
invalid request
field

Field that failed validation.

string
detail
string
hint
string
Retry-After
integer

Seconds to wait when supplied.