Iniciar sesiónEmpezar prueba gratis
easyCoexistence APIs oficiales

Enviar un video a los borradores de un creador de TikTok mediante la API

Las APIs de TikTok envían un video a los borradores de un creador con el flujo de subida: /v2/post/publish/inbox/video/init/ de Content Posting API lo sube con el scope video.upload, y TikTok envía al creador una notificación en su bandeja para editarlo y publicarlo en la app. La API for Business hace lo mismo con upload_to_draft en /business/video/publish/, o con is_draft en publicaciones de fotos.

easyCoexistence publica videos y publicaciones de fotos de TikTok con publish_tiktok_post desde Claude, ChatGPT o tu propia plataforma, ahora o en una fecha y hora de hasta 90 días de antelación, y cada publicación programada aparece en la pantalla de Publicaciones hasta que sale.

video.upload

Scope que TikTok define como compartir contenido en la cuenta del creador como borrador para editar y publicar después en TikTok.

5 pending

Máximo de envíos pendientes que la Content Posting API permite en cualquier periodo de 24 horas, un límite que TikTok fija para reducir el spam.

SEND_TO_USER_INBOX

El estado /business/publish/status/ informa cuando un borrador se ha subido y TikTok ha notificado la bandeja del creador.

6 a minute

Peticiones que cada token de acceso de usuario puede enviar al endpoint de subida de la Content Posting API.

Ignored

Qué ocurre con los demás campos de post_info cuando upload_to_draft es true en /business/video/publish/.

¿En qué se diferencia un borrador de una publicación directa?

En quién pulsa Publicar. Una publicación directa sale en vivo cuando TikTok la ha procesado; un borrador llega a la bandeja de TikTok del creador y solo se publica cuando el creador lo abre, lo edita como quiera y lo publica. La diferencia atraviesa las dos APIs de publicación de TikTok:

Draft (upload)Direct post
Who postsThe creator, in the TikTok appThe app, through the API
Token scopevideo.upload, on both APIsvideo.publish on the Content Posting API
Content Posting API/v2/post/publish/inbox/video/init//v2/post/publish/video/init/
API for Businessupload_to_draft or is_draft set to trueThe same endpoints without them
Status once handed overSEND_TO_USER_INBOXPUBLISH_COMPLETE once live
Caption and settingsMostly finished by the creator in TikTokSent in the call

¿Cómo sube un borrador la Content Posting API?

Con un POST a https://open.tiktokapis.com/v2/post/publish/inbox/video/init/, un token de acceso de usuario con video.upload y un objeto source_info. PULL_FROM_URL hace que TikTok obtenga el video desde un dominio o prefijo de URL que la app haya verificado; FILE_UPLOAD devuelve un upload_url, al que el archivo se envía en fragmentos mediante peticiones PUT. El publish_id devuelto va a /v2/post/publish/status/fetch/; las fotos usan /v2/post/publish/content/init/ con post_mode configurado en MEDIA_UPLOAD, y TikTok pide a las apps que indiquen a los usuarios que abran la notificación de la bandeja para seguir editando en TikTok:

Upload a video to the creator's inbox from a URL
curl -X POST 'https://open.tiktokapis.com/v2/post/publish/inbox/video/init/' \
  -H 'Authorization: Bearer <USER_ACCESS_TOKEN>' \
  -H 'Content-Type: application/json; charset=UTF-8' \
  -d '{
    "source_info": {
      "source": "PULL_FROM_URL",
      "video_url": "https://media.example.com/tiktok/draft.mp4"
    }
  }'

# data.publish_id: pass it to /v2/post/publish/status/fetch/

¿Qué límites se aplican a los borradores de la Content Posting API?

TikTok los documenta en su referencia de subida; cada uno lo devuelve la llamada init cuando corresponde:

  • Borradores pendientes: como máximo 5 envíos pendientes en cualquier periodo de 24 horas; a partir de ahí, spam_risk_too_many_pending_share con HTTP 403.
  • Peticiones: 6 por minuto por token de acceso de usuario; después, rate_limit_exceeded con HTTP 429.
  • Scope: un token sin video.upload recibe scope_not_authorized con HTTP 401.
  • Medios: PULL_FROM_URL desde un dominio o prefijo que la app no ha verificado recibe url_ownership_unverified con HTTP 403.

¿Cómo sube un borrador la API for Business?

Con sus endpoints de publicación y un campo más en post_info. En /business/video/publish/, upload_to_draft en true envía el video como borrador, y TikTok ignora los demás campos de post_info; en /business/photo/publish/, is_draft conserva solo el título y la descripción. Ambos necesitan video.upload en el token de la cuenta, que /tt_user/token_info/get/ lista; si falta, el propietario aprueba la subida de borradores autorizando la app de nuevo. El medio sigue en una URL verificada, el estado indica SEND_TO_USER_INBOX y el creador encuentra el borrador mediante la notificación de la bandeja:

Send a video to the creator's drafts on the API for Business
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/draft.mp4",
    "post_info": {
      "upload_to_draft": true,
      "is_brand_organic": false,
      "is_branded_content": false
    }
  }'

¿Qué hace el creador con el borrador?

Lo termina en TikTok. La notificación de la bandeja abre el video o las fotos subidos en el editor de TikTok, donde el creador los revisa, los edita y los publica. En la Content Posting API, el estado pasa de SEND_TO_USER_INBOX a PUBLISH_COMPLETE cuando el creador publica desde el borrador, y TikTok señala que un mismo borrador puede generar más de una publicación.

¿easyCoexistence envía borradores?

No: publish_tiktok_post publica. Llama a /business/video/publish/ o /business/photo/publish/ sin upload_to_draft ni is_draft, de modo que una publicación sale en vivo cuando TikTok la ha procesado. Para retener una publicación y revisarla, programala con scheduled_at, con una antelación de 1 minuto a 90 días: espera en Próximas en la pantalla de Publicaciones, update_scheduled_post cambia su hora, descripción o el título de una publicación de fotos, y cancel_scheduled_post la detiene antes de que salga.

Errores comunes

  • Pedir video.publish para enviar borradores. Los borradores necesitan video.upload, el scope que TikTok describe como compartir contenido como borrador.
  • Poner una descripción a un borrador de video mediante la API for Business. Con upload_to_draft en true, TikTok ignora el resto de post_info.
  • Subir borradores más rápido de lo que los creadores publican. La Content Posting API se detiene en 5 envíos pendientes en 24 horas con spam_risk_too_many_pending_share.
  • Dejar a los usuarios sin indicación de la bandeja. TikTok pide a las apps que les digan que abran la notificación de la bandeja para terminar la publicación.
Hacerlo con EasyCoexistence

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

Preguntas frecuentes

¿Puede la API de TikTok guardar un video como borrador?

Sí. El flujo de subida lo coloca en la bandeja de TikTok del creador, donde el creador lo edita y lo publica; el token necesita el scope video.upload.

¿Dónde aparece un borrador enviado por la API?

En la app de TikTok, detrás de una notificación de la bandeja que abre el video en el editor de TikTok para que el creador lo termine.

¿Puede un borrador de TikTok conservar mi descripción?

En la API for Business, un borrador de foto conserva su título y descripción, mientras que un borrador de video descarta el resto de campos de post_info.

¿Puede un borrador de TikTok convertirse en más de una publicación?

Sí. TikTok señala que un borrador puede generar más de una publicación, y en la Content Posting API el estado pasa a PUBLISH_COMPLETE cuando el creador publica desde él.

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