Get video or photo carousel detail & 1080p no-watermark URL

GET/v1/video/detail10 Credits / request($1.00 / 1K requests)

Fetch full metadata, engagement metrics, creator profile, music track, image carousel slides, and direct 1080p HD no-watermark download links (data.play, data.hdplay) for any public TikTok video.

Query Parameters

urlstringrequired
TikTok video URL, short link (vm.tiktok.com), or numeric video ID.
Example: https://www.tiktok.com/@tiktok/video/7106594312292453675
hdinteger
Set to 1 to include the 1080p HD no-watermark stream URL in data.hdplay.
Example: 1

Example Request (cURL / Python / JavaScript)

curl "https://api.tiktokapi.io/v1/video/detail?url=https%3A%2F%2Fwww.tiktok.com%2F%40tiktok%2Fvideo%2F7106594312292453675" \
  -H "x-api-key: tk_your_api_key"

Live Response Preview

{
  "code": 0,
  "msg": "success",
  "processed_time": 0.15,
  "data": {}
}

Response Fields

Success (code === 0). Charged according to the endpoint credit rate.

Field	Type	Sample / Notes
`code`	integer	Example: 0
`msg`	string	Example: success
`processed_time`	number	Example: 0.15
`data`	object

Status Codes

200: Success (code === 0). Charged according to the endpoint credit rate.
400: Invalid parameters, or API key placed in the URL query string (not charged).
401: Missing or invalid x-api-key header (not charged).
402: Insufficient credit balance (not charged).
403: Account disabled (not charged).
404: Unknown endpoint or disabled unstable endpoint (not charged).
405: Method not allowed — all /v1/* data endpoints use GET (not charged).
429: Rate limit exceeded (not charged). Respect the Retry-After header.
503: Temporary upstream or gateway error (not charged). Retry with exponential backoff.