Configuración del Script View

Esta página documenta los parámetros de configuración del script view para la creación de tareas.

Descripción General

El script view abre una publicación en TikTok o Instagram y la ve durante una duración configurable — útil para aumentar el tiempo de visualización/impresiones. Cuando proporcionas múltiples URLs de publicaciones vía API, se crea una tarea por cada URL. Puedes controlar cuándo se ejecuta cada tarea usando el parámetro start_time.

Configuración del Script (script_config)

El objeto script_config contiene los parámetros del script view. A continuación se muestran los parámetros disponibles:

Parámetros

Parámetro	Tipo	Requerido	Predeterminado	Descripción
target_post_urls	string[]	Sí*	[]	Array de URLs de publicaciones a ver (una tarea por URL)
target_post_url	string	Sí*	""	URL única o múltiples URLs separadas por saltos de línea/comas
view_duration	integer	No	10	Segundos para ver la publicación
view_durations	integer[]	No	—	Rango [min, max] en segundos; se usa un valor aleatorio dentro del rango. Tiene prioridad sobre view_duration

nota

Se debe proporcionar el array target_post_urls o el string target_post_url. Si se proporcionan ambos, target_post_urls tiene prioridad.

Creación de Tareas

Cuando se proporcionan múltiples URLs, la API crea una tarea por URL. Por ejemplo, 3 URLs + 2 dispositivos = 6 tareas. Usa el parámetro start_time para controlar cuándo se ejecuta cada tarea.

Ejemplos

Ver una Publicación

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

Ver con Duración Fija

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

Ver con Duración Aleatoria

Se usa un tiempo de visualización aleatorio entre 15 y 45 segundos por tarea:

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

Ver por Lista de Usuarios

Crea tareas de visualización para cuentas específicas:

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

Ejemplo de Instagram

La misma API funciona para publicaciones y reels de 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]
    }
  }'

Respuesta

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

Formatos de 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

Los enlaces threads.net también funcionan. Un enlace /share/ no funciona: su código es un identificador diferente del que usa una página de publicación, así que se rechaza en lugar de convertirse en un enlace que no apunta a nada.

Mejores Prácticas

1. Varía el tiempo de visualización: Prefiere view_durations sobre un view_duration fijo para que cada visualización parezca más natural.

2. Programa las tareas: Usa el parámetro start_time para distribuir las visualizaciones en el tiempo.

3. Usa el modo multi-cuenta: Habilita enable_multi_account para ver publicaciones usando múltiples cuentas en el mismo dispositivo.

Códigos de Error

Código	Descripción
40001	URL de publicación objetivo faltante
40003	Script no soportado vía API
40301	El acceso a la API requiere plan Pro+

Ver También

• Configuración del Script Like - Dar me gusta a publicaciones
• Configuración del Script Favorite - Guardar publicaciones en Favoritos
• API de Gestión de Tareas - Crear, listar y gestionar tareas
• Visión General de la API Local - Descripción general y inicio rápido