Pular para o conteúdo principal

Configuração do Script View

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

Visão Geral​

O script view abre uma publicação no TikTok ou Instagram e a assiste por uma duração configurável — útil para aumentar o tempo de visualização/impressões. 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.

Configuração do Script (script_config)​

O objeto script_config contém os parâmetros do script view. 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 assistir (uma tarefa por URL)
target_post_urlstringSim*""URL única ou múltiplas URLs separadas por quebras de linha/vírgulas
view_durationintegerNão10Segundos para assistir à publicação
view_durationsinteger[]Não—Intervalo [min, max] em segundos; um valor aleatório dentro do intervalo é usado. Tem prioridade sobre view_duration
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​

Assistir a uma Publicação​

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

Assistir com Duração Fixa​

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

Assistir com Duração Aleatória​

Um tempo de visualização aleatório entre 15 e 45 segundos é usado por tarefa:

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

Assistir por Lista de Usuários​

Cria tarefas de visualização 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": "view",
    "script_config": {
      "target_post_url": "https://www.tiktok.com/@target/video/123",
      "view_duration": 20
    }
  }'

Exemplo do Instagram​

A mesma API funciona para publicações e reels do 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]
    }
  }'

Resposta​

{
  "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/

Melhores Práticas​

  1. Varie o tempo de visualização: Prefira view_durations a um view_duration fixo para que cada visualização pareça mais natural.

  2. Agende as tarefas: Use o parâmetro start_time para distribuir as visualizações ao longo do tempo.

  3. Use o modo multi-conta: Ative enable_multi_account para assistir publicações 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​