Skip to main content

Repost Script Configuration

This page documents the configuration parameters for the repost script used in task creation.

Overview​

The repost script is used to automatically repost TikTok videos or Threads posts. When you provide multiple target post URLs via API, one task is created per target post URL. You can control when each task executes using the start_time parameter.

Platform support

repost is available on TikTok and Threads. Instagram does not have a native repost feature in this runner.

Script Configuration (script_config)​

The script_config object contains the parameters for the repost script. Below are the available parameters:

Parameters​

ParameterTypeRequiredDefaultDescription
target_post_urlsstring[]Yes*[]Array of target post URLs to repost (one task per URL)
target_post_urlstringYes*""Single target post URL or multiple URLs separated by newlines/commas
note

Either target_post_urls array or target_post_url string must be provided. If both are provided, target_post_urls takes priority.

Task Creation

When multiple target post URLs are provided, the API creates one task per target post URL. For example, if you specify 3 post URLs and 2 devices, 6 tasks will be created. Use the start_time parameter to control when tasks start executing.

Examples​

Repost a Single Post​

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"
    }
  }'

Repost Multiple Posts​

When reposting multiple posts, one task is created per post:

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"
      ]
    }
  }'

This creates 3 separate tasks that execute immediately.

Repost a Threads Post​

Use a Threads post URL and set platform explicitly when running the Pro build:

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1"],
    "script_name": "repost",
    "platform": "threads",
    "script_config": {
      "target_post_url": "https://www.threads.net/@username/post/ABC123"
    }
  }'

Schedule Reposts with Start Time​

Use start_time to schedule when tasks should start:

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"
  }'

Repost by Username List Mode​

Create repost tasks directly for specific accounts:

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"
    }
  }'

Batch Repost on Multiple Devices​

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
  }'

Response​

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

Post URL Formats​

TikTok​

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

Threads​

https://www.threads.net/@username/post/ABC123
https://threads.net/@username/post/ABC123

How Repost Works​

  1. The script opens the target post URL in the selected platform app.
  2. It checks if the post is already reposted — if so, it skips to avoid duplicate reposts.
  3. It clicks the platform's Share button, then selects Repost from the share menu.
  4. It confirms the repost action.

Best Practices​

  1. Schedule tasks: Use the start_time parameter to spread out reposts over time, reducing the chance of rate limiting.

  2. Batch wisely: Don't create too many repost tasks at once. Platforms may have rate limits on reposting.

  3. Use multi-account mode: Enable enable_multi_account to repost videos using multiple accounts on the same device.

Error Codes​

CodeDescription
40001Missing target post URL
40003Script not supported via API
40301API access requires Pro+ plan

See Also​