Iniciar sesiónEmpezar prueba gratis
easyCoexistence APIs oficiales

Publicaciones de fotos y carruseles de TikTok con la API: hasta 35 imágenes

La API for Business de TikTok publica posts de fotos de 1 a 35 imágenes. Cada imagen debe ser un archivo JPG, JPEG o WebP de hasta 20 MB y no superar los 1080 por 1920 píxeles en ninguna orientación. TikTok la descarga desde una URL verificada. La publicación admite un título de hasta 90 caracteres, una descripción, un nivel de privacidad y una imagen de portada.

easyCoexistence publica fotos en TikTok con publish_tiktok_post desde Claude, ChatGPT o tu propio código: indica de 1 a 35 enlaces de imagen, un título y una descripción, y luego consulta el estado de la publicación con get_tiktok_publish_status.

35

Número máximo de imágenes que admite una publicación de fotos en el endpoint de publicación de fotos de TikTok.

20 MB

Tamaño máximo de archivo por imagen en una publicación de fotos, que debe ser JPG, JPEG o WebP.

1080 x 1920

Resolución máxima de imagen en píxeles para una publicación de fotos, o 1920 x 1080 si la imagen es horizontal.

90

Unidades de código UTF-16 que admite el título de una publicación de fotos; la descripción admite hasta 4000.

¿Qué incluye una publicación de fotos?

Una sola llamada a POST /business/photo/publish/ envía las imágenes y los datos de la publicación:

  • photo_images: hasta 35 URL de imágenes alojadas en un dominio o prefijo de URL verificado.
  • photo_cover_index: la imagen que se usa como portada, contando desde 0, que es el valor predeterminado.
  • post_info.title: hasta 90 unidades de código UTF-16.
  • post_info.caption: hasta 4000 unidades de código UTF-16, con #hashtags y un máximo de 30 @menciones.
  • post_info.privacy_level: quién puede ver la publicación, dentro de las opciones que permite la configuración de la cuenta.
  • post_info.disable_comment: desactiva los comentarios en la publicación.

¿Qué formatos de imagen se admiten?

JPG, JPEG o WebP, cada archivo de hasta 20 MB y sin superar los 1080 por 1920 píxeles, o 1920 por 1080 si la imagen es horizontal. TikTok comprueba el formato solo después de descargar el archivo, así que uno no compatible falla más tarde con file_format_check_failed. publish_tiktok_post rechaza los enlaces que terminan en .png, .gif, .bmp, .heic, .avif o .svg antes de enviar nada.

¿En qué se diferencian el título y la descripción?

Son campos distintos, cada uno con su propio límite. El título admite hasta 90 unidades de código UTF-16. La descripción es el texto de la publicación, de hasta 4000, y puede incluir #hashtags y @menciones de seguidores mutuos de la cuenta, con un máximo de 30. Ambos se cuentan en unidades de código UTF-16, así que un emoji puede ocupar dos o más. publish_tiktok_post los recibe como title y caption.

¿Quién ve la publicación y se puede comentar?

privacy_level determina quién la ve: PUBLIC_TO_EVERYONE, MUTUAL_FOLLOW_FRIENDS, FOLLOWER_OF_CREATOR o SELF_ONLY, dentro de las opciones que devuelve GET /business/video/settings/ para la cuenta. TikTok solo ofrece PUBLIC_TO_EVERYONE a las cuentas públicas, y es el nivel que aplica publish_tiktok_post. Los comentarios están activados salvo que disable_comment sea true, y en una cuenta que no admite comentarios de nadie solo se acepta true.

¿Qué pasa después de la llamada?

TikTok devuelve un share_id y descarga las imágenes en segundo plano. get_tiktok_publish_status recibe ese share_id y devuelve PROCESSING_DOWNLOAD mientras TikTok descarga las imágenes, PUBLISH_COMPLETE cuando la publicación ha superado la moderación, o FAILED con un motivo como photo_pull_failed. Con este endpoint, TikTok limita las publicaciones de fotos a seis por minuto y 15 al día por cuenta.

Errores comunes

  • Enviar imágenes PNG. Las publicaciones de fotos de TikTok solo admiten JPG, JPEG o WebP, así que convierte los archivos antes de publicar.
  • Contar los caracteres del título tal como se ven. TikTok cuenta unidades de código UTF-16, así que un título con emojis llega antes a 90.
  • Usar imágenes de más de 1080 por 1920 píxeles. Es la resolución máxima que TikTok admite en publicaciones de fotos, así que redimensiona antes las imágenes más grandes.
  • Colocar la portada en una posición que no sea la primera. publish_tiktok_post usa la primera imagen como portada.
Hacerlo con EasyCoexistence

También puedes programar las publicaciones de fotos para la fecha y hora que elijas, desde la propia cola de easyCoexistence. De US$ 9 a US$ 0.75 por conexión al mes, un precio que baja a medida que añades conexiones, con los primeros 3 días gratis.

Preguntas frecuentes

¿Cuántas fotos puede tener una publicación de TikTok por API?

Hasta 35, cada una en un archivo JPG, JPEG o WebP de no más de 20 MB.

¿Se pueden usar imágenes PNG en una publicación de fotos de TikTok?

No. El endpoint de fotos admite JPG, JPEG y WebP, y TikTok da error con un PNG después de descargarlo, con file_format_check_failed.

¿Cuántos caracteres puede tener el título de una publicación de fotos?

Hasta 90 unidades de código UTF-16. La descripción es un campo aparte y admite hasta 4000.

¿Qué imagen se usa como portada?

La que indica photo_cover_index, contando desde 0. publish_tiktok_post lo deja en 0, así que la portada es la primera imagen.

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