Skip to Content
Cut.ProDocs

White-label

Ofrece recortes, renders y publicación con tu marca: un workspace por cliente y un enlace para que conecte sus propias redes, sin cuenta en Cut.Pro.

Los términos de uso permiten revender la API, ofrecerla en white-label y construir tu propio producto sobre ella, con tu marca y tu precio, sin contrato aparte. Esta página muestra el flujo: cada cliente tiene un workspace, conecta sus redes con un enlace y tú operas todo por la API.

1. Crea un workspace por cliente

El workspace separa los videos, clips, renders, cuentas conectadas y publicaciones de cada cliente.

curl -X POST https://api.cut.pro/api/v1/workspaces \
  -H "X-Api-Key: $CUTPRO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "name": "Panadería Central" }'
201 Created
{ "id": "7412990011220001", "name": "Panadería Central", "is_personal": false, "created_at": "2026-11-20T15:00:00.000Z" }

La clave que lo creó ya alcanza el workspace nuevo. Guarda el id junto al cliente en tu sistema y envíalo en X-Workspace-Id en cada llamada de ese cliente:

curl https://api.cut.pro/api/v1/connections \
  -H "X-Api-Key: $CUTPRO_API_KEY" \
  -H "X-Workspace-Id: 7412990011220001"

Sin el header, las solicitudes siguen cayendo donde caían antes de que crearas workspaces, así que lo que ya funcionaba no cambia. GET /workspaces los lista y PATCH /workspaces/{id} cambia el nombre.

Los créditos y el plan son de cada workspace. Un workspace nuevo empieza en el plan gratuito, sin créditos.

2. Pide el enlace de conexión

curl -X POST https://api.cut.pro/api/v1/connections/link \
  -H "X-Api-Key: $CUTPRO_API_KEY" \
  -H "X-Workspace-Id: 7412990011220001" \
  -H "Content-Type: application/json" \
  -d '{
    "platform": "instagram",
    "return_url": "https://app.tumarca.com/clientes/42/redes",
    "state": "cliente-42"
  }'
200 OK
{ "url": "https://api.cut.pro/api/v1/connections/start?link=…", "expires_at": "2026-11-21T15:00:00.000Z" }

Entrega el url a tu cliente: en un botón de tu panel, por correo o por mensaje. Lo abre, inicia sesión en la red y autoriza. Nadie necesita cuenta en Cut.Pro.

CampoQué hace
platformyoutube, tiktok, instagram, facebook, threads, linkedin, pinterest, bluesky, twitch, kick o discord.
return_urlAdónde va la persona al terminar. https, o http en localhost mientras pruebas. Sin él, llega a Cut.Pro.
stateCualquier texto tuyo, hasta 512 caracteres, que vuelve intacto. Úsalo para saber de qué cliente es la respuesta.
connection_idReconecta una cuenta cuyo acceso se perdió, conservando su id y las publicaciones programadas.

El enlace sirve una vez y vence en 24 horas. Si la persona cancela o el inicio de sesión falla, el mismo enlace vuelve a funcionar. Mientras un inicio de sesión está en curso, una segunda pestaña recibe LINK_IN_USE.

3. Recibe el regreso

Cuando la persona termina, el navegador va al return_url con:

ParámetroValor
statusconnected o error.
platformLa red del enlace.
connection_idsLos id de las cuentas conectadas, separados por comas. Llega más de uno cuando un inicio de sesión de Facebook autoriza varias Páginas.
warningFACEBOOK_PAGES_PARTIAL cuando parte de las Páginas no cupo en el límite.
codeEn error, el motivo, como LINK_EXPIRED, LINK_USED, CONNECTION_LIMIT_REACHED o el error que devolvió la red.
stateTu state, tal como lo enviaste.
https://app.tumarca.com/clientes/42/redes?status=connected&platform=instagram&connection_ids=7412990011229001&state=cliente-42

El regreso pasa por el navegador de la persona. Antes de guardar la conexión en tu sistema, confírmala con GET /connections/{id} en el workspace del cliente en lugar de confiar solo en la URL.

La conexión ocurre sin ninguna pantalla de Cut.Pro en medio. Por eso Facebook conecta todas las Páginas que la persona autorizó, LinkedIn conecta el perfil y Tumblr el blog principal, hasta el límite de cuentas del plan.

4. Opera como siempre

Con el X-Workspace-Id del cliente, el resto de la API funciona igual: recorta, renderiza y publica en sus cuentas. Para entregar el video desde tu dominio, descarga el MP4 y sírvelo desde tu almacenamiento.

Lo que todavía se ve

  • La pantalla de autorización de Google, TikTok y Meta muestra el nombre de la aplicación, que es el de Cut.Pro. Cada red exige una aplicación revisada por ella, así que ese nombre no cambia por cliente.
  • El enlace de conexión pasa por api.cut.pro un instante antes de abrir el inicio de sesión de la red.

Errores

CodeCuándo
WORKSPACE_LIMIT_REACHEDLa cuenta llegó al límite de workspaces creados por la API.
INVALID_RETURN_URLreturn_url no es https (ni http en localhost).
CONNECTION_LIMIT_REACHEDEl workspace ya tiene el máximo de cuentas de esa red que permite el plan.
PLATFORM_UNAVAILABLEEl plan del workspace no incluye la red, o todavía no se liberó.
CONNECTION_NOT_FOUNDEl connection_id para reconectar no es de este workspace o es de otra red.

En esta página