댓글 부스트(답글) 스크립트 구성
이 페이지에서는 작업 생성에 사용되는 boost_comment 스크립트의 구성 매개변수를 설명합니다.
두 가지 서로 다른 댓글 스크립트가 있으며, 동작이 다릅니다:
comment— 게시물에 새로운 최상위 댓글을 게시합니다. 댓글 스크립트 구성을 참조하세요.boost_comment(이 페이지) — 기존 댓글에 좋아요 및/또는 답글을 답니다. 이것이 "REPLY COMMENT"(댓글 답글) / "Boost Comments" 기능입니다.
댓글에 답글을 달고 싶다면, 제대로 찾아오셨습니다.
개요
boost_comment 스크립트는 게시물을 열고 해당 게시물의 상단 댓글과 상호작용합니다 — 댓글에 좋아요, 댓글에 답글, 또는 둘 다 가능합니다. 앱 내 Boost Comments 대화상자의 API 버전에 해당합니다.
comment 스크립트와 달리, boost_comment 스크립트는 단일 작업 실행 내에서 모든 대상 URL을 처리합니다(내부적으로 target_comment_urls를 줄바꿈으로 분할하여 차례로 처리). 작업은 기기별(시리얼 모드) 또는 계정별(사용자명/멀티 계정 모드)로 생성되며, URL별이 아닙니다.
스크립트 구성 (script_config)
매개변수
| 매개변수 | 유형 | 필수 | 기본값 | 설 명 |
|---|---|---|---|---|
| target_comment_urls | string | 예 | "" | 상단 댓글과 상호작용할 게시물 URL. 여러 URL은 줄바꿈(\n)으로 구분합니다. |
| enable_like_comment | boolean | 예* | false | 각 게시물의 상단 댓글에 좋아요를 누릅니다. |
| enable_reply_comment | boolean | 예* | false | 각 게시물의 상단 댓글에 답글을 답니다. |
| reply_contents | string | enable_reply_comment가 true인 경우 필수 | "" | 답글 텍스트. 여러 답글 옵션은 줄바꿈(\n)으로 구분하며, reply_order에 따라 작업마다 하나가 선택됩니다. |
| reply_order | string | 아니오 | "random" | reply_contents에서 답글을 선택하는 방식: random(무작위) 또는 sequential(순차). |
| insert_emoji | boolean | 아니오 | false | 답글에 무작위 이모지를 삽입합니다. |
| username | string | 아니오 | "" | 실행 전에 이 계정으로 전환합니다. 생략하면 기기에서 현재 활성화된 계정을 사용합니다. |
최소한 하나의 동작을 활성 화해야 합니다: enable_like_comment 및/또는 enable_reply_comment를 true로 설정하세요. enable_reply_comment가 true이면 reply_contents는 비어 있을 수 없습니다. 그렇지 않으면 API가 오류 40001을 반환합니다.
스크립트는 각 게시물의 상단(첫 번째) 댓글과 상호작용합니다. target_comment_urls에는 게시물 URL을 입력하세요 — 개별 댓글로의 직접 링크는 필요하지 않습니다.
예시
댓글에 답글 달기(가장 일반적인 경우)
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 🙌"
}
}'
답글은 reply_contents의 세 줄 중에서 선택됩니다(기본값은 무작위).
좋아요와 답글을 동시에
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
}
}'
하나의 작업에서 여러 게시물의 댓글과 상호작용
URL을 줄바꿈으로 구분합니다. 모두 단일 작업 내에서 처리됩니다:
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"
}
}'
좋아요만(답글 없음)
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
}
}'
특정 계정으로 실행(사용자명 모드)
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!"
}
}'
계정별로 하나의 작업이 생성되며, 각각 실행 전에 해당 계정으로 전환합니다.
Instagram 예시
동일한 API가 Instagram 게시물에도 작동합니다:
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!"
}
}'
응답
{
"code": 0,
"message": "success",
"data": {
"task_ids": [301],
"created_count": 1
}
}
답글 순서
무작위 순서 (random)
- 작업마다
reply_contents에서 답글 하나를 무작위로 선택합니다. - 답글이 더 자연스럽게 보이게 하는 데 좋습니다.
- 기본 동작입니다.
순차 순서 (sequential)
- 작업 인덱스(
job_count)로 답글을 선택합니다: 첫 번째 작업은 첫 번째 줄, 두 번째 작업은 두 번째 줄을 사용하며, 끝에 도달하면 처음으로 순환합니다. - 여러 기기/계정에 서로 다른 답글을 분산하는 데 좋습니다.
게시물 URL 형식
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 | |
|---|---|---|
| 기능 | 새로운 최상위 댓글 게시 | 기존 댓글에 좋아요 / 답글 |
| 주요 입력 | target_post_url(s) + comment_content | target_comment_urls + reply_contents |
| 작업 분할 | URL당 1개 작업 | 기기/계정당 1개 작업(모든 URL을 한 번에 처리) |
| 문서 | 댓글 스크립트 | 이 페이지 |
모범 사례
- 답글을 다양하게:
reply_contents에 여러 줄을 제공하여 계정 간 답글이 동일해 보이지 않도록 하세요. - 계정 간 순차 순서 사용:
sequential순서를 여러 기기/계정과 함께 사용하여 서로 다른 답글을 분산하세요. - 이모지 삽입 활성화:
insert_emoji: true로 설정하여 답글을 더 자연스럽게 만드세요. - 플랫폼 제한 준수: 답글이 너무 과도하면 속도 제한이 발생할 수 있습니다. 작업을 시간에 걸쳐 분산하세요.
오류 코드
| 코드 | 설명 |
|---|---|
| 40001 | target_comment_urls 누락, 활성화된 동작 없음, 또는 enable_reply_comment가 true인데 reply_contents가 비어 있음 |
| 40003 | 스크립트가 API를 통해 지원되지 않음 |
| 40301 | API 액세스에는 Pro+ 요금제가 필요함 |
관련 항목
- 댓글 스크립트 구성 - 게시물에 새 댓글 게시
- 좋아요 스크립트 구성 - 게시물에 좋아요
- 작업 관리 API - 작업 생성, 나열 및 관리
- 로컬 API 개요 - API 개요 및 빠른 시작