Cấu hình Script View

Trang này ghi lại các tham số cấu hình của script view.

Tổng quan

Script view mở bài đăng trên TikTok hoặc Instagram và xem trong khoảng thời gian có thể cấu hình — hữu ích để tăng thời gian xem / lượt hiển thị. Với nhiều URL qua API, một tác vụ được tạo cho mỗi URL. Kiểm soát thời gian bằng start_time.

Cấu hình Script (script_config)

Tham số cấu hình script view:

Tham số

Tham số	Kiểu	Bắt buộc	Mặc định	Mô tả
target_post_urls	string[]	Yes*	[]	Mảng URL bài đăng mục tiêu để xem (một tác vụ mỗi URL)
target_post_url	string	Yes*	""	URL đơn lẻ hoặc nhiều URL phân cách bằng dòng mới/dấu phẩy
view_duration	integer	No	10	Số giây xem bài đăng
view_durations	integer[]	No	—	Khoảng [min, max] tính bằng giây; một giá trị ngẫu nhiên trong khoảng được dùng. Ưu tiên hơn view_duration

ghi chú

Phải cung cấp mảng target_post_urls hoặc chuỗi target_post_url. Nếu cả hai, target_post_urls được ưu tiên.

Tạo tác vụ

Với nhiều URL, API tạo một tác vụ cho mỗi URL. Ví dụ: 3 URL + 2 thiết bị = 6 tác vụ.

Ví dụ

Xem một bài đăng

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

Xem với thời lượng cố định

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

Xem với khoảng thời lượng ngẫu nhiên

Thời gian xem ngẫu nhiên từ 15–45 giây mỗi tác vụ:

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1"],
    "script_name": "view",
    "script_config": {
      "target_post_urls": [
        "https://www.tiktok.com/@user1/video/111",
        "https://www.tiktok.com/@user2/video/222"
      ],
      "view_durations": [15, 45]
    }
  }'

Xem theo danh sách tên người dùng

Tạo tác vụ xem trực tiếp cho các tài khoản cụ thể:

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "usernames": ["@my_account1", "@my_account2"],
    "script_name": "view",
    "script_config": {
      "target_post_url": "https://www.tiktok.com/@target/video/123",
      "view_duration": 20
    }
  }'

Ví dụ Instagram

API tương tự cho bài đăng và reels Instagram:

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

Phản hồi

{
  "code": 0,
  "message": "success",
  "data": {
    "task_ids": [501, 502],
    "created_count": 2
  }
}

Định dạng 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/

Thực hành tốt nhất

1. Đa dạng thời gian xem: Ưu tiên view_durations thay vì view_duration cố định để mỗi lượt xem trông tự nhiên hơn.

2. Lên lịch tác vụ: Dùng start_time để phân tán lượt xem theo thời gian.

3. Đa tài khoản: Bật enable_multi_account để xem bài bằng nhiều tài khoản trên cùng thiết bị.

Mã lỗi

Code	Description
40001	Thiếu URL bài đăng mục tiêu
40003	Script không được hỗ trợ qua API
40301	Yêu cầu gói Pro+

Xem thêm

• Cấu hình Script Like - Thích bài đăng
• Cấu hình Script Favorite - Lưu bài đăng vào Yêu thích
• API Quản lý Tác vụ - Tạo, liệt kê và quản lý tác vụ
• Tổng quan Local API - Tổng quan API và bắt đầu nhanh