댓글 스크립트 설정

이 페이지는 작업 생성을 위한 comment 스크립트의 설정 매개변수를 소개합니다.

개요

comment 스크립트는 TikTok 또는 Instagram 게시물에 자동으로 댓글을 작성하는 데 사용됩니다. API를 통해 여러 대상 게시물 URL을 제공할 때, 각 대상 게시물 URL에 대해 하나의 작업이 생성됩니다. start_time 매개변수를 사용하여 각 작업의 실행 시간을 제어할 수 있습니다.

스크립트 설정 (`script_config`)

script_config 객체는 댓글 스크립트의 매개변수를 포함합니다. 다음은 사용 가능한 매개변수입니다:

매개변수

매개변수	유형	필수	기본값	설명
target_post_urls	string[]	예*	[]	댓글을 작성할 대상 게시물 URL 배열(각 URL당 하나의 작업)
target_post_url	string	예*	""	단일 대상 게시물 URL 또는 줄바꿈/쉼표로 구분된 여러 URL
comment_content	string	예	""	댓글 텍스트 내용. 줄바꿈으로 구분된 여러 댓글을 포함할 수 있습니다
comment_order	string	아니요	"random"	댓글을 선택하는 방법: `random`(무작위) 또는 `sequential`(순차)
insert_emoji	boolean	아니요	false	댓글에 무작위 이모지를 삽입할지 여부
comment_image_path	string	아니요	""	이미지 댓글의 이미지 파일 경로(TikTok만 해당). 절대 경로 또는 work_dir/upload/에 상대적인 경로를 지원합니다

노트

target_post_urls 배열 또는 target_post_url 문자열을 제공해야 합니다. 둘 다 제공되면 target_post_urls가 우선됩니다.

이미지 댓글(TikTok만 해당)

comment_image_path 매개변수를 사용하면 댓글에 이미지를 첨부할 수 있습니다. 이 기능은 TikTok에서만 지원됩니다 - Instagram 댓글은 이미지 첨부를 지원하지 않습니다. 이미지는 기기로 푸시되고 갤러리의 첫 번째 이미지로 선택됩니다.

작업 생성

여러 대상 게시물 URL을 제공할 때, API는 각 대상 게시물 URL에 대해 하나의 작업을 생성합니다. 예를 들어 3개의 게시물 URL과 2개의 기기를 지정하면 6개의 작업이 생성됩니다. start_time 매개변수를 사용하여 작업이 실행을 시작하는 시간을 제어합니다.

예제

단일 게시물에 댓글 작성

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1"],
    "script_name": "comment",
    "script_config": {
      "target_post_url": "https://www.tiktok.com/@username/video/1234567890",
      "comment_content": "멋진 콘텐츠! 🔥"
    }
  }'

여러 댓글 옵션 사용

줄바꿈으로 구분된 여러 댓글을 제공합니다. 시스템은 comment_order에 따라 그 중 하나를 선택합니다:

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1"],
    "script_name": "comment",
    "script_config": {
      "target_post_url": "https://www.tiktok.com/@username/video/1234567890",
      "comment_content": "멋진 영상이에요!\n이 콘텐츠 좋아요!\n계속 힘내세요! 👏\n정말 좋네요!",
      "comment_order": "random"
    }
  }'

여러 게시물에 댓글 작성

여러 게시물에 댓글을 작성할 때, 각 게시물에 대해 하나의 작업이 생성됩니다:

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1"],
    "script_name": "comment",
    "script_config": {
      "target_post_urls": [
        "https://www.tiktok.com/@user1/video/111",
        "https://www.tiktok.com/@user2/video/222",
        "https://www.tiktok.com/@user3/video/333"
      ],
      "comment_content": "좋은 영상!\n멋져요!\n최고예요!",
      "comment_order": "sequential"
    }
  }'

이렇게 하면 3개의 독립적인 작업이 즉시 실행됩니다.

예약된 댓글

start_time을 사용하여 작업이 실행을 시작하는 시간을 예약합니다:

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1"],
    "script_name": "comment",
    "script_config": {
      "target_post_url": "https://www.tiktok.com/@username/video/1234567890",
      "comment_content": "예약 댓글!"
    },
    "start_time": "14:30"
  }'

이모지 삽입이 있는 댓글

자동 이모지 삽입을 활성화하여 댓글을 더 매력적으로 만듭니다:

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1"],
    "script_name": "comment",
    "script_config": {
      "target_post_url": "https://www.tiktok.com/@username/video/1234567890",
      "comment_content": "정말 멋지네요",
      "insert_emoji": true
    }
  }'

사용자명 목록 패턴별 댓글

특정 계정에 대해 직접 댓글 작업을 생성합니다:

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "usernames": ["@my_account1", "@my_account2"],
    "script_name": "comment",
    "script_config": {
      "target_post_url": "https://www.tiktok.com/@target/video/123",
      "comment_content": "좋은 영상이에요!"
    }
  }'

여러 기기에서 일괄 댓글

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_1", "device_2", "device_3"],
    "script_name": "comment",
    "script_config": {
      "target_post_url": "https://www.tiktok.com/@viral/video/999",
      "comment_content": "내용이 정말 좋아요!\n훌륭한 작업!\n정말 좋아요!",
      "comment_order": "random"
    },
    "enable_multi_account": true
  }'

Instagram 댓글 예제

동일한 API가 Instagram 게시물에 적용됩니다:

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1"],
    "script_name": "comment",
    "script_config": {
      "target_post_url": "https://www.instagram.com/p/ABC123/",
      "comment_content": "아름다운 사진! 📸",
      "insert_emoji": true
    }
  }'

TikTok 이미지 댓글 예제

TikTok 댓글에 이미지를 첨부합니다(Instagram은 지원하지 않음):

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1"],
    "script_name": "comment",
    "script_config": {
      "target_post_url": "https://www.tiktok.com/@username/video/1234567890",
      "comment_content": "이 이미지를 확인해 보세요!",
      "comment_image_path": "C:/images/my_image.jpg"
    }
  }'

이미지 경로

comment_image_path는 다음과 같을 수 있습니다:

절대 경로: C:/images/my_image.jpg 또는 /home/user/images/my_image.jpg
상대 경로: my_image.jpg(work_dir/upload/에 상대적)

응답

{
  "code": 0,
  "message": "success",
  "data": {
    "task_ids": [301, 302, 303],
    "created_count": 3
  }
}

댓글 순서

무작위 순서 (`random`)

제공된 목록에서 무작위로 댓글을 선택합니다
댓글을 더 자연스럽게 보이게 하는 데 적합합니다
기본 동작

순차 순서 (`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/

Threads

https://www.threads.com/@username/post/ABCDEFGHIJK
https://www.threads.com/t/ABCDEFGHIJK

threads.net 링크도 작동합니다. /share/ 링크는 작동하지 않습니다. 그 코드는 게시물 페이지에서 사용되는 ID와 다르므로 아무것도 가리키지 않는 URL로 변환되는 대신 거부됩니다.

모범 사례

댓글 다양성 사용: 스팸처럼 보이는 것을 방지하기 위해 여러 댓글 옵션을 제공합니다.
다양성을 위해 순차 모드 사용: 동일한 기기로 여러 게시물에 댓글을 작성할 때 sequential 순서를 사용하여 다양한 댓글을 배포합니다.
이모지 삽입 활성화: insert_emoji: true를 설정하여 댓글을 더 자연스럽고 매력적으로 보이게 합니다.
작업 예약: start_time 매개변수를 사용하여 일정 기간 동안 댓글을 분산시키고 속도 제한을 트리거할 가능성을 줄입니다.
플랫폼 제한 준수: 한 번에 너무 많은 댓글 작업을 생성하지 마세요. 대부분의 플랫폼은 댓글에 대한 속도 제한이 있습니다.

오류 코드

코드	설명
40001	대상 게시물 URL 또는 댓글 내용 누락
40003	API가 스크립트를 지원하지 않습니다
40301	API 접근에는 Pro+ 계획이 필요합니다

참조

작업 관리 API - 작업 생성, 나열 및 관리
게시물 스크립트 설정 - 게시물 스크립트 매개변수 구성
팔로우 스크립트 설정 - 팔로우 스크립트 매개변수 구성
로컬 API 개요 - API 개요 및 빠른 시작

개요​

스크립트 설정 (script_config)​

매개변수​

예제​

단일 게시물에 댓글 작성​

여러 댓글 옵션 사용​

여러 게시물에 댓글 작성​

예약된 댓글​

이모지 삽입이 있는 댓글​

사용자명 목록 패턴별 댓글​

여러 기기에서 일괄 댓글​

Instagram 댓글 예제​

TikTok 이미지 댓글 예제​

응답​

댓글 순서​

무작위 순서 (random)​

순차 순서 (sequential)​

게시물 URL 형식​

TikTok​

Instagram​

Threads​

모범 사례​

오류 코드​

참조​

개요