API do TikTok - Ayrshare API Documentation

O Ayrshare oferece publicação direta de vídeos no TikTok, gerenciamento de comentários e obtenção de analytics avançadas para sua conta pessoal ou de negócios do TikTok usando a API do TikTok.O TikTok processa vídeos e fotos de forma assíncrona, portanto a resposta JSON terá status: “pending” tanto para publicações imediatas quanto para agendadas. Assim que o TikTok concluir o processamento, o webhook Scheduled Action registrado será chamado.

Publicação de vídeo no TikTok

JSON para uma publicação de vídeo básica no TikTok, publicada diretamente:

TikTok Video Post

{
  "post": "The best TikTok \n video ever #bestvideo", // Max 2,200 characters with a line break
  "mediaUrls": ["https://img.ayrshare.com/012/tiktok.mp4"],
  "platforms": ["tiktok"]
}

Exemplo de resposta JSON da publicação:

TikTok Video Post Response

{
  "status": "success",
  "errors": [],
  "postIds": [
    {
      "status": "success",
      "idShare": "video.7088122496758679353.nzLqBWbf",
      "id": "pending",
      "isVideo": true,
      "platform": "tiktok"
    }
  ],
  "id": "lb42orDhySAZmLWtj6b6",
  "refId": "23a9da9e0df1184a7a6a1fc2c60b8023aa9a32a1",
  "post": "The best TikTok video ever #bestvideo"
}

O TikTok atualmente não suporta quebras de linha no texto da publicação. Quebras de linha incluídas serão ignoradas.
Pode ser publicado um vídeo ou até 35 imagens. O TikTok não suporta combinação de vídeo e imagens. Veja abaixo para mais detalhes.
Se o vídeo não terminar em uma extensão conhecida, use isVideo.
O TikTok também suporta envio de mídia sem texto de publicação. Se você não quiser incluir texto na publicação, envie uma String vazia post: "".
Consulte as Diretrizes de mídia do TikTok e a Autorização do TikTok para mais informações.

Requisitos de vídeo do TikTok

Consulte Requisitos de vídeo do TikTok.
O vídeo deve terminar em uma extensão de vídeo conhecida, como mp4. Faça reverse proxy na URL, adicione uma URL personalizada com um CDN ou use o endpoint /media.
O limite de caracteres do texto de publicação do TikTok é 2.200.

O TikTok limita a publicação de vídeos via API a 6 vídeos por minuto, com um limite máximo de 15 vídeos por dia.

Publicação de imagens no TikTok

JSON para uma publicação básica de imagens (fotos) no TikTok, publicada diretamente:

TikTok Image Post

{
  "post": "The best TikTok \n video ever #bestvideo", // Max 2,200 characters with a line break
  "mediaUrls": [
    "https://img.ayrshare.com/012/gb.jpg",
    "https://img.ayrshare.com/random/photo-1.jpg"
  ], // Up to 35 images
  "platforms": ["tiktok"]
}

Exemplo de resposta JSON:

TikTok Image Post Response

{
  "status": "success",
  "errors": [],
  "postIds": [
    {
      "status": "success",
      "idShare": "p_pub_url~v2.7408974036430047275",
      "id": "pending",
      "isVideo": false,
      "platform": "tiktok"
    }
  ],
  "id": "8815mJ5bWApEebWjE233",
  "tikTokId": "p_pub_url~v2.7408974036430047333",
  "refId": "9abf1426d6ce9122ef11c72bd62e59807c5cc333",
  "post": "Opportunity is missed by most people because it is dressed in overalls and looks like work - Thomas Edison"
}

O TikTok atualmente não suporta quebras de linha no texto da publicação. Quebras de linha incluídas serão ignoradas.
Pode ser publicado um vídeo ou até 35 imagens.
O TikTok não suporta combinação de vídeo e imagens. Veja abaixo para mais detalhes.
As imagens devem ser do tipo JPG, JPEG ou WEBP. O TikTok não aceita arquivos de mídia PNG.
Você também pode selecionar uma das imagens como foto de capa usando imageCoverIndex. Por padrão, a primeira imagem é usada. Veja abaixo para detalhes.

Requisitos de imagem do TikTok

Consulte Requisitos de imagem do TikTok.
Até 35 imagens podem ser incluídas em uma publicação, com 20 MB por imagem.
As imagens devem ser do tipo JPG, JPEG ou WEBP. O TikTok não aceita arquivos de mídia PNG.
O limite de caracteres do texto de publicação do TikTok é 2.200.

O TikTok limita a publicação de imagens via API a 6 fotos por minuto, com um limite máximo de 15 fotos por dia.

Processamento do TikTok

O TikTok processa vídeos e imagens de forma assíncrona, portanto a resposta terá o campo id definido como "pending". Depois que o TikTok concluir o processamento, geralmente em 1 - 2 minutos, o campo id será atualizado com o id do vídeo no TikTok e um postUrl será adicionado.

Você pode obter o status final da publicação do TikTok usando webhooks ou o endpoint /history, que geralmente leva de 1 a 2 minutos para estar disponível.
Quando o usuário publica o vídeo no aplicativo móvel do TikTok, um webhook “scheduled” será enviado com subAction: "tikTokPublished".
Um primeiro comentário em uma publicação do TikTok é adiado: é publicado automaticamente assim que o webhook tikTokPublished resolve o id real do vídeo, não no momento da publicação. O visibility do vídeo deve ser public; caso contrário, o primeiro comentário não poderá ser publicado e um erro de comentário será retornado.
Se ocorrer um erro, como o TikTok não conseguir processar o vídeo ou testes internos do Ayrshare falharem, o campo id será definido como “failed” e o campo errors conterá os detalhes do erro.
O idShare é usado para referência interna do vídeo pendente.

Opções do TikTok

Ao publicar um vídeo ou imagens no TikTok, opções adicionais estão disponíveis. Exemplo de publicação de vídeo:

TikTok Video Publishing

{
  "tikTokOptions": {
    "disableComments": true, // Default false. Disable comments on the published video.
    "disableDuet": true, // Default false. Disable duets on the published video.
    "disableStitch": true // Default false. Disable stitches on the published video.
  }
}

Exemplo de publicação de imagens:

TikTok Image Publishing

{
  "tikTokOptions": {
    "imageCoverIndex": 1, // Use the second image in the mediaUrls.
    "title": "Amazing images"
  }
}

Opções

As seguintes opções estão disponíveis para publicações do TikTok. Devem ser adicionadas ao objeto tikTokOptions. Veja abaixo mais detalhes sobre cada opção.

TikTok Options

{
  "post": "The best TikTok video ever #bestvideo",
  "mediaUrls": ["https://img.ayrshare.com/012/tiktok.mp4"],
  "platforms": ["tiktok"],
  "tikTokOptions": {
    "autoAddMusic": true,
    "disableComments": true,
    "disableDuet": true,
    "disableStitch": true,
    "draft": true,
    "isAIGenerated": true,
    "isBrandedContent": true,
    "isBrandOrganic": true,
    "imageCoverIndex": 1,
    "title": "Amazing images",
    "thumbNailOffset": 30000,
    "visibility": "public"
  }
}

autoAddMusic

boolean

padrão:false

Define se música recomendada será automaticamente adicionada à publicação. Se você definir este campo como true, poderá alterar a música mais tarde no app do TikTok.Tipo de mídia: imagem

disableComments

boolean

padrão:false

Se deve desabilitar comentários na publicação publicada.Tipo de mídia: vídeo, imagem

disableDuet

boolean

padrão:false

Desabilita duets no vídeo publicado.Tipo de mídia: vídeo

disableStitch

boolean

padrão:false

Desabilita stitch no vídeo publicado.Tipo de mídia: vídeo

draft

boolean

padrão:false

Define se será criada uma publicação como rascunho.Consulte opções de rascunho para mais informações.Tipo de mídia: vídeo ou imagem

isAIGenerated

boolean

padrão:false

Define se o toggle de conteúdo gerado por IA será habilitado para a publicação de vídeo.Se você habilitar esse toggle, seu vídeo será rotulado como “Creator labeled as AI-generated” ao ser publicado, e o rótulo não poderá ser alterado. O rótulo “Creator labeled as AI-generated” indica que o conteúdo foi totalmente gerado por IA ou significativamente editado com IA.

Ativar a configuração de conteúdo gerado por IA não afetará a distribuição do seu vídeo, desde que ele não viole as Diretrizes da Comunidade do TikTok.

Tipo de mídia: vídeo

isBrandedContent

boolean

padrão:false

Define se o toggle de Branded Content será habilitado. Se este campo for definido como true, o vídeo será rotulado como Branded Content, indicando que você está em uma parceria paga com uma marca. Um rótulo “Paid partnership” será anexado ao vídeo.Tipo de mídia: vídeo, imagem

isBrandOrganic

boolean

padrão:false

Define se o toggle de Brand Organic Content será habilitado. Se este campo for definido como true, o vídeo será rotulado como Brand Organic Content, indicando que você está promovendo a si mesmo ou seu próprio negócio. Um rótulo “Promotional content” será anexado ao vídeo.Tipo de mídia: vídeo, imagem

imageCoverIndex

number

padrão:"0"

O índice do mediaUrls a ser usado como capa da publicação.Tipo de mídia: imagem

title

string

O título da publicação.Tipo de mídia: imagem

thumbNailOffset

number

O frame a ser usado como capa do vídeo.Consulte opções de thumbnail de vídeo para mais informações.Tipo de mídia: vídeo

visibility

string

padrão:"public"

Como a publicação é compartilhada e quem pode vê-la.Valores: public, private, followers ou friends.Consulte opções de visibilidade para mais informações.Tipo de mídia: imagem

Opções de visibilidade

Visibilidade	Descrição
public	Visível para todos os usuários do TikTok.
private	Privado, visível apenas para a própria conta.
followers	Visível apenas para os seguidores da conta.
friends	Visível apenas para seguidores mútuos.

Publicações privadas permanecerão com status pending e nenhum webhook do TikTok será enviado até que a publicação seja tornada pública.

Thumbnail de vídeo

Há duas maneiras de definir uma thumbnail, também conhecida como foto de capa, para um vídeo do TikTok:

Usando o parâmetro thumbNailOffset para definir um frame como thumbnail.
Usando o parâmetro thumbNail para definir uma imagem de thumbnail a partir de uma URL.

Apenas vídeos são suportados para a definição de thumbnail.

Offset de thumbnail

Defina uma thumbnail para um vídeo do TikTok selecionando um frame por offset.

TikTok Video Thumbnail Offset

{
  "tikTokOptions": {
    "thumbNailOffset": 30000 // milliseconds of offset image
  }
}

O offset é a posição em milissegundos do frame do thumbnail. O valor padrão é 0, que é o primeiro frame do vídeo.

URL do thumbnail

Defina uma thumbnail para um vídeo do TikTok fazendo upload de uma imagem a partir de uma URL.

TikTok Video Thumbnail URL

{
  "tikTokOptions": {
    "thumbNail": "https://img.ayrshare.com/012/gb.jpg"
  }
}

Se você usar o parâmetro thumbNail, o parâmetro thumbNailOffset será ignorado. Consulte Requisitos de thumbnail do TikTok para mais informações.

Menções no TikTok

Mencione outro usuário do TikTok adicionando @handle no texto da publicação. Por exemplo:

TikTok Mention

{
  "post": "Love the @ayrshare social media api"
}

Revise as regras importantes sobre menções.

Publicação de rascunho no TikTok

Crie uma publicação de rascunho para um vídeo ou imagem do TikTok, permitindo editar o vídeo ou imagem antes de publicar.

TikTok Video Draft Post

{
  "post": "The best TikTok video ever #bestvideo", // empty string is allowed
  "mediaUrls": ["https://img.ayrshare.com/012/tiktok.mp4"],
  "platforms": ["tiktok"],
  "tikTokOptions": {
    "draft": true
  }
}

A publicação de rascunho de vídeo ou imagem estará disponível em Inbox de notificações, na barra inferior do aplicativo do TikTok. Procure por uma mensagem System notifications e clique na mensagem no topo Your content from Ayrshare is ready. A postUrl do Ayrshare permanecerá em status pending até que o vídeo seja publicado. O primeiro comentário não é suportado em publicações de rascunho.

Renovação de autorização

O TikTok deve ser reautorizado todo ano via página Social Accounts.

Uma notificação por e-mail e webhook de ação social será enviada 15 dias antes da expiração da autorização.
A data de renovação necessária e os dias restantes podem ser obtidos no endpoint /user.

Limites de caracteres

Consulte Limites de caracteres do TikTok para mais informações.

Informações adicionais

Exemplos adicionais sobre uso da API do TikTok.

​Publicação de vídeo no TikTok

​Requisitos de vídeo do TikTok

​Publicação de imagens no TikTok

​Requisitos de imagem do TikTok

​Processamento do TikTok

​Opções do TikTok

​Opções

​Opções de visibilidade

​Thumbnail de vídeo

​Offset de thumbnail

​URL do thumbnail

​Menções no TikTok

​Publicação de rascunho no TikTok

​Renovação de autorização

​Limites de caracteres

​Informações adicionais

Publicação de vídeo no TikTok

Requisitos de vídeo do TikTok

Publicação de imagens no TikTok

Requisitos de imagem do TikTok

Processamento do TikTok

Opções do TikTok

Opções

Opções de visibilidade

Thumbnail de vídeo

Offset de thumbnail

URL do thumbnail

Menções no TikTok

Publicação de rascunho no TikTok

Renovação de autorização

Limites de caracteres

Informações adicionais