EntrarComeçar teste grátis
easyCoexistence APIs oficiais

Configurações de publicação do TikTok pela API: privacidade, comentários, Duet e Stitch

A API for Business do TikTok recebe as configurações de uma postagem na chamada de publicação, em sua maior parte dentro de post_info. Vídeos aceitam disable_comment, disable_duet e disable_stitch, uma capa definida por thumbnail_offset ou custom_thumbnail_url, os rótulos is_brand_organic e is_branded_content, e is_ai_generated. Postagens de foto aceitam privacy_level, disable_comment, os mesmos rótulos de marca e auto_add_music. GET /business/video/settings/ retorna os valores permitidos para cada conta.

A easyCoexistence publica vídeos e postagens de foto do TikTok com publish_tiktok_post a partir do Claude, do ChatGPT ou do seu próprio código, com a legenda, o título de uma postagem de foto e comentários ativados ou desativados, e get_social_credentials entrega ao seu próprio código o token para ler as configurações permitidas da conta.

3 levels

Opções de privacidade para as postagens de foto de uma conta pública: PUBLIC_TO_EVERYONE, MUTUAL_FOLLOW_FRIENDS e SELF_ONLY.

FOLLOWER_OF_CREATOR

Nível de privacidade que uma conta privada recebe no lugar de PUBLIC_TO_EVERYONE: visível somente para os seus seguidores.

false

Padrão de disable_comment, disable_duet e disable_stitch, então comentários, Duets e Stitches permanecem ativados, a menos que sejam definidos.

1080 x 1920

Maior imagem de capa personalizada para um vídeo, que deve ter pelo menos 360 x 360 pixels e até 20 MB.

Paid partnership

Rótulo que is_branded_content aplica; ele prevalece quando is_brand_organic também é true.

privacy_level

Campo obrigatório do post_info de uma postagem de foto, limitado às opções que GET /business/video/settings/ retorna para a conta.

Quais configurações cada endpoint de publicação aceita?

/business/video/publish/ e /business/photo/publish/ compartilham algumas configurações e diferem em outras. A maioria fica dentro de post_info, enquanto custom_thumbnail_url e photo_cover_index ficam no nível superior do corpo. Lado a lado, como as referências do TikTok as listam, com Sem campo onde um endpoint não documenta nada para aquela configuração:

Video postPhoto post
Who sees itNo privacy field: the endpoint publishes public video postsprivacy_level, required
Commentsdisable_commentdisable_comment
Duet and Stitchdisable_duet, disable_stitchNo field
Covercustom_thumbnail_url or thumbnail_offsetphoto_cover_index
Brand labelsis_brand_organic, is_branded_contentis_brand_organic, is_branded_content
AI labelis_ai_generatedNo field
Musicmusic_sound_info, video_original_sound_volumeauto_add_music, music_sound_info
Locationlocation_id with location_namelocation_id with location_name
Draftupload_to_draftis_draft

O que a conta permite?

GET /business/video/settings/ com business_id retorna os limites da conta para as suas postagens. Consulte antes de publicar, já que o TikTok aceita apenas os valores que ela lista:

  • privacy_level_options: PUBLIC_TO_EVERYONE, MUTUAL_FOLLOW_FRIENDS e SELF_ONLY para uma conta pública; FOLLOWER_OF_CREATOR, MUTUAL_FOLLOW_FRIENDS e SELF_ONLY para uma conta privada.
  • comment_disabled: true quando a conta não aceita comentários de ninguém, e então disable_comment aceita apenas true.
  • duet_disabled e stitch_disabled: true quando a conta permite Duet ou Stitch apenas para Somente você, ou é privada; a opção correspondente então aceita apenas true.
  • max_video_post_duration_sec: o vídeo mais longo que a conta pode publicar; um vídeo maior falha.
Read an account's post settings
curl -G 'https://business-api.tiktok.com/open_api/v1.3/business/video/settings/' \
  -H 'Access-Token: <ACCESS_TOKEN>' \
  --data-urlencode 'business_id=<OPEN_ID>'

{
  "code": 0,
  "message": "OK",
  "request_id": "<REQUEST_ID>",
  "data": {
    "comment_disabled": false,
    "duet_disabled": false,
    "max_video_post_duration_sec": 600,
    "privacy_level_options": ["PUBLIC_TO_EVERYONE", "MUTUAL_FOLLOW_FRIENDS", "SELF_ONLY"],
    "stitch_disabled": false
  }
}

Quem pode ver a postagem?

Em uma postagem de foto, o privacy_level que você envia: PUBLIC_TO_EVERYONE para pessoas dentro ou fora do TikTok, MUTUAL_FOLLOW_FRIENDS para seguidores que a conta segue de volta, FOLLOWER_OF_CREATOR para os seguidores de uma conta privada, ou SELF_ONLY. O endpoint de vídeo não tem campo de privacidade, já que publica vídeos públicos. Uma postagem definida como Amigos ou Somente você também não pode ser assistida pelo seu embed_url.

Como funcionam comentários, Duet e Stitch?

Cada um é uma opção que desliga o recurso quando definida como true. disable_comment existe nos dois endpoints; disable_duet e disable_stitch existem apenas em vídeos. Todos têm false como padrão, o que mantém o recurso ativo, dentro do que as próprias configurações de privacidade da conta permitem: uma conta que não aceita comentários de ninguém, ou que limita Duet ou Stitch a Somente você, só pode publicar com essa opção definida como true.

Como a capa é escolhida?

Em um vídeo, de duas formas. post_info.thumbnail_offset escolhe um quadro pelo seu tempo em milissegundos, 0 por padrão, arredondado para o quadro mais próximo; um tempo além do fim do vídeo envia um webhook de falha e o vídeo não é publicado. custom_thumbnail_url, no nível superior do corpo, usa uma imagem no lugar e faz o TikTok ignorar o offset. Em uma postagem de foto, photo_cover_index escolhe uma das imagens, contando a partir de 0.

  • Imagem de capa personalizada: JPG, JPEG, WebP ou PNG, até 20 MB.
  • Tamanho: de 360 x 360 pixels até 1080 x 1920, ou 1920 x 1080.
  • Localização: um domínio ou prefixo de URL verificado para o app, como o próprio vídeo.

O que significam os rótulos de marca?

Divulgações que o TikTok exibe na postagem. is_brand_organic definido como true rotula a postagem como Conteúdo promocional, para postagens que promovem o negócio da própria conta. is_branded_content definido como true rotula como Parceria paga, para postagens feitas em parceria paga com uma marca, e prevalece quando ambos são true. Em um vídeo com is_branded_content, tto_invite_link pode vincular a postagem a uma campanha do TikTok One Creator Marketplace da qual a conta participa.

Quais outras opções ficam em post_info?

Algumas mais, cada uma documentada no endpoint que a recebe:

  • is_ai_generated, vídeos: rotula a postagem como Criador rotulou como gerado por IA, o que não pode ser alterado depois de publicada.
  • location_id com location_name: uma marcação de localização encontrada por GET /business/publish/location/.
  • music_sound_info: um som comercial pelo ID; em vídeos também seu volume, de 0 a 100, e seu início e fim em milissegundos.
  • auto_add_music, postagens de foto: adiciona música recomendada, que pode ser alterada depois no app do TikTok.
  • upload_to_draft ou is_draft: envia a postagem para a caixa de entrada do criador como rascunho, com o vídeo, usando o escopo video.upload.
  • is_ads_only, vídeos: publica uma postagem 'Only show in ads' que fica fora do perfil.

Quais configurações o publish_tiktok_post define?

Três vêm da sua requisição: a legenda, o título de uma postagem de foto e disable_comment. A easyCoexistence envia is_brand_organic e is_branded_content como false, publica postagens de foto como PUBLIC_TO_EVERYONE com a primeira imagem como capa, e deixa de fora o restante das configurações de um vídeo, para que valham os padrões do TikTok: disable_duet e disable_stitch como false, thumbnail_offset 0 e is_ai_generated como false.

Como você envia as outras configurações?

A partir do seu próprio código, com o token e o business_id da conta de get_social_credentials, em caminhos da Business API sob business/. Um GET para business/video/settings/ lê os limites da conta. Um POST para business/video/publish/ ou business/photo/publish/ pode conter o corpo completo documentado, e ele chega ao TikTok como escrito, incluindo as URLs de mídia, por isso elas precisam estar em um domínio ou prefixo de URL verificado para o app; publish_tiktok_post é a chamada que direciona o seu link pela rota de mídia verificada da easyCoexistence.

Reading the settings from your own code
GET https://business-api.tiktok.com/open_api/v1.3/business/video/settings/?business_id=<BUSINESS_ID>
Access-Token: <ACCESS_TOKEN>

Erros comuns

  • Esperar que privacy_level funcione em um vídeo. O endpoint de vídeo publica postagens públicas e sua referência não lista nenhum campo de privacidade; postagens de foto aceitam privacy_level.
  • Ativar comentários para uma conta que não aceita nenhum. Quando comment_disabled é true, o TikTok aceita disable_comment apenas como true.
  • Definir thumbnail_offset além do fim do vídeo. O TikTok envia um webhook de falha e o vídeo não é publicado.
  • Enviar PUBLIC_TO_EVERYONE para uma conta privada. Suas privacy_level_options listam FOLLOWER_OF_CREATOR, MUTUAL_FOLLOW_FRIENDS e SELF_ONLY no lugar.
Fazendo isso com o EasyCoexistence

De US$ 9 a US$ 0.75 por conexão por mês, caindo conforme você adiciona conexões, com os primeiros 3 dias grátis.

O easyCoexistence é uma API e um servidor MCP multicanal que conecta agentes de IA, como o Claude e o ChatGPT, ao WhatsApp, Instagram, TikTok, Facebook e mais. No WhatsApp, ele usa o Coexistence: a empresa continua usando o número no app WhatsApp Business enquanto a IA trabalha pela API oficial da Meta.

Perguntas frequentes

Posso publicar um vídeo privado do TikTok pela API?

Não com o endpoint de vídeo, que publica postagens públicas. Postagens de foto aceitam privacy_level, inclusive SELF_ONLY, e um vídeo pode ir para a caixa de entrada do criador como rascunho com upload_to_draft.

Como desativo Duets e Stitches pela API?

Defina post_info.disable_duet e post_info.disable_stitch como true em /business/video/publish/. Quando a conta já os limita, o TikTok aceita apenas true.

Posso adicionar uma marcação de localização pela API do TikTok?

Sim. post_info aceita location_id com location_name, para uma marcação de localização encontrada por GET /business/publish/location/.

Qual é a diferença entre is_brand_organic e is_branded_content?

is_brand_organic adiciona o rótulo Conteúdo promocional para o negócio da própria conta; is_branded_content adiciona o rótulo Parceria paga e prevalece quando ambos são true.

Continue lendo

Conecte seu primeiro canal em dois minutos.

Sem esperar aprovação das plataformas. Conecte o WhatsApp, o Instagram, o TikTok ou outro canal, peça para a sua IA publicar, responder ou trazer os números, e veja funcionando.

  • 3 dias grátis
  • Cancele quando quiser
  • Só APIs oficiais
  • Monitorado 24/7

Verificado em