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

# Get Comments

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

## Request

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

Top-level comments on a video, with cursor pagination.

## Path parameters

- `video_id` string, required

## Query parameters

- `region` string
- `count` integer
- `cursor` string

## Response `200`

Comments

- CommentListResponse
  - `comments` TikTokComment[]
    - `id` string, required: Comment id (cid).
    - `text` string
    - `aweme_id` string: Parent video id.
    - `parent_comment_id` string
    - `digg_count` integer
    - `reply_count` integer
    - `create_time_utc` integer
    - `create_time_at` string
    - `liked_by_author` boolean
    - `pinned_by_author` boolean
    - `comment_language` string
    - `status` integer
    - `mentions` string[]
    - `text_extra` TikTokTextExtra[]
      - `type` string: 'hashtag' or 'mention'.
      - `hashtag_name` string
      - `user_unique_id` string
      - `user_id` string
      - `start` integer
      - `end` integer
    - `image_urls` string[]: Comment sticker/image URLs.
    - `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
    - `replies` TikTokComment[]: Nested replies (when included).
  - `pagination` TikTokCursorPage: Cursor pagination metadata shared by all list endpoints.
    - `has_more` boolean: True when more pages are available.
    - `cursor` string: Opaque cursor; pass back as ?cursor= for the next page.
    - `count` integer: Number of items in this page.
    - `search_id` string: Search endpoints chain rid → search_id across pages.
  - `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)
