URLs de mídia do TikTok: domínios verificados e prefixos de URL
A API for Business do TikTok baixa a mídia das publicações a partir de URLs: video_url, custom_thumbnail_url e photo_images. Cada URL precisa estar em um domínio ou prefixo de URL cuja propriedade o app de desenvolvedor tenha verificado. Um domínio é verificado com um registro DNS TXT, e um prefixo com um arquivo de assinatura colocado sob ele, pelas rotas /business/property/add/ e /business/property/verify/ com o app_id e o secret do app.
O easyCoexistence entrega sua mídia ao TikTok a partir do próprio prefixo de URL verificado: o publish_tiktok_post recebe um link HTTPS do Claude, do ChatGPT ou do seu próprio código e transmite o arquivo a partir dele quando o TikTok faz o download, então seu domínio não precisa de verificação.
Desde então, o TikTok recusa URLs de vídeo que não estejam em um domínio ou prefixo de URL verificado.
Desde então, as rotas de propriedades de URL também exigem o secret do app de desenvolvedor.
Valores de property_type: 1 para domínio, 2 para prefixo de URL.
Valores de property_status: pending, verified e not verified, quando a tentativa falhou e precisa ser repetida.
Desenvolvedores que publicaram vídeos antes disso tiveram os domínios dessas URLs de vídeo marcados como verificados automaticamente.
Tamanho máximo de imagem aceito por /business/comment/image/upload/, enviado como dados de formulário multipart, para um comentário ou uma resposta.
Quais URLs o TikTok baixa?
Todo campo de mídia nos dois endpoints de publicação é uma URL que o próprio TikTok busca depois de aceitar a chamada, então o arquivo precisa continuar acessível até o download terminar:
video_url: o vídeo, que o TikTok recomenda manter válido por pelo menos 30 minutos.custom_thumbnail_url: uma imagem para usar como capa do vídeo.photo_images: até 35 imagens para uma publicação de fotos.- Tempo limite: o TikTok dá uma hora para o download e, depois, falha a publicação com
video_pull_failedouphoto_pull_failed.
Qual é a diferença entre domínio e prefixo de URL?
O que você comprova que possui e, portanto, quais URLs contam como verificadas. Um domínio serve para mídia em um host que você possui ou controla; um prefixo serve para uma pasta em um host onde você só consegue enviar arquivos. As regras do TikTok para cada tipo de propriedade:
| Domain | URL prefix | |
|---|---|---|
| What it is | A site you own, such as example.com or a subdomain | https:// plus a host, a path and a final /, such as https://www.example.com/videos/ |
| Proof | A DNS TXT record holding the signature | A file named file_name, holding the signature, uploaded under the prefix |
| Covers | URLs on the domain and its subdomains | URLs that begin with the prefix |
| Leaves out | The parent: verifying video.example.com leaves example.com unverified | Sibling paths: /folder/user/ leaves /folder/public/ unverified |
| Redirects | Not applicable | Not followed; a prefix answering 3xx is invalid |
Como você verifica uma propriedade?
Por meio de duas chamadas que se autenticam com o app_id e o secret do app de desenvolvedor, em vez de um token de conta, com a prova colocada entre elas:
- Adicionar: POST /business/property/add/ com
url_property_meta, contendoproperty_typee url; a resposta traz signature, além defile_namepara um prefixo, comproperty_status0. - Provar: coloque a signature em um registro DNS TXT para um domínio, ou em um arquivo público chamado
file_name, com extensão .txt única, sob um prefixo. - Checar: POST /business/property/verify/ com o mesmo
url_property_meta;property_status1 significa verificado, e 2 significa que a tentativa falhou.
curl -X POST 'https://business-api.tiktok.com/open_api/v1.3/business/property/add/' \
-H 'Content-Type: application/json' \
-d '{
"app_id": "<APP_ID>",
"secret": "<APP_SECRET>",
"url_property_meta": { "property_type": 2, "url": "https://media.example.com/tiktok/" }
}'
# data.url_property_info: url, property_type, property_status (0), signature, file_nameComo você lista ou remove propriedades?
GET /business/property/list/ com app_id e secret retorna url_property_info_list, cada entrada com property_type, url, property_status, signature e file_name. Subdomínios de um domínio verificado contam como verificados sem uma chamada própria, mas aparecem na lista apenas se tiverem sido adicionados. POST /business/property/delete/ com app_id, secret e url_property_meta remove uma propriedade que o app não possui nem controla mais.
Você pode enviar um arquivo em vez de uma URL?
Não para publicações. A Accounts API publica somente a partir de URLs, inclusive rascunhos, e seu único endpoint de upload, /business/comment/image/upload/, recebe a imagem de um comentário como dados de formulário multipart, em JPG, JPEG, WebP ou PNG de até 5 MB, e retorna um image_uri para um comentário ou resposta. Upload de arquivo em partes pertence à Content Posting API em developers.tiktok.com, uma API separada com apps próprios, onde o método de transferência se chama FILE_UPLOAD.
O que acontece com uma URL não verificada?
O TikTok recusa publicar a partir dela. A referência da API for Business declara a regra para vídeos e fotos, mas não define um código de retorno próprio para ela, então leia o código e a mensagem na resposta. A Content Posting API em developers.tiktok.com chama o mesmo caso de url_ownership_unverified, com HTTP 403. Para testar o endpoint de vídeo antes de qualquer propriedade ser verificada, o TikTok publica uma URL de vídeo de teste que não precisa de verificação:
https://sf16-va.tiktokcdn.com/obj/eden-va2/uvpapzpbxjH-aulauvJ-WV[[/ljhwZthlaukjlkulzlp/3min.mp4Como o easyCoexistence leva sua mídia ao TikTok?
Por meio de um prefixo de URL verificado próprio, https://easycoexistence.com/api/social/media/. O publish_tiktok_post aceita seu link HTTPS, recusa http:// antes de enviar qualquer coisa e entrega ao TikTok um link sob esse prefixo, com um token assinado que identifica seu arquivo, expira em 6 horas e mantém a extensão do arquivo. Quando o TikTok busca o link, o easyCoexistence verifica o token, confirma que seu link usa HTTPS em um endereço público e transmite o arquivo diretamente do seu link, incluindo requisições por intervalo (range) e redirecionamentos, sem armazená-lo. Se seu link falhar, o TikTok não consegue baixar o arquivo e a publicação falha.
Your link: https://cdn.example.com/videos/launch.mp4
Sent to TikTok: https://easycoexistence.com/api/social/media/<SIGNED_TOKEN>.mp4Erros comuns
- Verificar um subdomínio e hospedar os arquivos no domínio pai. Um video.example.com verificado cobre os próprios subdomínios, não o example.com em si.
- Servir o arquivo de assinatura do prefixo por meio de um redirecionamento. O TikTok não segue redirecionamentos para um prefixo de URL e trata uma resposta 3xx como inválida.
- Salvar o arquivo de assinatura como name.txt.txt. O TikTok exige que o nome do arquivo corresponda a file_name, com uma única extensão .txt.
- Apagar o arquivo logo após a chamada de publicação. O TikTok baixa o arquivo depois, por até uma hora, e falha a publicação se o link deixar de funcionar.
US$ 9 a US$ 0,75 por número conectado por mês, com preço caindo conforme você adiciona números, e os 3 primeiros 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
Por que o TikTok exige URLs de mídia verificadas?
O TikTok diz que verificar a propriedade das URLs de vídeo o ajuda a cumprir suas políticas sobre conteúdo protegido por direitos autorais e segurança do usuário.
Um domínio do TikTok verificado cobre seus subdomínios?
Sim. Subdomínios de um domínio verificado contam como verificados, embora /business/property/list/ os mostre apenas se tiverem sido adicionados.
A API for Business do TikTok pode publicar a partir de um link S3 ou CDN?
Sim, quando o link estiver sob um domínio ou prefixo de URL que o app tenha verificado, como um prefixo em um bucket ou caminho de CDN que você controla.
Publicações de fotos também precisam de URLs verificadas?
Sim. O endpoint de fotos do TikTok declara que publicações de fotos não podem ser feitas a partir de URLs de fotos não verificadas.
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