Pular para o conteúdo principal

Configuração do Script de Repost

Comportamento atual\nO repost agora é compatível com TikTok e Threads. Para Threads informe a URL da publicação e platform: threads; o bloco que diz que é apenas TikTok pertence a uma versão antiga.\n:::

Esta página documenta os parâmetros de configuração do script repost utilizado na criação de tarefas.

Visão geral​

O script repost é utilizado para repostar automaticamente vídeos do TikTok. Quando você fornece múltiplas URLs de publicações alvo via API, uma tarefa é criada por URL. Você pode controlar quando cada tarefa é executada usando o parâmetro start_time.

Apenas TikTok

O script repost suporta apenas o TikTok. O Instagram não possui uma função de repost nativa.

Configuração do script (script_config)​

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

Parâmetros​

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

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

Criação de tarefas

Quando múltiplas URLs de publicações são fornecidas, a API cria uma tarefa por URL. Por exemplo, se você especificar 3 URLs e 2 dispositivos, serão criadas 6 tarefas. Use o parâmetro start_time para controlar quando as tarefas começam a ser executadas.

Exemplos​

Repostar uma única publicação​

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

Repostar múltiplas publicações​

Ao repostar 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": "repost",
    "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 independentes que são executadas imediatamente.

Agendar reposts com horário de início​

Use start_time para agendar quando as tarefas devem começar:

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

Repost por modo de lista de usuários​

Crie tarefas de repost 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": "repost",
    "script_config": {
      "target_post_url": "https://www.tiktok.com/@target/video/123"
    }
  }'

Repost em lote em múltiplos dispositivos​

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_1", "device_2", "device_3"],
    "script_name": "repost",
    "script_config": {
      "target_post_url": "https://www.tiktok.com/@viral/video/999"
    },
    "enable_multi_account": true
  }'

Resposta​

{
  "code": 0,
  "message": "success",
  "data": {
    "task_ids": [401, 402, 403],
    "created_count": 3
  }
}

Formatos de URL de publicações​

TikTok​

https://www.tiktok.com/@username/video/1234567890123456
https://vm.tiktok.com/ABCDEFG/

Como funciona o repost​

  1. O script abre a URL da publicação alvo.
  2. Verifica se a publicação já foi repostada — se sim, pula para evitar reposts duplicados.
  3. Clica no botão Compartilhar e seleciona Repostar no menu.
  4. Confirma a ação de repost.

Melhores práticas​

  1. Agende tarefas: Use o parâmetro start_time para distribuir os reposts ao longo do tempo, reduzindo o risco de limitação de taxa.

  2. Agrupe com inteligência: Não crie muitas tarefas de repost de uma vez. As plataformas podem ter limites de taxa para repostar.

  3. Use o modo multiconta: Ative enable_multi_account para repostar vídeos usando múltiplas contas no mesmo dispositivo.

Códigos de erro​

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

Ver também​