TikTok Tasks

Fresh

Add Video/Album/Warmup Task

URL: https://openapi.geelark.com/open/v1/task/addMethod: POST

Publish Video Parameters

Parameter	Required	Type	Description
scheduleAt	Yes	integer	Scheduled time (seconds timestamp)
envId	Yes	string	Cloud phone ID
video	Yes	string	Video URL (from upload API)
videoDesc	No	string	Description (max 4000 chars)
productId	No	string	Product ID
productTitle	No	string	Product display title
refVideoId	No	string	Similar video ID
maxTryTimes	No	integer	Auto-retry count (0-3, default 3)
timeoutMin	No	integer	Timeout (30-80 min, default 80)
sameVideoVolume	No	integer	Same video volume (0-100)
sourceVideoVolume	No	integer	Original video volume (0-100)
markAI	No	bool	Mark as AI-generated (default false)
cover	No	string	Cover image URL
needShareLink	No	bool	Get share link (default false)

Warmup Parameters

Parameter	Required	Type	Description
scheduleAt	Yes	integer	Scheduled time (seconds timestamp)
envId	Yes	string	Cloud phone ID
action	Yes	string	search profile, search video, browse video
keywords	No	array[string]	Search keywords
duration	Yes	integer	Duration in minutes

Album/Image Set Parameters

Parameter	Required	Type	Description
scheduleAt	Yes	integer	Scheduled time
envId	Yes	string	Cloud phone ID
images	Yes	array	Image URLs
videoDesc	No	string	Description (max 4000 chars)
videoTitle	No	string	Gallery title (max 90 chars)
productId	No	string	Product ID
markAI	No	bool	Mark as AI-generated
needShareLink	No	bool	Get share link

Request Examples

Warmup

{
  "planName": "testAdd",
  "taskType": 2,
  "list": [
    {
      "scheduleAt": 1718744459,
      "envId": "123456654321",
      "action": "search video",
      "keywords": ["hi"],
      "duration": 10
    }
  ]
}

Publish Video

{
  "planName": "testAdd",
  "taskType": 1,
  "list": [
    {
      "scheduleAt": 1718744459,
      "envId": "123456654321",
      "video": "https://demo.geelark.com/open-upload/DhRP36s3.mp4"
    }
  ]
}

Publish Album

{
  "planName": "testAdd",
  "taskType": 3,
  "list": [
    {
      "scheduleAt": 1718744459,
      "envId": "123456654321",
      "images": ["https://demo.geelark.com/img1.jpg", "https://demo.geelark.com/img2.jpg"]
    }
  ]
}

---

TikTok Login

URL: https://openapi.geelark.com/open/v1/rpa/task/tiktokLogin

Parameter	Required	Type	Description
name	No	string	Task name (max 128 chars)
remark	No	string	Remarks (max 200 chars)
scheduleAt	Yes	int	Scheduled time (timestamp)
id	Yes	string	Cloud phone ID
account	Yes	string	Account (max 64 chars)
password	Yes	string	Password (max 64 chars)

---

TikTok Profile Edit

URL: https://openapi.geelark.com/open/v1/rpa/task/tiktokEdit

Parameter	Required	Type	Description
scheduleAt	Yes	int	Scheduled time
id	Yes	string	Cloud phone ID
avatar	No	string	Avatar URL (1:1 aspect ratio)
nickName	No	string	Nickname (max 30 chars)
bio	No	string	Bio (max 160 chars)
site	No	string	Website URL (http/https)

---

TikTok Like (Star)

URL: https://openapi.geelark.com/open/v1/rpa/task/tiktokStar

Parameter	Required	Type	Description
scheduleAt	Yes	int	Scheduled time
id	Yes	string	Cloud phone ID
videoLink	Yes	string	Video URL to like
probability	No	int	Like probability (%)

Asia variant: https://openapi.geelark.com/open/v1/rpa/task/tiktokStarAsia

---

TikTok AI Comment

URL: https://openapi.geelark.com/open/v1/rpa/task/tiktokAIComment

Parameter	Required	Type	Description
scheduleAt	Yes	int	Scheduled time
id	Yes	string	Cloud phone ID
videoLink	No	string	Video URL (or random)
probability	No	int	Comment probability (%)

Asia variant: https://openapi.geelark.com/open/v1/rpa/task/tiktokAICommentAsia

---

TikTok DM (Direct Message)

URL: https://openapi.geelark.com/open/v1/rpa/task/tiktokDM

Parameter	Required	Type	Description
scheduleAt	Yes	int	Scheduled time
id	Yes	string	Cloud phone ID
targetUser	Yes	string	Target username
message	Yes	string	Message content

Asia variant: https://openapi.geelark.com/open/v1/rpa/task/tiktokDMAsia

---

TikTok Follow

URL: https://openapi.geelark.com/open/v1/rpa/task/tiktokFollow

Parameter	Required	Type	Description
scheduleAt	Yes	int	Scheduled time
id	Yes	string	Cloud phone ID
targetUser	Yes	string	Target username to follow

Asia variant: https://openapi.geelark.com/open/v1/rpa/task/tiktokFollowAsia

---

Error Codes

Code	Description
41000	Insufficient task credits
43004	Cloud phone has expired
41001	Insufficient balance
43018	Monthly cloud phone not bound to device
48004	Required app version not met