Publicando en las redes

Después de renderizar un clip puedes publicarlo en una o varias cuentas conectadas con POST /posts. Una sola publicación puede llevar varios clips a varias cuentas de una vez.

Antes de empezar

Necesitas dos cosas:

Un clip renderizado

El editId es el edit_setting_id que devuelve el render al completarse. Es lo que identifica el vídeo a publicar.

Cuentas conectadas

El connectionId viene de GET /connections. Conecta cuentas nuevas con el OAuth dentro de cut.pro: la API no conecta cuentas.

Cómo se arma el cuerpo

Cada elemento de videos apunta un clip (editId) a uno o más destinos (targets). Cada destino combina una conexión (connectionId) con la metadata específica de esa plataforma (título, privacidad, etc.).

curl -X POST https://api.cut.pro/api/v1/posts \
  -H "X-Api-Key: $CUTPRO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "videos": [
      {
        "editId": "EDIT_SETTING_ID",
        "targets": [
          {
            "connectionId": "CONEXION_TIKTOK",
            "metadata": {
              "tiktok": {
                "title": "Mi corte viral",
                "privacyLevel": "PUBLIC_TO_EVERYONE"
              }
            }
          },
          {
            "connectionId": "CONEXION_YOUTUBE",
            "metadata": {
              "youtube": {
                "title": "Mi corte viral",
                "description": "Cortes del episodio de hoy",
                "categoryId": "22",
                "privacyStatus": "public"
              }
            }
          }
        ]
      }
    ]
  }'

Respuesta 201

{
  "post_id": "7412909001223344",
  "item_count": 2,
  "scheduled_at": null,
  "status": "pending"
}

La metadata cambia según la plataforma (TikTok, YouTube, Instagram, Threads, Bluesky, LinkedIn, Pinterest, Facebook). Los campos obligatorios y las opciones de cada una están detallados en la página del endpoint POST /posts, con el playground interactivo.

Consejo

Para programar en vez de publicar ya, envía scheduled_at con una fecha ISO 8601 en el futuro.

Sigue la publicación

La publicación entra en la cola y publica de forma asíncrona. Haz polling en GET /posts/{id}:

curl https://api.cut.pro/api/v1/posts/POST_ID \
  -H "X-Api-Key: $CUTPRO_API_KEY"

El status de la publicación evoluciona así:

Estado	Significado
pending	En cola, todavía no empezó
processing	Publicando en las cuentas
completed	Todos los elementos publicaron
partial	Algunos publicaron y otros fallaron
failed	Ningún elemento publicó

El array items muestra el resultado por cuenta, útil cuando el estado es partial.

Cuando algo falla

Los elementos fallan de forma independiente: un destino con error no tumba a los que ya publicaron.

• Reintentar un elemento que falló: POST /posts/{id}/items/{itemId}/retry
• Quitar un elemento sin tocar los demás: DELETE /posts/{id}/items/{itemId}
• Borrar la publicación entera: DELETE /posts/{id}
• Editar antes de publicar (por ejemplo, ajustar la programación): PATCH /posts/{id}