メインコンテンツまでスキップ

リポストスクリプト設定

現在の動作\nrepost は TikTok と Threads に対応しています。Threads では Threads の投稿 URL と platform: threads を指定してください。下の TikTok のみという説明は旧バージョンの内容です。\n:::

このページでは、タスク作成時に使用する repost スクリプトの設定パラメータを説明します。

概要​

repost スクリプトは、TikTok動画を自動的にリポストするために使用します。APIで複数のターゲット投稿URLを指定すると、URLごとに1つのタスクが作成されます。start_time パラメータを使用して各タスクの実行時間を制御できます。

TikTokのみ

repost スクリプトは TikTok のみをサポートしています。Instagramにはネイティブのリポスト機能がありません。

スクリプト設定 (script_config)​

script_config オブジェクトにはリポストスクリプトのパラメータが含まれます。利用可能なパラメータは以下の通りです：

パラメータ​

パラメータ型必須デフォルト説明
target_post_urlsstring[]Yes*[]リポストするターゲット投稿URLの配列（URLごとに1タスク）
target_post_urlstringYes*""単一のターゲット投稿URL、または改行/カンマ区切りの複数URL
注記

target_post_urls 配列または target_post_url 文字列のいずれかを指定する必要があります。両方指定した場合、target_post_urls が優先されます。

タスク作成

複数のターゲット投稿URLを指定すると、APIは URLごとに1つのタスク を作成します。例えば、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が不足
40003スクリプトはAPIでサポートされていません
40301APIアクセスにはPro+プランが必要

関連項目​