Skip to main content
POST
/
tiktok
/
video
/
comment
/
reply
TikTok Video Comment Reply
curl --request POST \
  --url https://mavi-backend.memories.ai/serve/api/v2/tiktok/video/comment/reply \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "video_id": "7543017294226558221",
  "comment_id": "comment_id",
  "page_size": 6,
  "cursor": 0
}
'
[
  {
    "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"
    }
  }
]

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.

This API is used to get the reply list for TikTok video comments with pagination support.
Channel routing guide: see 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.
Each API call costs $0.01 USD.

Channel Options

If your request supports a channel option, use it to control how scraper data is sourced:
ChannelWhat it meansTypical trade-off
apifyUses Apify, a dedicated web scraping platform with broad content coverage.Most stable and most complete results, but usually more expensive.
rapidUses RapidAPI, a lower-cost aggregation platform.Lower cost, but less stable and often narrower coverage.
memories.aiManaged routing by Memories.ai.Automatically selects the best price/performance path for your request.
Recommendation: Start with memories.ai unless you need to force a specific provider.
  • 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

Code Example

import requests

BASE_URL = "https://mavi-backend.memories.ai/serve/api/v2"
API_KEY = "sk-mai-this_a_test_string_please_use_your_generated_key_during_testing"
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)

Request Body

FieldTypeRequiredDescription
video_idstringYesTikTok video ID (the numeric ID at the end of a TikTok URL, e.g., 7543017294226558221)
comment_idstringYesComment ID (obtained from the TikTok Video Comment response)
page_sizenumberNoNumber of replies returned per page, maximum value is 6, default is 6
cursornumberNoPagination cursor, starts from 0, default is 0

Response

Returns an array of reply list.
[
  {
    "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"
    }
  }
]

Response Parameters

ParameterTypeDescription
[].ridstringReply ID
[].textstringReply content
[].create_timenumberReply creation timestamp
[].like_countnumberLike count
[].authorobjectReply author information
[].author.idstringAuthor ID
[].author.namestringAuthor username
[].author.nick_namestringAuthor display name

Authorizations

Authorization
string
header
required

Body

application/json
video_id
string
required

TikTok video ID

Example:

"7543017294226558221"

comment_id
string
required

Comment ID

Example:

"comment_id"

page_size
integer
default:6

Number of replies returned per page, maximum value is 6, default is 6

Required range: x <= 6
Example:

6

cursor
integer
default:0

Pagination cursor, starts from 0, default is 0

Required range: x >= 0
Example:

0

Response

200 - application/json

Successfully returned reply list

rid
string

Reply ID

text
string

Reply content

create_time
integer

Reply creation timestamp

like_count
integer

Like count

author
object

Reply author information