> ## Documentation Index
> Fetch the complete documentation index at: https://api-tools.memories.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# TikTok Video Comment Reply

> Get the reply list for TikTok video comments.

<Info>
  **Product**: Visual Intelligence — Social Media Scraping
  **Use case**: Fetch video metadata, transcripts, captions, and comments from YouTube, Instagram, TikTok, and Twitter/X
  **Host**: `https://mavi-backend.memories.ai/serve/api/v2`
  **Auth**: `Authorization: sk-mavi-...` (no `Bearer` prefix)
</Info>

This API is used to get the reply list for TikTok video comments with pagination support.

<Note>
  Channel routing guide: see [Social Media Scraping Overview](/visual-intelligence/social-media-scraping-overview). Endpoints with a `channel` request field let you choose `apify`, `rapid`, or `memories.ai`; endpoints without this field use managed routing.
</Note>

<Note>
  Each API call costs **\$0.01 USD**.
</Note>

### Channel Options

If your request supports a `channel` option, use it to control how scraper data is sourced:

| Channel       | What it means                                                                                    | Typical trade-off                                                       |
| ------------- | ------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------- |
| `apify`       | Uses [Apify](https://apify.com/), a dedicated web scraping platform with broad content coverage. | Most stable and most complete results, but usually more expensive.      |
| `rapid`       | Uses [RapidAPI](https://rapidapi.com/), a lower-cost aggregation platform.                       | Lower cost, but less stable and often narrower coverage.                |
| `memories.ai` | Managed routing by Memories.ai.                                                                  | Automatically selects the best price/performance path for your request. |

<Note>
  Recommendation: Start with `memories.ai` unless you need to force a specific provider.
</Note>

<Warning>
  * The maximum value for pagination parameter `page_size` is **6**
  * `cursor` starts from **0**, increment by `page_size` value each time
  * When the number of returned replies is less than `page_size`, it indicates all replies have been retrieved
</Warning>

### Code Example

<CodeGroup>
  ```python Python theme={null}
  import requests

  BASE_URL = "https://mavi-backend.memories.ai/serve/api/v2"
  API_KEY = "sk-mavi-..."
  HEADERS = {
      "Authorization": f"{API_KEY}",
      "Content-Type": "application/json"
  }

  def tiktok_video_comment_reply(video_id: str, comment_id: str):
      url = f"{BASE_URL}/tiktok/video/comment/reply"
      page_size = 6
      cursor = 0
      all_replies = []
      while True:
          data = {"video_id": video_id, "comment_id": comment_id, "page_size": page_size, "cursor": cursor}
          resp = requests.post(url, json=data, headers=HEADERS).json()
          replies = resp if isinstance(resp, list) else []
          all_replies.extend(replies)
          if len(replies) < page_size:
              break
          cursor += page_size
      return all_replies

  # Usage example
  replies = tiktok_video_comment_reply("your_tiktok_video_id", "comment_id")
  print(replies)
  ```

  ```javascript JavaScript theme={null}
  const axios = require('axios');

  const BASE_URL = 'https://mavi-backend.memories.ai/serve/api/v2';
  const API_KEY = 'sk-mavi-...';

  const headers = {
      'Authorization': API_KEY,
      'Content-Type': 'application/json'
  };

  async function tiktokVideoCommentReply(videoId, commentId) {
      const response = await axios.post(
          `${BASE_URL}/tiktok/video/comment/reply`,
          { video_id: videoId, comment_id: commentId, page_size: 6, cursor: 0 },
          { headers }
      );
      return response.data;
  }

  // Usage example
  tiktokVideoCommentReply('your_tiktok_video_id', 'comment_id')
      .then(result => console.log(result));
  ```

  ```bash cURL theme={null}
  curl -X POST "https://mavi-backend.memories.ai/serve/api/v2/tiktok/video/comment/reply" \
    -H "Authorization: sk-mavi-..." \
    -H "Content-Type: application/json" \
    -d '{
      "video_id": "your_tiktok_video_id",
      "comment_id": "comment_id",
      "page_size": 6,
      "cursor": 0
    }'
  ```
</CodeGroup>

### Request Body

| Field       | Type   | Required | Description                                                                                                       |
| ----------- | ------ | -------- | ----------------------------------------------------------------------------------------------------------------- |
| video\_id   | string | Yes      | TikTok video ID (the numeric ID at the end of a TikTok URL, e.g., `7543017294226558221`)                          |
| comment\_id | string | Yes      | Comment ID (obtained from the [TikTok Video Comment](/visual-intelligence/scraper/tiktok-video-comment) response) |
| page\_size  | number | No       | Number of replies returned per page, maximum value is 6, default is 6                                             |
| cursor      | number | No       | Pagination cursor, starts from 0, default is 0                                                                    |

### Response

Returns an array of reply list.

<ResponseExample>
  ```json theme={null}
  [
    {
      "rid": "reply_id_1",
      "text": "Reply content",
      "create_time": 1756245606,
      "like_count": 5,
      "author": {
        "id": "user_id",
        "name": "username",
        "nick_name": "Display name"
      }
    },
    {
      "rid": "reply_id_2",
      "text": "Another reply",
      "create_time": 1756245700,
      "like_count": 3,
      "author": {
        "id": "user_id_2",
        "name": "username2",
        "nick_name": "Display name 2"
      }
    }
  ]
  ```
</ResponseExample>

### Response Parameters

| Parameter             | Type   | Description              |
| --------------------- | ------ | ------------------------ |
| \[].rid               | string | Reply ID                 |
| \[].text              | string | Reply content            |
| \[].create\_time      | number | Reply creation timestamp |
| \[].like\_count       | number | Like count               |
| \[].author            | object | Reply author information |
| \[].author.id         | string | Author ID                |
| \[].author.name       | string | Author username          |
| \[].author.nick\_name | string | Author display name      |


## OpenAPI

````yaml POST /tiktok/video/comment/reply
openapi: 3.1.0
info:
  title: Scraper API Reference
  description: REST APIs for scraping TikTok and YouTube video data
  version: v1.0.0
servers:
  - url: https://mavi-backend.memories.ai/serve/api/v2
security:
  - ApiKeyAuth: []
paths:
  /tiktok/video/comment/reply:
    post:
      summary: TikTok Video Comment Reply
      description: >-
        Get the reply list for TikTok video comments. Each API call costs $0.01
        USD. The maximum value for pagination parameter pageSize is 6, cursor
        starts from 0.
      operationId: tiktok_video_comment_reply
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                video_id:
                  type: string
                  description: TikTok video ID
                  example: '7543017294226558221'
                comment_id:
                  type: string
                  description: Comment ID
                  example: comment_id
                page_size:
                  type: integer
                  description: >-
                    Number of replies returned per page, maximum value is 6,
                    default is 6
                  example: 6
                  maximum: 6
                  default: 6
                cursor:
                  type: integer
                  description: Pagination cursor, starts from 0, default is 0
                  example: 0
                  default: 0
                  minimum: 0
              required:
                - video_id
                - comment_id
      responses:
        '200':
          description: Successfully returned reply list
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
                  properties:
                    rid:
                      type: string
                      description: Reply ID
                    text:
                      type: string
                      description: Reply content
                    create_time:
                      type: integer
                      description: Reply creation timestamp
                    like_count:
                      type: integer
                      description: Like count
                    author:
                      type: object
                      description: Reply author information
components:
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: Authorization

````