Aller au contenu principal

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ètreTypeRequisDéfautDescription
target_post_urlsstring[]Oui*[]Tableau d'URLs de publications à visionner (une tâche par URL)
target_post_urlstringOui*""URL unique ou plusieurs URLs séparées par des sauts de ligne/virgules
view_durationintegerNon10Secondes pour regarder la publication
view_durationsinteger[]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/

Threads​

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

Les liens threads.net fonctionnent aussi. Un lien /share/ ne fonctionne pas : son code est un identifiant différent de celui qu'utilise une page de publication, il est donc refusé plutôt que converti en une URL qui ne mène nulle part.

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​

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

Voir Aussi​