본문으로 건너뛰기

팔로우 스크립트 설정

이 페이지는 작업 생성 시 follow 스크립트의 설정 매개변수를 소개합니다.

개요​

follow 스크립트는 TikTok 또는 Instagram에서 사용자를 자동으로 팔로우하는 데 사용됩니다. API를 통해 여러 대상 사용자를 제공할 때, 각 대상 사용자에 대해 하나의 작업이 생성됩니다. start_time 매개변수를 사용하여 작업의 실행 시간을 제어할 수 있습니다.

스크립트 설정 (script_config)​

script_config 객체는 팔로우 스크립트의 설정 매개변수를 포함합니다. 다음은 사용 가능한 매개변수입니다:

매개변수​

매개변수유형필수기본값설명
target_usersstring[]예*[]팔로우할 대상 사용자명 배열(각 사용자당 하나의 작업)
target_userstring예*""단일 대상 사용자명 또는 줄바꿈/쉼표로 구분된 여러 사용자명
access_methodstring아니요"direct"사용자 프로필로 이동하는 방법: direct(URL을 통해) 또는 search
노트

target_users 배열 또는 target_user 문자열을 제공해야 합니다. 둘 다 제공되면 target_users가 우선됩니다.

작업 생성

여러 대상 사용자를 제공할 때, API는 각 대상 사용자에 대해 하나의 작업을 생성합니다. 예를 들어 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": "follow",
    "script_config": {
      "target_users": ["@username_to_follow"],
      "access_method": "direct"
    }
  }'

여러 사용자 팔로우​

여러 사용자를 팔로우할 때, 각 사용자에 대해 하나의 작업이 생성됩니다:

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1"],
    "script_name": "follow",
    "script_config": {
      "target_users": ["@user1", "@user2", "@user3"],
      "access_method": "direct"
    }
  }'

이렇게 하면 3개의 독립적인 작업이 즉시 실행됩니다.

시작 시간을 사용한 작업 예약​

start_time을 사용하여 작업 시작 시간을 예약합니다:

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1"],
    "script_name": "follow",
    "script_config": {
      "target_users": ["@user1", "@user2"],
      "access_method": "direct"
    },
    "start_time": "14:30"
  }'

검색 방법으로 사용자 팔로우​

직접 URL 액세스가 작동하지 않을 때 검색 방법을 사용합니다:

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1"],
    "script_name": "follow",
    "script_config": {
      "target_users": ["username1", "username2"],
      "access_method": "search"
    }
  }'

다중 기기 일괄 팔로우​

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_1", "device_2", "device_3"],
    "script_name": "follow",
    "script_config": {
      "target_users": ["@influencer_account"],
      "access_method": "direct"
    },
    "enable_multi_account": true
  }'

응답​

{
  "code": 0,
  "message": "success",
  "data": {
    "task_ids": [201, 202, 203],
    "created_count": 3
  }
}

액세스 방법​

직접 액세스 (direct)​

  • URL을 통해 사용자 프로필을 엽니다: tiktok.com/@username 또는 instagram.com/username
  • 더 빠르고 안정적입니다
  • 대부분의 경우 권장됩니다
  • 검색으로 이동하여 사용자명을 입력하고 결과를 클릭합니다
  • 느리지만 직접 URL 액세스가 차단되었을 때 효과가 있습니다
  • 유사한 사용자명이 여러 개 있는 경우 부정확할 수 있습니다

모범 사례​

  1. start_time을 사용하여 예약: start_time 매개변수를 사용하여 작업의 실행 시간을 예약합니다(형식: "HH:MM").

  2. 직접 액세스 우선: direct 액세스 방법이 search보다 빠르고 더 안정적입니다.

  3. 합리적인 일괄 처리: 한 번에 너무 많은 사용자를 팔로우하지 마세요. 각 대상 사용자에 대해 하나의 작업이 생성되므로 큰 목록은 많은 작업을 생성합니다.

참조​