Iniciar sesiónEmpezar prueba gratis
easyCoexistence APIs oficiales

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.

3 levels

Opciones de privacidad para las publicaciones de fotos de una cuenta pública: PUBLIC_TO_EVERYONE, MUTUAL_FOLLOW_FRIENDS y SELF_ONLY.

FOLLOWER_OF_CREATOR

Nivel de privacidad que recibe una cuenta privada en lugar de PUBLIC_TO_EVERYONE: visible solo para sus seguidores.

false

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.

1080 x 1920

Tamaño máximo de la imagen de portada personalizada de un video: al menos 360 x 360 píxeles y hasta 20 MB.

Paid partnership

Etiqueta que aplica is_branded_content; prevalece si is_brand_organic también es true.

privacy_level

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 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

¿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_FRIENDS y SELF_ONLY para una cuenta pública; FOLLOWER_OF_CREATOR, MUTUAL_FOLLOW_FRIENDS y SELF_ONLY para una privada.
  • comment_disabled: true cuando la cuenta no acepta comentarios de nadie; en ese caso disable_comment solo acepta true.
  • duet_disabled y stitch_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.
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
  }
}

¿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_id con location_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_draft o is_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.

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>

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.
Hacerlo con EasyCoexistence

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