---
title: "Get Video Detail"
method: GET
path: "/v1/tiktok/videos/{video_id}"
tags: ["TikTok Videos"]
---

# Get Video Detail

`GET /v1/tiktok/videos/{video_id}`

## Request

- Base URL: `https://scrapebadger.com`
- URL: `https://scrapebadger.com/v1/tiktok/videos/{video_id}`
- Auth: API key in header `x-api-key`
- TypeScript: <https://skmtc.dev/scrapebadger/apis/scrapebadger-account-api/docs/v1/tiktok/videos/:video_id/get.ts> (a function with typed inputs; its response is checked against the schema)

Full metadata for a single TikTok video or photo slideshow.

## Path parameters

- `video_id` string, required

## Query parameters

- `region` string
- `username` string

## Response `200`

Video detail

- VideoResponse
  - `video` TikTokVideo, required: A TikTok post (video or photo slideshow) with full metadata.
    - `id` string, required
    - `description` string: Caption text.
    - `text_language` string
    - `create_time_utc` integer: Post Unix timestamp.
    - `create_time_at` string: Post ISO 8601 UTC.
    - `region` string: Location created.
    - `url` string: Web video URL.
    - `share_url` string: Canonical share link.
    - `group_id` string
    - `aweme_type` integer: 0 video, 150 photo/slideshow, ...
    - `content_type` string
    - `author` TikTokAuthor: Author summary embedded in a video, comment, or search result.
      - `id` string: Numeric user id.
      - `sec_uid` string: Secure user id (sec_uid) used for downstream list calls.
      - `unique_id` string: The @handle.
      - `nickname` string: Display name.
      - `avatar_thumb` string
      - `avatar_medium` string
      - `avatar_larger` string
      - `signature` string: Bio text.
      - `verified` boolean
      - `private_account` boolean
      - `follower_count` integer
      - `following_count` integer
      - `heart_count` integer: Total likes received.
      - `video_count` integer
      - `digg_count` integer: Likes given.
      - `region` string
      - `verify_reason` string
      - `verification_type` integer
      - `account_region` string
      - `language` string
      - `original_musician` boolean
      - `is_star` boolean
      - `ins_id` string: Linked Instagram handle.
      - `twitter_name` string
      - `youtube_channel_title` string
      - `room_id` string: Non-empty while the user is live.
      - `commerce_user_level` integer
      - `with_shop_entry` boolean
    - `music` TikTokMusic: Sound/music attached to a video, or a standalone music entity.
      - `id` string
      - `title` string
      - `author_name` string
      - `album` string
      - `duration` integer: Seconds.
      - `play_url` string
      - `cover_thumb` string
      - `cover_medium` string
      - `cover_large` string
      - `original` boolean
      - `is_copyrighted` boolean
      - `mid` string
      - `owner_id` string
      - `owner_nickname` string
      - `is_commerce_music` boolean
      - `is_original_sound` boolean
      - `video_count` integer: Videos using this sound (standalone music endpoints only).
      - `user_count` integer: Distinct creators using this sound (standalone music endpoints only).
    - `stats` TikTokStats: Engagement statistics for a video.
      - `play_count` integer: Views.
      - `digg_count` integer: Likes.
      - `comment_count` integer
      - `share_count` integer
      - `collect_count` integer: Saves/bookmarks.
      - `download_count` integer
      - `forward_count` integer
      - `whatsapp_share_count` integer
      - `repost_count` integer
    - `video` TikTokVideoMeta: Playable-media metadata for a video.
      - `height` integer
      - `width` integer
      - `duration` integer: Seconds.
      - `ratio` string
      - `format` string
      - `definition` string
      - `codec_type` string
      - `encoded_type` string
      - `bitrate` integer
      - `cover` string
      - `origin_cover` string
      - `dynamic_cover` string
      - `animated_cover` string
      - `ai_dynamic_cover` string
      - `share_cover` string
      - `play_addr` string: Direct play URL.
      - `download_addr` string: Watermarked download URL.
      - `download_no_watermark_addr` string: Clean MP4 (mobile).
      - `has_watermark` boolean
      - `volume_loudness` number
      - `volume_peak` number
    - `status` TikTokVideoStatus: Moderation/availability state of a post.
      - `is_delete` boolean
      - `allow_share` boolean
      - `allow_comment` boolean
      - `private_status` integer: 0 public, 1 friends, 2 private.
      - `in_reviewing` boolean
      - `reviewed` boolean
      - `is_prohibited` boolean
      - `download_status` integer
      - `self_see` boolean
    - `video_control` TikTokVideoControl: Per-post interaction permissions.
      - `allow_download` boolean
      - `allow_duet` boolean
      - `allow_stitch` boolean
      - `allow_react` boolean
      - `allow_comment` boolean
      - `share_type` integer
      - `prevent_download` boolean
    - `anchors` TikTokAnchor[]
      - `id` string
      - `type` integer
      - `keyword` string
      - `url` string
      - `icon` string
    - `hashtags` string[]
    - `mentions` string[]
    - `text_extra` TikTokTextExtra[]
      - `type` string: 'hashtag' or 'mention'.
      - `hashtag_name` string
      - `user_unique_id` string
      - `user_id` string
      - `start` integer
      - `end` integer
    - `challenges` TikTokChallenge[]
      - `id` string
      - `title` string: Hashtag text, no '#'.
      - `desc` string
      - `cover` string
      - `is_commerce` boolean
    - `effect_stickers` TikTokEffectSticker[]
      - `id` string
      - `name` string
      - `photo_url` string
    - `is_slideshow` boolean
    - `image_urls` string[]: Image URLs for photo/slideshow posts.
    - `is_ad` boolean
    - `is_aigc` boolean
    - `aigc_description` string
    - `is_pinned` boolean
    - `is_muted` boolean
    - `secret` boolean
    - `private_item` boolean
    - `duet_enabled` boolean
    - `stitch_enabled` boolean
    - `share_enabled` boolean
    - `comment_status` string
    - `can_repost` boolean
    - `is_paid_content` boolean
    - `is_on_this_day` boolean
    - `support_danmaku` boolean: Supports bullet comments.
    - `subtitles` TikTokSubtitle[]: Populated only on the transcript endpoint.
      - `language` string
      - `language_code` string
      - `url` string
      - `source` string: ASR vs creator.
      - `version` string
      - `format` string
    - `voice_to_text` string: ASR transcript (transcript endpoint only).
    - `diversification_labels` string[]
    - `suggested_words` string[]
  - `region` string, required

---

[API](https://skmtc.dev/scrapebadger/apis/scrapebadger-account-api.md) - [All operations](https://skmtc.dev/scrapebadger/apis/scrapebadger-account-api/llms.txt) - [OpenAPI document](https://skmtc.dev/scrapebadger/apis/scrapebadger-account-api/revisions/4a1ef8777baf?raw)