API de TikTok - Ayrshare API Documentation

Ayrshare ofrece publicación directa de videos de TikTok, gestión de comentarios y obtención de analíticas avanzadas para tu cuenta personal o business de TikTok usando la API de TikTok.TikTok procesa videos y fotos de forma asíncrona, por lo que la respuesta JSON tendrá status: “pending” tanto para publicaciones inmediatas como programadas. Una vez que TikTok complete el procesamiento, se llamará al webhook Scheduled Action que hayas registrado.

Publicación de video en TikTok

JSON para una publicación básica de video en TikTok que se publica directamente:

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"]
}

Ejemplo de respuesta JSON de la publicación:

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

TikTok actualmente no admite saltos de línea en el texto de la publicación. Los saltos de línea incluidos serán ignorados.
Se puede publicar un video o hasta 35 imágenes. TikTok no admite combinar video e imágenes. Consulta a continuación más detalles.
Si el video no termina con una extensión conocida, usa isVideo.
TikTok también admite el envío de medios sin texto de publicación. Si no quieres incluir texto en la publicación, envía una cadena vacía post: "".
Consulta las Directrices de medios de TikTok y la Autorización de TikTok para más información.

Requisitos de video de TikTok

Consulta los Requisitos de video de TikTok.
El video debe terminar con una extensión de video conocida como mp4. Puedes hacer reverse proxy de la URL, añadir una URL personalizada con un CDN, o usar el endpoint /media.
El límite de caracteres del texto de la publicación en TikTok es de 2200.

TikTok limita la publicación de videos por la API a 6 videos por minuto con un límite superior de 15 videos por día.

Publicación de imagen en TikTok

JSON para una publicación básica de imagen (foto) en TikTok que se publica directamente:

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"]
}

Ejemplo de respuesta 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"
}

TikTok actualmente no admite saltos de línea en el texto de la publicación. Los saltos de línea incluidos serán ignorados.
Se puede publicar un video o hasta 35 imágenes.
TikTok no admite combinar video e imágenes. Consulta a continuación más detalles.
Las imágenes deben ser de tipo JPG, JPEG o WEBP. TikTok no acepta archivos de medios PNG.
También puedes seleccionar una de las imágenes como foto de portada con imageCoverIndex. Por defecto, se usa la primera imagen. Consulta más detalles a continuación.

Requisitos de imagen de TikTok

Consulta los Requisitos de imagen de TikTok.
Se pueden incluir hasta 35 imágenes en una publicación, con un máximo de 20 MB por imagen.
Las imágenes deben ser de tipo JPG, JPEG o WEBP. TikTok no acepta archivos de medios PNG.
El límite de caracteres del texto de la publicación en TikTok es de 2200.

TikTok limita la publicación por la API a 6 fotos por minuto con un límite superior de 15 fotos por día.

Procesamiento de TikTok

TikTok realiza un procesamiento asíncrono de videos e imágenes, por lo que la respuesta tendrá el campo id establecido en "pending". Después de que TikTok complete su procesamiento, normalmente en 1-2 minutos, el campo id se actualizará con el id del video de TikTok y se añadirá un postUrl.

Puedes recuperar el estado final de la publicación de TikTok usando webhooks o el endpoint /history y suele tardar entre 1 y 2 minutos en estar disponible.
Cuando el usuario publica el video en la app móvil de TikTok, se enviará un webhook “scheduled” con subAction: "tikTokPublished".
Un primer comentario en una publicación de TikTok se difiere: se publica automáticamente una vez que el webhook tikTokPublished resuelve el id real del video, no en el momento de la publicación. La visibility del video debe ser public; de lo contrario, no se podrá publicar el primer comentario y se devolverá un error de comentario.
Si ocurre un error, como que TikTok no pudo procesar el video o fallaron las pruebas internas de Ayrshare, el campo id se establecerá en “failed” y el campo errors contendrá los detalles del error.
El idShare se usa para referencia interna del video pendiente.

Opciones de TikTok

Al publicar un video o imágenes en TikTok hay opciones adicionales disponibles. Ejemplo de publicación de video:

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

Ejemplo de publicación de imagen:

TikTok Image Publishing

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

Opciones

Las siguientes opciones están disponibles para publicaciones de TikTok. Deben añadirse dentro del objeto tikTokOptions. Consulta a continuación más detalles sobre cada opción.

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

predeterminado:false

Si se debe agregar automáticamente música recomendada a la publicación. Si estableces este campo en true, luego podrás cambiar la música desde la app de TikTok.Tipo de medio: image

disableComments

boolean

predeterminado:false

Si se deben deshabilitar los comentarios en la publicación publicada.Tipo de medio: video, image

disableDuet

boolean

predeterminado:false

Deshabilita los duetos en el video publicado.Tipo de medio: video

disableStitch

boolean

predeterminado:false

Deshabilita stitch en el video publicado.Tipo de medio: video

draft

boolean

predeterminado:false

Si se debe crear una publicación como borrador.Consulta las opciones de borrador para más información.Tipo de medio: video o image

isAIGenerated

boolean

predeterminado:false

Si se debe habilitar el toggle de contenido generado por IA para la publicación de video.Si habilitas el toggle, tu video será etiquetado como “Creator labeled as AI-generated” una vez publicado y no se puede cambiar. La etiqueta “Creator labeled as AI-generated” indica que el contenido fue generado completamente por IA o editado significativamente con IA.

Activar la configuración de contenido generado por IA no afectará la distribución de tu video siempre y cuando no infrinja las Community Guidelines de TikTok.

Tipo de medio: video

isBrandedContent

boolean

predeterminado:false

Si se debe habilitar el toggle de Branded Content. Si este campo se establece en true, el video será etiquetado como Branded Content, indicando que estás en una asociación pagada con una marca. Se adjuntará una etiqueta “Paid partnership” al video.Tipo de medio: video, image

isBrandOrganic

boolean

predeterminado:false

Si se debe habilitar el toggle de Brand Organic Content. Si este campo se establece en true, el video será etiquetado como Brand Organic Content, indicando que estás promocionándote a ti mismo o a tu propio negocio. Se adjuntará una etiqueta “Promotional content” al video.Tipo de medio: video, image

imageCoverIndex

number

predeterminado:"0"

El índice de mediaUrls que se usará como portada de la publicación.Tipo de medio: image

title

string

El título de la publicación.Tipo de medio: image

thumbNailOffset

number

El frame que se usará como portada del video.Consulta las opciones de miniatura de video para más información.Tipo de medio: video

visibility

string

predeterminado:"public"

Cómo se comparte la publicación y quién puede verla.Valores: public, private, followers o friends.Consulta las opciones de visibilidad para más información.Tipo de medio: image

Opciones de visibilidad

Visibility	Descripción
public	Visible para todos los usuarios de TikTok.
private	Privada, solo visible para la propia cuenta.
followers	Solo visible para los seguidores de la cuenta.
friends	Solo visible para seguidores mutuos.

Las publicaciones privadas permanecerán con estado pending y no se enviará ningún webhook de TikTok hasta que la publicación se haga pública.

Miniatura del video

Hay dos formas de establecer una miniatura, también conocida como foto de portada, para un video de TikTok:

Usando el parámetro thumbNailOffset para establecer un frame de miniatura.
Usando el parámetro thumbNail para establecer una imagen de miniatura desde una URL.

Solo se admiten videos para establecer una miniatura.

Offset de miniatura

Establece una miniatura para un video de TikTok seleccionando un frame por offset.

TikTok Video Thumbnail Offset

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

El offset es la ubicación en milisegundos del frame de miniatura. El valor por defecto es 0, que corresponde al primer frame del video.

URL de miniatura

Establece una miniatura para un video de TikTok subiendo una imagen desde una URL.

TikTok Video Thumbnail URL

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

Si usas el parámetro thumbNail, el parámetro thumbNailOffset será ignorado. Consulta los Requisitos de miniatura de TikTok para más información.

Menciones en TikTok

Menciona otro handle de TikTok añadiendo @handle en el texto de la publicación. Por ejemplo:

TikTok Mention

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

Consulta las reglas importantes sobre menciones.

Publicación como borrador en TikTok

Crea una publicación en borrador para un video o imagen de TikTok, lo que te permite editar el video o la imagen antes de publicarlo.

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

La publicación de video o imagen en borrador se encontrará en las notificaciones del Inbox en la fila inferior de la app de TikTok. Busca un mensaje de System notifications y luego haz clic en el mensaje superior Your content from Ayrshare is ready. El postUrl de Ayrshare permanecerá en estado pending hasta que el video se publique. No se admite el primer comentario en publicaciones en borrador.

Renovación de la autorización

TikTok debe reautorizarse cada año a través de la página Social Accounts.

Se enviará una notificación por correo electrónico y por webhook social action con 15 días de anticipación al vencimiento de la autorización.
La fecha en la que se requiere la renovación y los días restantes se pueden obtener desde el endpoint /user.

Límites de caracteres

Consulta Límites de caracteres de TikTok para más información.

Información adicional

Más ejemplos sobre cómo usar la API de TikTok.

​Publicación de video en TikTok

​Requisitos de video de TikTok

​Publicación de imagen en TikTok

​Requisitos de imagen de TikTok

​Procesamiento de TikTok

​Opciones de TikTok

​Opciones

​Opciones de visibilidad

​Miniatura del video

​Offset de miniatura

​URL de miniatura

​Menciones en TikTok

​Publicación como borrador en TikTok

​Renovación de la autorización

​Límites de caracteres

​Información adicional

Publicación de video en TikTok

Requisitos de video de TikTok

Publicación de imagen en TikTok

Requisitos de imagen de TikTok

Procesamiento de TikTok

Opciones de TikTok

Opciones

Opciones de visibilidad

Miniatura del video

Offset de miniatura

URL de miniatura

Menciones en TikTok

Publicación como borrador en TikTok

Renovación de la autorización

Límites de caracteres

Información adicional