Iniciar sesiónEmpezar prueba gratis
easyCoexistence APIs oficiales

Cómo publicar un video en TikTok a través de la API

Para publicar un video con la API for Business de TikTok, envía POST /business/video/publish/ con el business_id de la cuenta, un video_url en un dominio o prefijo de URL verificado y un objeto post_info con el caption y la configuración, junto con el encabezado Access-Token. TikTok responde con un share_id; pásalo como publish_id a /business/publish/status/ hasta que el estado indique PUBLISH_COMPLETE y aparezcan los post_ids.

easyCoexistence publica videos de TikTok con publish_tiktok_post desde Claude, ChatGPT o tu propio agente: pasa un enlace HTTPS, el caption y si los comentarios están activados, y luego sigue la publicación con get_tiktok_publish_status, mientras el archivo llega a TikTok por su ruta de medios verificada.

share_id

Lo devuelve la llamada de publicación, como v_pub_url~v1.2345123456789123456, y se pasa a la llamada de estado como publish_id.

Nov 16, 2023

Desde entonces, TikTok rechaza publicar videos desde URLs cuyo dominio o prefijo de URL no esté verificado.

6 a minute

El límite de TikTok de publicaciones de video por cuenta a través del endpoint de publicación: como máximo 15 al día.

3 min

El tiempo que pueden tardar en aparecer los post_ids después de PUBLISH_COMPLETE; TikTok recomienda reintentar tras tres minutos.

post_id

Se envía en el webhook post.publish.publicly_available una vez que la publicación supera la moderación, lista para consultar sus estadísticas.

¿Qué necesitas antes de la primera llamada?

Tres cosas. Un token de acceso de la cuenta de TikTok y el open_id de la cuenta, obtenidos del intercambio de token; una app de desarrollador con el permiso Video Publish en TikTok Accounts; y el video en una URL pública HTTPS o HTTP que esté bajo un dominio o prefijo de URL verificado para la app. TikTok descarga el archivo por sí mismo, así que debe seguir accesible, y TikTok recomienda una URL que dure al menos 30 minutos.

¿Cómo es la petición de publicación?

Un POST a https://business-api.tiktok.com/open_api/v1.3/business/video/publish/ con el token de la cuenta en el encabezado Access-Token y Content-Type configurado como application/json. El cuerpo JSON indica la cuenta en business_id, el archivo en video_url y la configuración de la publicación en post_info; este ejemplo publica un video con caption, con comentarios, Duet y Stitch activados:

Publish a video with curl
curl -X POST 'https://business-api.tiktok.com/open_api/v1.3/business/video/publish/' \
  -H 'Access-Token: <ACCESS_TOKEN>' \
  -H 'Content-Type: application/json' \
  -d '{
    "business_id": "<OPEN_ID>",
    "video_url": "https://media.example.com/tiktok/launch.mp4",
    "post_info": {
      "caption": "Our new menu is live #food",
      "is_brand_organic": false,
      "is_branded_content": false,
      "disable_comment": false,
      "disable_duet": false,
      "disable_stitch": false
    }
  }'

¿Qué hace cada campo del cuerpo?

Los campos que la referencia de TikTok enumera para una publicación de video, empezando por el nivel superior. La portada, la etiqueta de contenido generado por IA, una ubicación, los borradores y la opción solo para anuncios van en el mismo cuerpo:

  • business_id: el open_id de la cuenta obtenido del intercambio de token.
  • video_url: el archivo que TikTok descarga, MP4, MOV o WebM, en un dominio o prefijo de URL verificado.
  • post_info: obligatorio en cada llamada, incluso como objeto vacío, y contiene la configuración de la publicación.
  • post_info.caption: hasta 2,200 caracteres contados en UTF-16, con #hashtags y hasta 30 @menciones.
  • post_info.is_brand_organic y is_branded_content: las etiquetas Contenido promocional y Colaboración pagada, que la tabla de TikTok marca como obligatorias.
  • post_info.disable_comment, disable_duet y disable_stitch: true desactiva los comentarios, Duet o Stitch; los tres valen false por defecto.

¿Qué devuelve TikTok?

El sobre habitual, con el ID de la tarea de publicación en data. Un código 0 significa que TikTok aceptó la tarea, no que el video esté en línea: TikTok todavía debe descargar el archivo, revisarlo y moderar la publicación. En los ejemplos de TikTok, el share_id de un video empieza con v_pub_url y el de una publicación de fotos con p_pub_url.

The publish response
{
  "code": 0,
  "message": "Ok",
  "request_id": "20210817034316010245031056097316BA",
  "data": {
    "share_id": "v_pub_url~v1.2345123456789123456"
  }
}

¿Cómo sigues la publicación hasta que esté en línea?

Con GET /business/publish/status/, pasando business_id y el share_id como publish_id. El campo status indica PROCESSING_DOWNLOAD mientras TikTok descarga el archivo, PUBLISH_COMPLETE una vez que la publicación supera la moderación, o FAILED con un motivo. post_ids llega con PUBLISH_COMPLETE cuando la publicación es visible públicamente, y puede tardar hasta tres minutos. Así es el flujo completo en Python:

Publish and follow a video in Python
import os, time, requests

API = "https://business-api.tiktok.com/open_api/v1.3"
HEADERS = {"Access-Token": os.environ["TIKTOK_ACCESS_TOKEN"]}
BUSINESS_ID = os.environ["TIKTOK_BUSINESS_ID"]  # open_id from the token exchange

def call(method, path, **kwargs):
    body = requests.request(method, f"{API}/{path}", headers=HEADERS, timeout=30, **kwargs).json()
    if body.get("code") != 0:  # errors arrive in code, usually with HTTP 200
        raise RuntimeError(f"{body.get('code')}: {body.get('message')}")
    return body["data"]

share_id = call("POST", "business/video/publish/", json={
    "business_id": BUSINESS_ID,
    "video_url": "https://media.example.com/tiktok/launch.mp4",
    "post_info": {"caption": "Our new menu is live #food",
                  "is_brand_organic": False, "is_branded_content": False},
})["share_id"]

for _ in range(30):
    time.sleep(60)  # each check is a call; TikTok's stages take minutes
    s = call("GET", "business/publish/status/",
             params={"business_id": BUSINESS_ID, "publish_id": share_id})
    if s["status"] == "FAILED":
        raise RuntimeError(s.get("reason"))
    if s["status"] == "PUBLISH_COMPLETE" and s.get("post_ids"):
        print("Live:", s["post_ids"])
        break

¿Puede un webhook reemplazar las consultas de estado?

Sí, para una app que se suscribe al event_type VIDEO con /business/webhook/update/. TikTok envía entonces post.publish.failed o post.publish.complete una vez que ha descargado y revisado el archivo, post.publish.publicly_available con el nuevo post_id cuando la publicación supera la moderación, y post.publish.no_longer_publicly_available si la publicación deja de ser visible públicamente más adelante. Cada evento indica la tarea en publish_id, el mismo valor que el share_id.

¿Cómo publicas un video a través de MCP?

Pídelo en lenguaje natural a Claude, ChatGPT u otro cliente conectado a https://easycoexistence.com/api/mcp. El asistente llama a publish_tiktok_post con el account_id de list_social_accounts, una video_url HTTPS, el caption y, si quieres los comentarios desactivados, disable_comment. El resultado trae el share_id de TikTok, y get_tiktok_publish_status, con el account_id y ese share_id, devuelve el estado, los post_ids y el motivo tal como están en ese momento en TikTok.

The MCP tool calls and their results
publish_tiktok_post {
  "account_id": "<ACCOUNT_ID>",
  "video_url": "https://media.example.com/tiktok/launch.mp4",
  "caption": "Our new menu is live #food",
  "disable_comment": false
}
=> { "share_id": "v_pub_url~v1.2345123456789123456",
     "note": "TikTok is processing the post. Check it with get_tiktok_publish_status." }

get_tiktok_publish_status { "account_id": "<ACCOUNT_ID>", "share_id": "v_pub_url~v1.2345123456789123456" }
=> { "status": "PUBLISH_COMPLETE", "post_ids": ["<POST_ID>"] }

¿Qué envía publish_tiktok_post a TikTok?

Una llamada al mismo endpoint, completada con tu petición. Tu enlace llega a TikTok como un enlace firmado bajo la ruta de medios verificada de easyCoexistence, así que no necesita verificación propia; el caption y disable_comment se envían tal como los diste; e is_brand_organic e is_branded_content se envían como false. El resto de la configuración, como Duet, Stitch, la portada y la etiqueta de contenido generado por IA, conserva los valores por defecto de TikTok, y el video se publica como publicación pública, tal como está diseñado el endpoint.

¿Qué puedes hacer con las credenciales de la API de socios?

Llamar a TikTok directamente como la cuenta. GET /channels/{id}?credentials=1 en https://easycoexistence.com/api/v1, con tu clave ec_live_ como token bearer, devuelve el canal con un objeto credentials: api_base, business_id, un access_token vigente y token_expires_at. Las consultas de estado, las listas de videos, los comentarios y las estadísticas se ejecutan entonces desde tu propio código. La publicación es la parte que hay que planificar: una llamada directa de publicación pasa video_url a TikTok sin cambios, las propiedades de URL se añaden con el ID y el secreto de una app de desarrollador propia, y el prefijo que la app de easyCoexistence tiene verificado es su ruta de medios, que usa publish_tiktok_post.

Credentials from the Partner API, then a direct status check
curl "https://easycoexistence.com/api/v1/channels/$CHANNEL_ID?credentials=1" \
  -H "Authorization: Bearer $EC_API_KEY"

# "credentials": {
#   "platform": "tiktok",
#   "api_base": "https://business-api.tiktok.com/open_api/v1.3",
#   "business_id": "<OPEN_ID>",
#   "access_token": "<ACCESS_TOKEN>",
#   "token_expires_at": "2026-11-01T09:00:00.000Z", ...
# }

curl -G 'https://business-api.tiktok.com/open_api/v1.3/business/publish/status/' \
  -H 'Access-Token: <ACCESS_TOKEN>' \
  --data-urlencode 'business_id=<OPEN_ID>' \
  --data-urlencode 'publish_id=<SHARE_ID>'

Cómo configurarlo

  1. Get the token and the account IDExchange the owner's authorization code at /tt_user/oauth2/token/, and keep access_token for the header and open_id for business_id.
  2. Host the videoPut the MP4, MOV or WebM file under a domain or URL prefix verified for your app, where it stays reachable for at least 30 minutes.
  3. Call the publish endpointPOST business_id, video_url and post_info, with the caption, the two brand flags and the engagement switches, to /business/video/publish/.
  4. Keep the share_idStore data.share_id from the response, the ID of this publishing task.
  5. Check the statusEvery few minutes, GET /business/publish/status/ with business_id and the share_id as publish_id, until PUBLISH_COMPLETE or FAILED.
  6. Record the post IDTake it from post_ids, or from post_id in the post.publish.publicly_available webhook, to read the video's metrics later.

Errores comunes

  • Olvidar post_info. TikTok exige el objeto en cada llamada, incluso cuando no cambia ninguna configuración.
  • Buscar un ID de publicación en la respuesta de publicación. Solo devuelve share_id; los post_ids llegan con la llamada de estado o con el webhook publicly_available.
  • Repetir una llamada de publicación que agotó el tiempo de espera. La primera petición pudo llegar a TikTok, así que revisa las últimas publicaciones de la cuenta antes de enviarla de nuevo.
  • Tomar el código 0 como video en línea. Significa que TikTok aceptó la tarea, y el archivo aún puede fallar sus revisiones después de la descarga.
Hacerlo con EasyCoexistence

Desde US$ 9 hasta US$ 0.75 por conexión al mes, bajando a medida que añades conexiones, con los primeros 3 días gratis.

Preguntas frecuentes

¿Qué endpoint publica un video en TikTok?

POST https://business-api.tiktok.com/open_api/v1.3/business/video/publish/, con el token de la cuenta en el encabezado Access-Token y business_id, video_url y post_info en el cuerpo JSON.

¿Puede la API de TikTok subir un archivo de video directamente?

No a través de /business/video/publish/. Recibe video_url y descarga el archivo desde allí, así que el video necesita una URL en un dominio o prefijo de URL verificado.

¿Cómo obtengo el ID de un video publicado por la API?

De post_ids en /business/publish/status/ cuando el estado sea PUBLISH_COMPLETE y la publicación sea pública, o de post_id en el webhook post.publish.publicly_available.

¿Puedo programar un video de TikTok para más tarde a través de la API?

El endpoint de publicación publica en el momento en que se le llama y no tiene campo de hora. easyCoexistence guarda las publicaciones programadas en su propia cola y llama a TikTok a la hora que configures.

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