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/

Threads​

https://www.threads.com/@username/post/ABCDEFGHIJK
https://www.threads.com/t/ABCDEFGHIJK

Các liên kết threads.net cũng hoạt động. Liên kết /share/ không hoạt động: mã của nó là một định danh khác với mã mà trang bài viết sử dụng, vì vậy nó bị từ chối thay vì được chuyển đổi thành URL không chỉ đến đâu cả.

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​