Chuyển tới nội dung chính

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ểuBắt buộcMặc địnhMô tả
target_post_urlsstring[]Yes*[]Mảng URL bài đăng mục tiêu để xem (một tác vụ mỗi URL)
target_post_urlstringYes*""URL đơn lẻ hoặc nhiều URL phân cách bằng dòng mới/dấu phẩy
view_durationintegerNo10Số giây xem bài đăng
view_durationsinteger[]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​

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

Xem thêm​