Saltar al contenido principal

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ámetroTipoRequeridoPredeterminadoDescripción
target_post_urlsstring[]Sí*[]Array de URLs de publicaciones a guardar en favoritos (una tarea por URL)
target_post_urlstringSí*""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/

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. 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ódigoDescripción
40001URL de publicación objetivo faltante
40003Script no soportado vía API
40301El acceso a la API requiere plan Pro+

Ver También​