Publicando nas redes

Depois de renderizar um clipe, você pode publicá-lo em uma ou mais contas conectadas com POST /posts. Um único post pode levar vários clipes para várias contas de uma vez.

Antes de começar

Você precisa de duas coisas:

Um clipe renderizado

O editId é o edit_setting_id que o render devolve quando concluído. É ele que identifica o vídeo a publicar

Contas conectadas

O connectionId vem de GET /connections. Conecte novas contas pelo OAuth dentro de cut.pro: a API não conecta contas

Como o corpo é montado

Cada item de videos aponta um clipe (editId) para um ou mais destinos (targets). Cada destino combina uma conexão (connectionId) com a metadata específica daquela plataforma (título, privacidade, 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": "7412908490112775",
        "targets": [
          {
            "connectionId": "7399001244553012",
            "metadata": {
              "tiktok": {
                "title": "Meu corte viral",
                "privacyLevel": "PUBLIC_TO_EVERYONE"
              }
            }
          },
          {
            "connectionId": "7399001244553099",
            "metadata": {
              "youtube": {
                "title": "Meu corte viral",
                "description": "Cortes do episódio de hoje",
                "categoryId": "22",
                "privacyStatus": "public"
              }
            }
          }
        ]
      }
    ]
  }'

Resposta 201

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

A metadata muda por plataforma (TikTok, YouTube, Instagram, Threads, Bluesky, LinkedIn, Pinterest, Facebook). Os campos obrigatórios e as opções de cada uma estão detalhados na página do endpoint POST /posts, com o playground interativo.

Dica

Para agendar em vez de publicar agora, envie scheduled_at com uma data ISO 8601 no futuro.

Acompanhe a publicação

O post entra na fila e publica de forma assíncrona. Faça polling em GET /posts/{id}:

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

O status do post evolui assim:

Status	Significado
pending	Na fila, ainda não começou
processing	Publicando nas contas
completed	Todos os itens publicaram
partial	Alguns publicaram, outros falharam
failed	Nenhum item publicou

O array items mostra o resultado por conta, que é o que importa quando o status é partial.

Quando algo falha

Itens falham de forma independente: um destino com erro não derruba os que já publicaram.

• Reenviar um item que falhou: POST /posts/{id}/items/{itemId}/retry
• Remover um item sem mexer nos demais: DELETE /posts/{id}/items/{itemId}
• Apagar o post inteiro: DELETE /posts/{id}
• Editar antes de publicar (por exemplo, ajustar o agendamento): PATCH /posts/{id}