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" }'{ "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"
}'{ "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.
| Campo | Qué hace |
|---|---|
platform | youtube, tiktok, instagram, facebook, threads, linkedin, pinterest, bluesky, twitch, kick o discord. |
return_url | Adónde va la persona al terminar. https, o http en localhost mientras pruebas. Sin él, llega a Cut.Pro. |
state | Cualquier texto tuyo, hasta 512 caracteres, que vuelve intacto. Úsalo para saber de qué cliente es la respuesta. |
connection_id | Reconecta 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ámetro | Valor |
|---|---|
status | connected o error. |
platform | La red del enlace. |
connection_ids | Los 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. |
warning | FACEBOOK_PAGES_PARTIAL cuando parte de las Páginas no cupo en el límite. |
code | En error, el motivo, como LINK_EXPIRED, LINK_USED, CONNECTION_LIMIT_REACHED o el error que devolvió la red. |
state | Tu state, tal como lo enviaste. |
https://app.tumarca.com/clientes/42/redes?status=connected&platform=instagram&connection_ids=7412990011229001&state=cliente-42El 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.proun instante antes de abrir el inicio de sesión de la red.
Errores
| Code | Cuándo |
|---|---|
WORKSPACE_LIMIT_REACHED | La cuenta llegó al límite de workspaces creados por la API. |
INVALID_RETURN_URL | return_url no es https (ni http en localhost). |
CONNECTION_LIMIT_REACHED | El workspace ya tiene el máximo de cuentas de esa red que permite el plan. |
PLATFORM_UNAVAILABLE | El plan del workspace no incluye la red, o todavía no se liberó. |
CONNECTION_NOT_FOUND | El connection_id para reconectar no es de este workspace o es de otra red. |