UnifAPI DocsTiktok
Resolve a TikTok share URL to a video
Accepts a TikTok share URL (long or short / vm.tiktok.com) and returns the canonical Video object. The host must be one of: www.tiktok.com, tiktok.com, m.tiktok.com, vm.tiktok.com, vt.tiktok.com. Returns 404 not_found if the URL is invalid or the video is missing/deleted/private.
Authorization
bearerAuth AuthorizationBearer <token>
UnifAPI API key (forwarded verbatim as the upstream provider token).
In: header
Query Parameters
url*string
TikTok share URL (long or short form)
Format
uriResponse Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/tiktok/videos/resolve?url=http%3A%2F%2Fexample.com"{
"id": "string",
"title": "string",
"video_description": "string",
"create_time": 0,
"duration": 0,
"cover_image_url": "string",
"share_url": "string",
"embed_link": "string",
"width": 0,
"height": 0,
"like_count": 0,
"comment_count": 0,
"share_count": 0,
"view_count": 0,
"author": {
"id": "string",
"username": "string",
"display_name": "string",
"avatar_url": "string"
},
"region": "string",
"hashtags": [
"string"
],
"music": {
"id": "string",
"title": "string",
"author": "string",
"is_original": true
},
"is_image_post": true,
"play_url": "string"
}{
"error": {
"type": "validation_error",
"message": "string",
"request_id": "string",
"issues": [
null
]
}
}{
"error": {
"type": "validation_error",
"message": "string",
"request_id": "string",
"issues": [
null
]
}
}{
"error": {
"type": "validation_error",
"message": "string",
"request_id": "string",
"issues": [
null
]
}
}{
"error": {
"type": "validation_error",
"message": "string",
"request_id": "string",
"issues": [
null
]
}
}{
"error": {
"type": "validation_error",
"message": "string",
"request_id": "string",
"issues": [
null
]
}
}{
"error": {
"type": "validation_error",
"message": "string",
"request_id": "string",
"issues": [
null
]
}
}{
"error": {
"type": "validation_error",
"message": "string",
"request_id": "string",
"issues": [
null
]
}
}