Configuración del Script Favorite

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

Descripción General

El script favorite añade una publicación a Favoritos (en TikTok) / Guardados (en Instagram). 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.

Las publicaciones ya guardadas en favoritos se omiten

El script detecta publicaciones que ya están en favoritos/guardadas y las omite, por lo que volver a ejecutar una tarea no las eliminará de favoritos.

Configuración del Script (script_config)

El objeto script_config contiene los parámetros del script favorite. 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 guardar en favoritos (una tarea por URL)
target_post_url	string	Sí*	""	URL única o múltiples URLs separadas por saltos de línea/comas

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

Guardar una Publicación en Favoritos

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1"],
    "script_name": "favorite",
    "script_config": {
      "target_post_url": "https://www.tiktok.com/@username/video/1234567890"
    }
  }'

Guardar Múltiples Publicaciones en Favoritos

Al guardar múltiples publicaciones, se crea una tarea por publicación:

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1"],
    "script_name": "favorite",
    "script_config": {
      "target_post_urls": [
        "https://www.tiktok.com/@user1/video/111",
        "https://www.tiktok.com/@user2/video/222",
        "https://www.tiktok.com/@user3/video/333"
      ]
    }
  }'

Esto crea 3 tareas independientes que se ejecutan de inmediato.

Programar Favoritos con Hora de Inicio

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1"],
    "script_name": "favorite",
    "script_config": {
      "target_post_url": "https://www.tiktok.com/@username/video/1234567890"
    },
    "start_time": "14:30"
  }'

Guardar en Favoritos por Lista de Usuarios

Crea tareas de favoritos directamente 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": "favorite",
    "script_config": {
      "target_post_url": "https://www.tiktok.com/@target/video/123"
    }
  }'

Ejemplo de Instagram (Guardar)

En Instagram el script favorite guarda la publicación (marcador):

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1"],
    "script_name": "favorite",
    "script_config": {
      "target_post_url": "https://www.instagram.com/p/ABC123/"
    }
  }'

Respuesta

{
  "code": 0,
  "message": "success",
  "data": {
    "task_ids": [601, 602, 603],
    "created_count": 3
  }
}

Formatos de URL de Publicaciones

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/

Mejores Prácticas

1. Programa las tareas: Usa el parámetro start_time para distribuir las acciones en el tiempo, reduciendo la posibilidad de limitaciones de velocidad.

2. Usa el modo multi-cuenta: Habilita enable_multi_account para guardar publicaciones en favoritos 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 View - Ver publicaciones durante una duración
• 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