UnifAPI Docs
Tiktok

Get a TikTok video by ID

Returns canonicalized metadata for a single TikTok video. The `{id}` must be the numeric TikTok video id (aweme_id). Returns 404 not_found if the video is missing, deleted, or private. Returns 400 invalid_id if the upstream rejects the id format.

GET
/tiktok/videos/{id}

Authorization

bearerAuth
AuthorizationBearer <token>

UnifAPI API key (forwarded verbatim as the upstream provider token).

In: header

Path Parameters

id*string

Numeric TikTok video id (aweme_id)

Match^\d+$

Response 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/string"
{
  "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
    ]
  }
}

List top-level comments on a TikTok video

Returns a paginated list of top-level comments on the given video. Use `next_cursor` from the response as the next request's `cursor`. When `has_more` is false, `next_cursor` is null.

Batch-fetch TikTok videos by ID

Returns canonicalized metadata for up to 50 videos in a single call. Request body is a JSON array of numeric TikTok video IDs.