Перейти до основного вмісту

Конфігурація скрипту Follow

Ця сторінка документує параметри конфігурації скрипту follow, що використовується під час створення задач.

Огляд​

Скрипт follow використовується для автоматичної підписки на користувачів у TikTok чи Instagram. Коли ви надаєте кілька цільових користувачів через API, для кожного цільового користувача створюється одна задача. Ви можете контролювати, коли виконується кожна задача, за допомогою параметра start_time.

Конфігурація скрипту (script_config)​

Об'єкт script_config містить параметри для скрипту follow. Нижче наведено доступні параметри:

Параметри​

ПараметрТипОбов'язковийЗа замовчуваннямОпис
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 '{
    "usernames": ["@my_account1", "@my_account2"],
    "script_name": "follow",
    "script_config": {
      "target_users": ["@target_user"],
      "access_method": "direct"
    }
  }'

Масова підписка на кількох пристроях​

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 або threads.com/@username
  • Швидше й надійніше
  • Рекомендовано для більшості випадків використання
  • Єдиний метод доступу, доступний на Threads
  • Переходить до пошуку, вводить ім'я користувача, натискає на результат
  • Недоступно на Threads — завдання, яке це запитує, завершується помилкою замість спроби вгадати інтерфейс пошуку
  • Повільніше, але працює, коли прямий доступ через URL заблоковано
  • Може бути менш точним, якщо існує кілька схожих імен користувачів

Найкращі практики​

  1. Використовуйте start_time для планування: використовуйте параметр start_time, щоб запланувати, коли мають виконуватися задачі (формат: «ГГ:ХХ»).

  2. Надавайте перевагу прямому доступу: метод доступу direct швидший і надійніший, ніж search.

  3. Розумно формуйте пакети: не підписуйтеся на занадто багато користувачів одразу. Система створює одну задачу на кожного цільового користувача, тож великі списки призводять до багатьох задач.

Дивіться також​