Boost Comment (Reply) Script Configuration

This page documents the configuration parameters for the boost_comment script used in task creation.

Which script do I need?

There are two different comment scripts, and they do different things:

comment — posts a new top-level comment on a post. See Comment Script Configuration.
boost_comment (this page) — likes and/or replies to an existing comment on a post. This is the "REPLY COMMENT" / "Boost Comments" feature.

If you want to reply to comments, you are in the right place.

Overview

The boost_comment script opens a post and engages with its top comment — it can like the comment, reply to it, or both. It is the API equivalent of the in-app Boost Comments dialog.

Unlike the comment script, the boost_comment script handles all target URLs within a single task run (it splits target_comment_urls by newline internally and processes them one after another). One task is created per device (serial mode) or per account (username / multi-account mode) — not one task per URL.

Script Configuration (`script_config`)

Parameters

Parameter	Type	Required	Default	Description
target_comment_urls	string	Yes	""	Post URL(s) whose top comment to engage with. Separate multiple URLs with newlines (`\n`).
enable_like_comment	boolean	Yes*	false	Like the top comment of each post.
enable_reply_comment	boolean	Yes*	false	Reply to the top comment of each post.
reply_contents	string	Required if `enable_reply_comment` is `true`	""	Reply text. Separate multiple reply options with newlines (`\n`); one is selected per task according to `reply_order`.
reply_order	string	No	"random"	How to pick a reply from `reply_contents`: `random` or `sequential`.
insert_emoji	boolean	No	false	Insert a random emoji into the reply.
username	string	No	""	Switch to this account before running. If omitted, the account currently active on the device is used.

At least one action is required

You must enable at least one action: set enable_like_comment and/or enable_reply_comment to true. If enable_reply_comment is true, reply_contents must be non-empty. Otherwise the API rejects the request with error 40001.

Which comment is engaged?

The script engages the top (first) comment of each post. Provide the post URL in target_comment_urls — you do not need a direct link to an individual comment.

Examples

Reply to a comment (the most common case)

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1"],
    "script_name": "boost_comment",
    "script_config": {
      "target_comment_urls": "https://www.tiktok.com/@username/video/1234567890",
      "enable_reply_comment": true,
      "reply_contents": "Great point!\nI totally agree!\nThanks for sharing 🙌"
    }
  }'

The reply is chosen from the three lines in reply_contents (randomly by default).

Like and reply at the same time

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1"],
    "script_name": "boost_comment",
    "script_config": {
      "target_comment_urls": "https://www.tiktok.com/@username/video/1234567890",
      "enable_like_comment": true,
      "enable_reply_comment": true,
      "reply_contents": "Couldn'\''t agree more!\nWell said!",
      "reply_order": "sequential",
      "insert_emoji": true
    }
  }'

Engage comments on multiple posts in one task

Separate URLs with newlines. All of them are processed inside a single task:

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1"],
    "script_name": "boost_comment",
    "script_config": {
      "target_comment_urls": "https://www.tiktok.com/@user1/video/111\nhttps://www.tiktok.com/@user2/video/222\nhttps://www.tiktok.com/@user3/video/333",
      "enable_reply_comment": true,
      "reply_contents": "Love this!\nAmazing!\nSo true!",
      "reply_order": "random"
    }
  }'

Like only (no reply)

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1"],
    "script_name": "boost_comment",
    "script_config": {
      "target_comment_urls": "https://www.tiktok.com/@username/video/1234567890",
      "enable_like_comment": true
    }
  }'

Run with a specific account (username mode)

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "usernames": ["@my_account1", "@my_account2"],
    "script_name": "boost_comment",
    "script_config": {
      "target_comment_urls": "https://www.tiktok.com/@target/video/123",
      "enable_reply_comment": true,
      "reply_contents": "Nice!\nGreat content!"
    }
  }'

One task is created per account, each switching to that account first.

Instagram example

The same API works for Instagram posts:

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1"],
    "script_name": "boost_comment",
    "script_config": {
      "target_comment_urls": "https://www.instagram.com/p/ABC123/",
      "enable_reply_comment": true,
      "reply_contents": "Beautiful! 😍\nLove it!"
    }
  }'

Response

{
  "code": 0,
  "message": "success",
  "data": {
    "task_ids": [301],
    "created_count": 1
  }
}

Reply Order

Random Order (`random`)

Randomly selects one reply from reply_contents for the task.
Good for making replies appear more natural.
Default behavior.

Sequential Order (`sequential`)

Selects a reply by task index (job_count): the first task uses the first line, the second task uses the second line, and so on, cycling back to the start.
Good for distributing different replies across multiple devices/accounts.

Post URL Formats

TikTok

https://www.tiktok.com/@username/video/1234567890123456
https://vm.tiktok.com/ABCDEFG/

Instagram

https://www.instagram.com/p/ABCDEFGHIJK/
https://www.instagram.com/reel/ABCDEFGHIJK/

`comment` vs `boost_comment`

	`comment`	`boost_comment`
What it does	Posts a new top-level comment	Likes / replies to an existing comment
Main input	`target_post_url(s)` + `comment_content`	`target_comment_urls` + `reply_contents`
Task fan-out	One task per URL	One task per device/account (all URLs in one run)
Doc	Comment Script	This page

Best Practices

Vary your replies: Provide several lines in reply_contents so replies don't look identical across accounts.
Use sequential order across accounts: Pair sequential order with multiple devices/accounts to spread different replies.
Enable emoji insertion: Set insert_emoji: true to make replies feel more natural.
Respect platform limits: Replying too aggressively can trigger rate limits. Spread tasks over time.

Error Codes

Code	Description
40001	Missing `target_comment_urls`, no action enabled, or `enable_reply_comment` is true with empty `reply_contents`
40003	Script not supported via API
40301	API access requires Pro+ plan

Overview​

Script Configuration (script_config)​

Parameters​

Examples​

Reply to a comment (the most common case)​

Like and reply at the same time​

Engage comments on multiple posts in one task​

Like only (no reply)​

Run with a specific account (username mode)​

Instagram example​

Response​

Reply Order​

Random Order (random)​

Sequential Order (sequential)​

Post URL Formats​

TikTok​

Instagram​

comment vs boost_comment​

Best Practices​

Error Codes​

See Also​