プロフィールスクリプト設定

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

Overview

The profile script is used to automatically update the profile of a TikTok or Instagram account. It can update the avatar, nickname, username, bio, and link URL.

Script Configuration (`script_config`)

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

Parameters

Parameter	Type	Required	Default	Description
username	string	No	""	The username of the account whose profile to update. Used in device-based mode.
avatars_path	string	No	""	Path to a folder containing avatar images. Leave empty to skip avatar update.
nickname	string	No	""	Single nickname to set. Takes priority over `nicknames`.
nicknames	string	No	""	Multiple nicknames separated by newlines. One is selected based on `profile_order`.
username_to	string	No	""	New username to set. Takes priority over `usernames`.
usernames	string	No	""	Multiple new usernames separated by newlines. One is selected based on `profile_order`.
bio	string	No	""	Single bio text to set. Takes priority over `bios`.
bios	string	No	""	Multiple bio texts separated by newlines. One is selected based on `profile_order`.
link_url	string	No	""	Single link URL to set. Takes priority over `link_urls`.
link_urls	string	No	""	Multiple link URLs separated by newlines. One is selected based on `profile_order`.
profile_order	string	No	"random"	How to select content when using multi-value fields: `random` or `sequential`.
job_count	integer	No	0	Job counter used for sequential selection. Automatically set by the system.

注記

At least one of the profile fields (avatar, nickname, username_to, bio, link_url) should be provided. Otherwise the script will run but make no changes.

Examples

Update Nickname

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1"],
    "script_name": "profile",
    "script_config": {
      "username": "@my_account",
      "nickname": "My New Nickname"
    }
  }'

Update Bio and Link

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1"],
    "script_name": "profile",
    "script_config": {
      "username": "@my_account",
      "bio": "Check out my latest content!",
      "link_url": "https://example.com"
    }
  }'

Update Avatar

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1"],
    "script_name": "profile",
    "script_config": {
      "username": "@my_account",
      "avatars_path": "C:/avatars/"
    }
  }'

Update Multiple Accounts with Different Nicknames

Use nicknames with profile_order: sequential to assign different nicknames across accounts:

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1", "device_serial_2", "device_serial_3"],
    "script_name": "profile",
    "script_config": {
      "nicknames": "Nickname One\nNickname Two\nNickname Three",
      "profile_order": "sequential",
      "bio": "Follow me for amazing content!"
    }
  }'

Update Profile by Username Mode

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "usernames": ["@account1", "@account2"],
    "script_name": "profile",
    "script_config": {
      "nickname": "New Brand Name",
      "bio": "Updated bio for all accounts",
      "link_url": "https://mybrand.com"
    }
  }'

Schedule Profile Update

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1"],
    "script_name": "profile",
    "script_config": {
      "username": "@my_account",
      "nickname": "Updated Nickname",
      "bio": "Fresh content every day!"
    },
    "start_time": "10:00"
  }'

Response

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

Profile Order

Random Order (`random`)

Randomly selects one value from multi-value fields (nicknames, bios, etc.)
Default behavior

Sequential Order (`sequential`)

Selects values in order based on job_count
First task uses first value, second task uses second value, etc.
Cycles back to beginning when reaching the end
Good for assigning different values to different accounts

Error Codes

Code	Description
40001	Missing required parameters
40003	Script not supported via API
40301	API access requires Pro+ plan

Overview​

Script Configuration (script_config)​

Parameters​

Examples​

Update Nickname​

Update Bio and Link​

Update Avatar​

Update Multiple Accounts with Different Nicknames​

Update Profile by Username Mode​

Schedule Profile Update​

Response​

Profile Order​

Random Order (random)​

Sequential Order (sequential)​

Error Codes​

See Also​