UnifAPI Docs
Tiktok

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.

POST
/tiktok/videos/batch

Authorization

bearerAuth
AuthorizationBearer <token>

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

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/tiktok/videos/batch" \  -H "Content-Type: application/json" \  -d '{    "ids": [      "string"    ]  }'
{
  "items": [
    {
      "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
    ]
  }
}

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.

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.