본문으로 건너뛰기

리포스트 스크립트 설정

이 페이지는 태스크 생성 시 사용되는 repost 스크립트의 설정 매개변수를 설명합니다.

개요​

repost 스크립트는 TikTok 동영상을 자동으로 리포스트하는 데 사용됩니다. API를 통해 여러 대상 게시물 URL을 제공하면 URL당 하나의 태스크가 생성됩니다. start_time 매개변수를 사용하여 각 태스크의 실행 시간을 제어할 수 있습니다.

TikTok 전용

repost 스크립트는 TikTok만 지원합니다. Instagram에는 네이티브 리포스트 기능이 없습니다.

스크립트 설정 (script_config)​

script_config 객체에는 리포스트 스크립트의 매개변수가 포함됩니다. 사용 가능한 매개변수는 다음과 같습니다:

매개변수​

매개변수유형필수기본값설명
target_post_urlsstring[]Yes*[]리포스트할 대상 게시물 URL 배열 (URL당 하나의 태스크)
target_post_urlstringYes*""단일 대상 게시물 URL 또는 줄바꿈/쉼표로 구분된 여러 URL
노트

target_post_urls 배열 또는 target_post_url 문자열 중 하나를 제공해야 합니다. 둘 다 제공되면 target_post_urls가 우선합니다.

태스크 생성

여러 대상 게시물 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": "repost",
    "script_config": {
      "target_post_url": "https://www.tiktok.com/@username/video/1234567890"
    }
  }'

여러 게시물 리포스트​

여러 게시물을 리포스트할 때 게시물당 하나의 태스크가 생성됩니다:

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1"],
    "script_name": "repost",
    "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"
      ]
    }
  }'

3개의 독립적인 태스크가 즉시 실행됩니다.

시작 시간으로 리포스트 예약​

start_time을 사용하여 태스크 시작 시간을 예약합니다:

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

사용자 이름 목록 모드로 리포스트​

특정 계정에 대한 리포스트 태스크를 직접 생성합니다:

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "usernames": ["@my_account1", "@my_account2"],
    "script_name": "repost",
    "script_config": {
      "target_post_url": "https://www.tiktok.com/@target/video/123"
    }
  }'

여러 기기에서 일괄 리포스트​

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_1", "device_2", "device_3"],
    "script_name": "repost",
    "script_config": {
      "target_post_url": "https://www.tiktok.com/@viral/video/999"
    },
    "enable_multi_account": true
  }'

응답​

{
  "code": 0,
  "message": "success",
  "data": {
    "task_ids": [401, 402, 403],
    "created_count": 3
  }
}

게시물 URL 형식​

TikTok​

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

리포스트 작동 방식​

  1. 스크립트가 대상 게시물 URL을 엽니다.
  2. 이미 리포스트되었는지 확인합니다 — 이미 된 경우 중복을 방지하기 위해 건너뜁니다.
  3. 공유 버튼을 클릭한 다음 공유 메뉴에서 리포스트를 선택합니다.
  4. 리포스트 작업을 확인합니다.

모범 사례​

  1. 태스크 예약: start_time 매개변수를 사용하여 리포스트를 시간 분산시켜 속도 제한 가능성을 줄이세요.

  2. 현명하게 일괄 처리: 한 번에 너무 많은 리포스트 태스크를 생성하지 마세요. 플랫폼에는 리포스트에 대한 속도 제한이 있을 수 있습니다.

  3. 멀티 계정 모드 사용: enable_multi_account를 활성화하여 같은 기기의 여러 계정으로 동영상을 리포스트하세요.

오류 코드​

CodeDescription
40001대상 게시물 URL 누락
40003API를 통해 스크립트가 지원되지 않음
40301API 접근에는 Pro+ 플랜 필요

참고 항목​