Configuration du Script View

Cette page documente les paramètres de configuration du script view pour la création de tâches.

Description Générale

Le script view ouvre une publication sur TikTok ou Instagram et la regarde pendant une durée configurable — utile pour augmenter le temps de visionnage/les impressions. Lorsque vous fournissez plusieurs URLs de publications via l'API, une tâche est créée par URL. Vous pouvez contrôler le moment d'exécution de chaque tâche avec le paramètre start_time.

Configuration du Script (script_config)

L'objet script_config contient les paramètres du script view. Voici les paramètres disponibles :

Paramètres

Paramètre	Type	Requis	Défaut	Description
target_post_urls	string[]	Oui*	[]	Tableau d'URLs de publications à visionner (une tâche par URL)
target_post_url	string	Oui*	""	URL unique ou plusieurs URLs séparées par des sauts de ligne/virgules
view_duration	integer	Non	10	Secondes pour regarder la publication
view_durations	integer[]	Non	—	Plage [min, max] en secondes ; une valeur aléatoire dans la plage est utilisée. Prioritaire sur view_duration

remarque

Le tableau target_post_urls ou le string target_post_url doit être fourni. Si les deux sont fournis, target_post_urls est prioritaire.

Création de Tâches

Lorsque plusieurs URLs sont fournies, l'API crée une tâche par URL. Par exemple, 3 URLs + 2 appareils = 6 tâches. Utilisez le paramètre start_time pour contrôler quand chaque tâche s'exécute.

Exemples

Visionner une Publication

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

Visionner avec une Durée Fixe

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

Visionner avec une Durée Aléatoire

Un temps de visionnage aléatoire entre 15 et 45 secondes est utilisé par tâche :

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

Visionner par Liste d'Utilisateurs

Créer des tâches de visionnage pour des comptes spécifiques :

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

Exemple Instagram

La même API fonctionne pour les publications et 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]
    }
  }'

Réponse

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

Formats d'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/

Meilleures Pratiques

1. Variez le temps de visionnage : Préférez view_durations à un view_duration fixe pour que chaque vue paraisse plus naturelle.

2. Planifiez les tâches : Utilisez le paramètre start_time pour répartir les vues dans le temps.

3. Utilisez le mode multi-compte : Activez enable_multi_account pour visionner des publications avec plusieurs comptes sur le même appareil.

Codes d'Erreur

Code	Description
40001	URL de publication cible manquante
40003	Script non pris en charge via API
40301	L'accès à l'API nécessite un forfait Pro+

Voir Aussi

• Configuration du Script Like - Aimer des publications
• Configuration du Script Favorite - Enregistrer des publications dans les Favoris
• API de Gestion des Tâches - Créer, lister et gérer les tâches
• Aperçu de l'API Locale - Description générale et démarrage rapide