Pular para o conteúdo principal

Configuração do Script Favorite

Esta página documenta os parâmetros de configuração do script favorite para criação de tarefas.

Visão Geral​

O script favorite adiciona uma publicação aos Favoritos (no TikTok) / Salvos (no Instagram). Quando você fornece múltiplas URLs de publicações via API, uma tarefa é criada por URL. Você pode controlar quando cada tarefa é executada usando o parâmetro start_time.

As publicações já salvas nos Favoritos são ignoradas

O script detecta publicações que já foram salvas nos Favoritos/Salvos e as ignora, portanto reexecutar uma tarefa não removerá a publicação dos Favoritos.

Configuração do Script (script_config)​

O objeto script_config contém os parâmetros do script favorite. Abaixo estão os parâmetros disponíveis:

Parâmetros​

ParâmetroTipoObrigatórioPadrãoDescrição
target_post_urlsstring[]Sim*[]Array de URLs de publicações para salvar nos Favoritos (uma tarefa por URL)
target_post_urlstringSim*""URL única ou múltiplas URLs separadas por quebras de linha/vírgulas
observação

O array target_post_urls ou o string target_post_url deve ser fornecido. Se ambos forem fornecidos, target_post_urls tem prioridade.

Criação de Tarefas

Quando múltiplas URLs são fornecidas, a API cria uma tarefa por URL. Por exemplo, 3 URLs + 2 dispositivos = 6 tarefas. Use o parâmetro start_time para controlar quando cada tarefa é executada.

Exemplos​

Salvar uma Publicação nos 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"
    }
  }'

Salvar Múltiplas Publicações nos Favoritos​

Ao salvar múltiplas publicações, uma tarefa é criada por publicação:

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

Isso cria 3 tarefas separadas que são executadas imediatamente.

Agendar Favoritos com Hora de Início​

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

Salvar nos Favoritos por Lista de Usuários​

Cria tarefas de favoritos diretamente para contas 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"
    }
  }'

Exemplo do Instagram​

No Instagram, o script favorite salva a publicação (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/"
    }
  }'

Resposta​

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

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

Links threads.net também funcionam. Um link /share/ não funciona: seu código é um identificador diferente do que uma página de postagem usa, então é rejeitado em vez de ser transformado em uma URL que não aponta para nada.

Melhores Práticas​

  1. Agende as tarefas: Use o parâmetro start_time para distribuir as ações ao longo do tempo, reduzindo a chance de limitação de taxa.

  2. Use o modo multi-conta: Ative enable_multi_account para salvar publicações nos Favoritos usando múltiplas contas no mesmo dispositivo.

Códigos de Erro​

CódigoDescrição
40001URL da publicação alvo ausente
40003Script não suportado via API
40301Acesso à API requer plano Pro+

Veja Também​