Ajustes de publicación de TikTok por API: privacidad, comentarios, Duet y Stitch
La API for Business de TikTok recibe los ajustes de una publicación en la llamada de publicación, principalmente dentro de post_info. Los videos aceptan disable_comment, disable_duet y disable_stitch, una portada desde thumbnail_offset o custom_thumbnail_url, las etiquetas is_brand_organic e is_branded_content y is_ai_generated. Las publicaciones de fotos aceptan privacy_level, disable_comment, las mismas etiquetas de marca y auto_add_music. GET /business/video/settings/ devuelve los valores que permite cada cuenta.
easyCoexistence publica videos y publicaciones de foto de TikTok con publish_tiktok_post desde Claude, ChatGPT o tu propio código, con la descripción, el título de una publicación de foto y los comentarios activados o desactivados, y get_social_credentials da a tu propio código el token para leer los ajustes permitidos de la cuenta.
Opciones de privacidad para las publicaciones de fotos de una cuenta pública: PUBLIC_TO_EVERYONE, MUTUAL_FOLLOW_FRIENDS y SELF_ONLY.
Nivel de privacidad que recibe una cuenta privada en lugar de PUBLIC_TO_EVERYONE: visible solo para sus seguidores.
Valor predeterminado de disable_comment, disable_duet y disable_stitch, así que los comentarios, los Duets y los Stitches quedan activados si no se configuran.
Tamaño máximo de la imagen de portada personalizada de un video: al menos 360 x 360 píxeles y hasta 20 MB.
Etiqueta que aplica is_branded_content; prevalece si is_brand_organic también es true.
Campo obligatorio del post_info de una publicación de foto, limitado a las opciones que devuelve GET /business/video/settings/ para la cuenta.
¿Qué ajustes acepta cada endpoint de publicación?
/business/video/publish/ y /business/photo/publish/ comparten algunos ajustes y difieren en otros. La mayoría va dentro de post_info, mientras que custom_thumbnail_url y photo_cover_index van en el nivel superior del cuerpo. Lado a lado, tal como los listan las referencias de TikTok, con Sin campo donde un endpoint no documenta nada para ese ajuste:
| Video post | Photo post | |
|---|---|---|
| Who sees it | No privacy field: the endpoint publishes public video posts | privacy_level, required |
| Comments | disable_comment | disable_comment |
| Duet and Stitch | disable_duet, disable_stitch | No field |
| Cover | custom_thumbnail_url or thumbnail_offset | photo_cover_index |
| Brand labels | is_brand_organic, is_branded_content | is_brand_organic, is_branded_content |
| AI label | is_ai_generated | No field |
| Music | music_sound_info, video_original_sound_volume | auto_add_music, music_sound_info |
| Location | location_id with location_name | location_id with location_name |
| Draft | upload_to_draft | is_draft |
¿Qué permite la cuenta?
GET /business/video/settings/ con business_id devuelve los límites de la cuenta para sus publicaciones. Léelo antes de publicar, ya que TikTok solo acepta los valores que enumera:
privacy_level_options:PUBLIC_TO_EVERYONE,MUTUAL_FOLLOW_FRIENDSySELF_ONLYpara una cuenta pública;FOLLOWER_OF_CREATOR,MUTUAL_FOLLOW_FRIENDSySELF_ONLYpara una privada.comment_disabled: true cuando la cuenta no acepta comentarios de nadie; en ese casodisable_commentsolo acepta true.duet_disabledystitch_disabled: true cuando la cuenta permite Duet o Stitch solo a solo tú, o es privada; el interruptor correspondiente entonces solo acepta true.max_video_post_duration_sec: la duración máxima de video que la cuenta puede publicar; un video más largo falla.
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
}
}¿Quién puede ver la publicación?
En una publicación de foto, el privacy_level que envías: PUBLIC_TO_EVERYONE para personas dentro o fuera de TikTok, MUTUAL_FOLLOW_FRIENDS para los seguidores a los que la cuenta sigue de vuelta, FOLLOWER_OF_CREATOR para los seguidores de una cuenta privada, o SELF_ONLY. El endpoint de video no tiene campo de privacidad, ya que publica videos públicos. Una publicación configurada como Amigos o Solo tú tampoco se puede ver a través de su embed_url.
¿Cómo funcionan los comentarios, Duet y Stitch?
Cada uno es un interruptor que desactiva la función cuando se establece en true. disable_comment existe en ambos endpoints; disable_duet y disable_stitch existen solo en videos. Todos tienen false por defecto, lo que deja la función activada dentro de lo que permiten los propios ajustes de privacidad de la cuenta: una cuenta que no acepta comentarios de nadie, o que limita Duet o Stitch a solo tú, solo puede publicar con ese interruptor en true.
¿Cómo se elige la portada?
En un video, de dos maneras. post_info.thumbnail_offset elige un fotograma por su tiempo en milisegundos, 0 por defecto, redondeado al fotograma más cercano; un tiempo posterior al final del video envía un webhook de fallo y el video no se publica. custom_thumbnail_url, en el nivel superior del cuerpo, da una imagen en su lugar y hace que TikTok ignore el offset. En una publicación de foto, photo_cover_index elige una de las imágenes, contando desde 0.
- Imagen de portada personalizada: JPG, JPEG, WebP o PNG, hasta 20 MB.
- Tamaño: desde 360 x 360 píxeles hasta 1080 x 1920, o 1920 x 1080.
- Ubicación: un dominio o prefijo de URL verificado para la app, igual que el propio video.
¿Qué significan las etiquetas de marca?
Avisos que TikTok muestra en la publicación. is_brand_organic en true la etiqueta como Contenido promocional, para publicaciones que promocionan el negocio propio de la cuenta. is_branded_content en true la etiqueta como Colaboración pagada, para publicaciones hechas en una colaboración pagada con una marca, y tiene prioridad cuando ambas son true. En un video con is_branded_content, tto_invite_link puede vincular la publicación a una campaña de TikTok One Creator Marketplace en la que la cuenta esté inscrita.
¿Qué otras opciones hay en post_info?
Algunas más, cada una documentada en el endpoint que la acepta:
is_ai_generated, videos: marca la publicación como generada por IA por el creador; no se puede cambiar una vez publicada.location_idconlocation_name: una etiqueta de ubicación encontrada mediante GET /business/publish/location/.music_sound_info: un sonido comercial por ID; en videos también su volumen, de 0 a 100, y su inicio y fin en milisegundos.auto_add_music, publicaciones de foto: añade música recomendada, que luego se puede cambiar en la app de TikTok.upload_to_draftois_draft: envía la publicación a la bandeja de entrada del creador como borrador, con el video, con el scope video.upload.is_ads_only, videos: publica una publicación «Solo para anuncios» que queda fuera del perfil.
¿Qué ajustes establece publish_tiktok_post?
Tres vienen de tu petición: la descripción, el título de una publicación de foto y disable_comment. easyCoexistence envía is_brand_organic y is_branded_content como false, publica las publicaciones de foto como PUBLIC_TO_EVERYONE con la primera imagen como portada, y deja fuera el resto de los ajustes de un video, de modo que se aplican los valores predeterminados de TikTok: disable_duet y disable_stitch en false, thumbnail_offset en 0 e is_ai_generated en false.
¿Cómo envías los demás ajustes?
Desde tu propio código, con el token y el business_id de la cuenta de get_social_credentials, en rutas de la Business API bajo business/. Un GET a business/video/settings/ lee los límites de la cuenta. Un POST a business/video/publish/ o business/photo/publish/ puede llevar el cuerpo completo documentado, y llega a TikTok tal como está escrito, incluidas las URL de medios, así que deben estar en un dominio o prefijo de URL verificado para la app; publish_tiktok_post es la llamada que enruta tu enlace por la ruta de medios verificada de easyCoexistence.
GET https://business-api.tiktok.com/open_api/v1.3/business/video/settings/?business_id=<BUSINESS_ID>
Access-Token: <ACCESS_TOKEN>Errores comunes
- Esperar que privacy_level funcione en un video. El endpoint de video publica videos públicos y su referencia no lista ningún campo de privacidad; las publicaciones de foto sí aceptan privacy_level.
- Activar comentarios en una cuenta que no acepta ninguno. Cuando comment_disabled es true, TikTok solo acepta disable_comment como true.
- Establecer thumbnail_offset más allá del final del video. TikTok envía un webhook de fallo y el video no se publica.
- Enviar PUBLIC_TO_EVERYONE para una cuenta privada. Su privacy_level_options enumera FOLLOWER_OF_CREATOR, MUTUAL_FOLLOW_FRIENDS y SELF_ONLY en su lugar.
De US$ 9 a US$ 0.75 por conexión al mes, que baja a medida que añades conexiones, con los primeros 3 días gratis.
Preguntas frecuentes
¿Puedo publicar un video privado de TikTok a través de la API?
No con el endpoint de video, que publica publicaciones públicas. Las publicaciones de foto aceptan privacy_level, incluido SELF_ONLY, y un video puede enviarse a la bandeja de entrada del creador como borrador con upload_to_draft.
¿Cómo desactivo Duets y Stitches a través de la API?
Establece post_info.disable_duet y post_info.disable_stitch en true en /business/video/publish/. Cuando la cuenta ya los limita, TikTok solo acepta true.
¿Puedo añadir una etiqueta de ubicación con la API de TikTok?
Sí. post_info acepta location_id con location_name, para una etiqueta de ubicación encontrada mediante GET /business/publish/location/.
¿Cuál es la diferencia entre is_brand_organic e is_branded_content?
is_brand_organic añade la etiqueta Contenido promocional para el negocio propio de la cuenta; is_branded_content añade la etiqueta Colaboración pagada y tiene prioridad cuando ambas son true.
Sigue leyendo
Conecta tu primer canal en dos minutos.
Sin esperar revisiones de las plataformas. Conecta WhatsApp, Instagram, TikTok u otro canal, pídele a tu IA que publique, responda o te haga un informe, y míralo trabajar.
- 3 días gratis
- Cancela cuando quieras
- Solo APIs oficiales
- Monitorizado 24/7
Verificado el