---
title: "Retrieve TikTok video comments"
method: GET
path: "/tiktok/comments"
tags: ["TikTok"]
---

# Retrieve TikTok video comments

`GET /tiktok/comments`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/tiktok/comments`
- Auth: API key in header `x-api-key`

Returns the top-level comments on a TikTok video, by the video id from its URL (`aweme_id`). Results are paged by cursor: pass the `cursor` from one response to get the next page, and read `has_more` to see whether more remain. The response also carries the total comment count.

## Query parameters

- `aweme_id` string, required
- `cursor` integer

## Headers

- `x-api-key` string, required

## Response `200`

OK

- TiktokCommentsResponseDoc
  - `code` integer
  - `data` TiktokCommentResp
    - `alias_comment_deleted` boolean: Flag TikTok returns for deleted alias comments.
    - `comments` unknown[]: Top-level comments on the video, one entry per comment, as TikTok returns them.
      - unknown
    - `cursor` integer: Cursor to pass in the next request to get the next page of comments.
    - `extra` object: Response metadata from TikTok, such as server time.
      - `api_debug_info` unknown
      - `fatal_item_ids` unknown
      - `now` integer
    - `has_filtered_comments` integer: Flag showing whether TikTok filtered any comments out of the list.
    - `has_more` integer: Whether more comments remain after this page, as a number (`1` for yes).
    - `log_pb` object: Request tracking information from TikTok, holding the `impr_id` impression id.
      - `impr_id` string
    - `reply_style` integer: Reply display style code that TikTok returns with the comments.
    - `status_code` integer: TikTok status code for the request. `0` on a successful response.
    - `status_msg` string: Status message that goes with the status code.
    - `top_gifts` unknown
    - `total` integer: Total number of comments on the video.
  - `msg` string

## Other responses

- `400`: Invalid input
- `429`: Rate limit exceeded
- `500`: Internal server error

---

[API](https://skmtc.dev/crawlora/apis/crawlora-api.md) · [All operations](https://skmtc.dev/crawlora/apis/crawlora-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crawlora/apis/crawlora-api/revisions/0497899e2016?raw)