시청 스크립트 구성

이 페이지에서는 작업 생성에 사용되는 view 스크립트의 구성 매개변수를 설명합니다.

개요

view 스크립트는 TikTok 또는 Instagram의 게시물을 열고 설정한 시간 동안 시청합니다 — 시청 시간과 노출수를 높이는 데 유용합니다. API를 통해 여러 URL을 제공하면 URL당 하나의 작업이 생성됩니다. start_time 매개변수로 각 작업의 실행 시간을 제어할 수 있습니다.

스크립트 구성 (script_config)

시청 스크립트의 구성 매개변수:

매개변수

매개변수	유형	필수	기본값	설명
target_post_urls	string[]	Yes*	[]	시청할 게시물 URL 배열(URL당 한 작업)
target_post_url	string	Yes*	""	단일 URL 또는 줄바꿈/쉼표로 구분된 여러 URL
view_duration	integer	No	10	게시물을 시청할 초 수
view_durations	integer[]	No	—	[min, max] 초 범위; 범위 내 랜덤 값이 사용됩니다. view_duration보다 우선 적용됩니다

노트

target_post_urls 배열 또는 target_post_url 문자열 중 하나를 제공해야 합니다. 둘 다 제공되면 target_post_urls가 우선 적용됩니다.

작업 생성

여러 URL을 제공하면 API는 URL당 하나의 작업을 생성합니다. 예를 들어, URL 3개와 기기 2대를 지정하면 6개의 작업이 생성됩니다. start_time 매개변수로 작업 시작 시간을 제어하세요.

예제

단일 게시물 시청

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"
    }
  }'

고정 시청 시간으로 시청

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
    }
  }'

랜덤 시청 시간 범위로 시청

작업당 15~45초 사이의 랜덤 시청 시간이 사용됩니다:

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]
    }
  }'

사용자 이름 목록으로 시청

특정 계정에 시청 작업을 직접 생성:

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
    }
  }'

Instagram 예제

Instagram 게시물과 릴스에도 동일한 API를 사용할 수 있습니다:

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]
    }
  }'

응답

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

게시물 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/

모범 사례

1. 시청 시간 변화 주기: 고정 view_duration 대신 view_durations를 사용해 더 자연스럽게 보이도록 합니다.

2. 작업 예약: start_time 매개변수로 시청을 시간에 걸쳐 분산시킵니다.

3. 멀티 계정 활용: enable_multi_account를 활성화해 같은 기기의 여러 계정으로 게시물을 시청합니다.

오류 코드

Code	설명
40001	대상 게시물 URL 없음
40003	API를 통해 지원되지 않는 스크립트
40301	API 액세스에는 Pro+ 플랜 필요

참고 항목

• 좋아요 스크립트 구성 - 게시물 좋아요
• 즐겨찾기 스크립트 구성 - 게시물을 즐겨찾기에 저장
• 작업 관리 API - 작업 생성, 목록 조회 및 관리
• 로컬 API 개요 - API 개요 및 빠른 시작