Skip to main content

Unfollow Script Configuration

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

Overview​

The unfollow script is used to automatically unfollow users on TikTok or Instagram. When you provide multiple target users via API, one task is created per target user. You can control when each task executes using the start_time parameter.

Script Configuration (script_config)​

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

Parameters​

ParameterTypeRequiredDefaultDescription
target_usersstring[]Yes*[]Array of target usernames to unfollow (one task per user)
target_userstringYes*""Single target username or multiple usernames separated by newlines/commas
access_methodstringNo"direct"How to navigate to user profile: direct (via URL) or search
note

Either target_users array or target_user string must be provided. If both are provided, target_users takes priority.

Task Creation

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

Examples​

Unfollow Single User​

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1"],
    "script_name": "unfollow",
    "script_config": {
      "target_users": ["@username_to_unfollow"],
      "access_method": "direct"
    }
  }'

Unfollow Multiple Users​

When unfollowing multiple users, one task is created per user:

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1"],
    "script_name": "unfollow",
    "script_config": {
      "target_users": ["@user1", "@user2", "@user3"],
      "access_method": "direct"
    }
  }'

This creates 3 separate tasks that execute immediately.

Schedule Tasks 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": "unfollow",
    "script_config": {
      "target_users": ["@user1", "@user2"],
      "access_method": "direct"
    },
    "start_time": "14:30"
  }'

Unfollow Users via Search Method​

Use the search method when direct URL access is not working:

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1"],
    "script_name": "unfollow",
    "script_config": {
      "target_users": ["username1", "username2"],
      "access_method": "search"
    }
  }'

Batch Unfollow 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": "unfollow",
    "script_config": {
      "target_users": ["@old_account"],
      "access_method": "direct"
    },
    "enable_multi_account": true
  }'

Response​

{
  "code": 0,
  "message": "success",
  "data": {
    "task_ids": [201, 202, 203],
    "created_count": 3
  }
}

Access Methods​

Direct Method (direct)​

  • Opens user profile via URL: tiktok.com/@username, instagram.com/username or threads.com/@username
  • Faster and more reliable
  • Recommended for most use cases
  • The only access method available on Threads
  • Navigates to search, types username, clicks on result
  • Not available on Threads — a task that asks for it fails rather than guessing at the search UI
  • Slower but works when direct URL access is blocked
  • May be less accurate if multiple similar usernames exist

Best Practices​

  1. Use start_time for scheduling: Use the start_time parameter to schedule when tasks should execute (format: "HH:MM").

  2. Prefer direct access: The direct access method is faster and more reliable than search.

  3. Batch wisely: Don't unfollow too many users at once. The system creates one task per target user, so large lists result in many tasks.

See Also​