お気に入りスクリプト設定

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

概要

favorite スクリプトは投稿を TikTok のお気に入り / Instagram の保存済みに追加します。API で複数の URL を指定すると、URL ごとに 1 つのタスクが作成されます。start_time パラメータで各タスクの実行時間を制御できます。

すでにお気に入りに追加済みの投稿はスキップされます

スクリプトはすでにお気に入り登録済みの投稿を検出してスキップするため、タスクを再実行してもお気に入りが解除されることはありません。

スクリプト設定 (`script_config`)

お気に入りスクリプトの設定パラメータ：

パラメータ

パラメータ	型	必須	デフォルト	説明
target_post_urls	string[]	Yes*	[]	お気に入りに追加する投稿 URL の配列（URL ごとに 1 タスク）
target_post_url	string	Yes*	""	単一の URL、または改行/カンマ区切りの複数 URL

注記

target_post_urls 配列または target_post_url 文字列のどちらかが必要です。両方指定した場合、target_post_urls が優先されます。

タスク作成

複数の URL を指定すると、API は URL ごとに 1 つのタスクを作成します。たとえば、3 つの URL と 2 台のデバイスを指定すると、6 つのタスクが作成されます。start_time パラメータでタスクの開始時間を制御してください。

例

1 件の投稿をお気に入りに追加

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

複数の投稿をお気に入りに追加

複数の投稿をお気に入りにする場合、投稿ごとに 1 つのタスクが作成されます：

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1"],
    "script_name": "favorite",
    "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 つの独立したタスクが即時作成されます。

開始時刻を指定してスケジュール

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1"],
    "script_name": "favorite",
    "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": "favorite",
    "script_config": {
      "target_post_url": "https://www.tiktok.com/@target/video/123"
    }
  }'

Instagram の保存例

Instagram では favorite スクリプトが投稿をブックマーク（保存）します：

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1"],
    "script_name": "favorite",
    "script_config": {
      "target_post_url": "https://www.instagram.com/p/ABC123/"
    }
  }'

レスポンス

{
  "code": 0,
  "message": "success",
  "data": {
    "task_ids": [601, 602, 603],
    "created_count": 3
  }
}

投稿 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/

ベストプラクティス

タスクをスケジュール: start_time パラメータでアクションを時間分散させ、レート制限のリスクを低減する。
マルチアカウントモードを活用: enable_multi_account を有効化して同一デバイスの複数アカウントでお気に入り登録する。

エラーコード

Code	説明
40001	対象投稿 URL が未指定
40003	API を通じてサポートされていないスクリプト
40301	API アクセスには Pro+ プランが必要

概要​

スクリプト設定 (script_config)​

パラメータ​

例​

1 件の投稿をお気に入りに追加​

複数の投稿をお気に入りに追加​

開始時刻を指定してスケジュール​

ユーザー名リストでお気に入り​

Instagram の保存例​

レスポンス​

投稿 URL 形式​

TikTok​

Instagram​

ベストプラクティス​

エラーコード​

関連ページ​

概要