Tus publicaciones, por API.
Claves con permisos acotados, simulaciones, programación y webhooks firmados, para los scripts y herramientas que publican por ti, incluidos los flujos que armas en Zapier, Make o n8n. Una clave solo puede hacer lo que su titular le concedió, y una simulación muestra lo que saldría antes de que salga algo.
Free no incluye claves de API que crees tú. Creator 2, Pro 5, Business 10.
La respuesta corta
Tres llamadas, una publicación segura.
Ejemplos reales de solicitud y respuesta. Lista tus cuentas, simula un Reel y luego consulta el trabajo.
1. Lista tus cuentas
Alcance accounts:read, incluido en la clave predeterminada.
curl https://app.blendin.ai/api/v1/accounts \
-H "Authorization: Bearer bln_live_YOUR_KEY"{ "accounts": [ {
"id": "uuid",
"platform": "instagram",
"username": "marta.clay",
"display_name": "Marta Clay Studio",
"connection": "native",
"sign_in": "unified",
"can_publish": true,
"needs_reconnect": false,
"daily_post_limit": 3
} ] }2. Simula un Reel
Alcance publish. Una simulación revisa todo y no publica nada.
curl -X POST https://app.blendin.ai/api/v1/publish \
-H "Authorization: Bearer bln_live_YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{
"video_url": "https://example.com/reel.mp4",
"caption": "Wheel day, three bowls",
"account": "@marta.clay",
"dry_run": true,
"idempotency_key": "reel-001"
}'{ "job": { ... },
"poll": "/api/v1/publish/<id>",
"replayed": false }3. Consulta el trabajo
Cada 5 a 10 segundos. Una simulación termina en container_ready.
curl https://app.blendin.ai/api/v1/publish/<id> \
-H "Authorization: Bearer bln_live_YOUR_KEY"{ "job": {
"id": "uuid",
"status": "container_ready",
"platform": "instagram",
"account_id": "uuid",
"dry_run": true,
"error": null,
"created_at": "...",
"finished_at": "..."
} }Claves que piden solo lo que necesitan.
| ¿Cómo es una clave? | bln_live_ seguido de caracteres aleatorios. Envíala como Authorization: Bearer o en un encabezado X-API-Key. |
|---|---|
| ¿Cómo se guarda? | Solo se guarda su sha256. La clave en sí se muestra una vez, cuando la creas. |
| ¿Quién puede crearla? | Solo el titular del espacio de trabajo, desde una sesión iniciada en la app. Nunca con otra clave. |
| ¿Puedo revocar una clave? | Sí, en cualquier momento. Una clave revocada, vencida o desconocida responde el mismo 401. |
| ¿Cuál es el límite de uso? | 120 solicitudes por minuto por cuenta, compartidas entre todas las claves y todas las conexiones MCP. |
| ¿Cómo son los errores? | Siempre un objeto de error con un código y un mensaje, nunca un stack trace. |
| Por defecto: publish, accounts:read | Publicar y programar, subir archivos, cancelar y listar tus cuentas conectadas. Una clave sin alcances recibe exactamente estos dos. |
|---|---|
| library:read y library:write | Listar publicaciones, leer una, ver el calendario, editar un texto o un primer comentario. |
| analytics:read | Interacción por publicación con totales, métricas de la cuenta y mejores publicaciones. Una publicación que aún reúne datos devuelve su estado y métricas vacías, nunca un cero. |
| comments:read y comments:write | Leer comentarios de cuentas de Instagram conectadas con Instagram Business y publicar una respuesta pública, exactamente con el texto que envíes. |
| inbox:read y inbox:write | Leer conversaciones de DMs y responder dentro de la ventana de 24 horas. Requiere la Bandeja de DMs, que está en despliegue. |
| brand_kits:read y brand_kits:write | Leer kits de marca y editar campos de estilo. Un color que la marca no tiene es null. |
| generate | Iniciar una generación y consultarla. Usa lo que incluye tu plan. |
| lead_flows, link_in_bio, webhooks | Cada uno tiene su propio permiso de lectura y escritura. |
| Free | Creator | Pro | Business | |
|---|---|---|---|---|
| Claves de API que creas tú | 0 | 2 | 5 | 10 |
| Endpoints de webhook | 0 | 1 | 5 | 20 |
| Eventos de webhook | Ninguno | post.published, post.failed, webhook.test | Todos los eventos | Todos los eventos |
Qué hace cada ruta.
| POST /api/v1/publish | Publica o programa un video en Instagram, LinkedIn, Facebook, Threads o YouTube. Admite simulaciones, scheduled_at, claves de idempotencia, portadas de Reels, Reels de prueba y colaboradores. Alcance publish. |
|---|---|
| GET /api/v1/publish/<id> | Lee un trabajo. Cancela uno programado con DELETE en la misma ruta. Alcance publish. |
| POST /api/v1/uploads | Obtén una URL firmada de subida para un video o la portada de un Reel, para que los archivos grandes vayan directo al almacenamiento. |
| GET /api/v1/accounts | Tus cuentas conectadas y si cada una puede publicar o necesita reconectarse. Alcance accounts:read. |
| GET /api/v1/me | Tu plan, lo que te queda para generar, las cuentas conectadas, los kits de marca y los alcances de la clave. |
| GET /api/v1/posts | La biblioteca, de más reciente a más antigua, y una ruta para leer una publicación y editar su texto. Alcance library:read. |
| POST /api/v1/posts/<id>/publish | Publica o programa una publicación existente en LinkedIn, Instagram, Facebook, Threads o TikTok, con una simulación primero. |
| POST /api/v1/posts/<id>/reschedule | Mueve una publicación programada. Sus cuentas se mantienen. |
| GET /api/v1/scheduled | Publicaciones programadas y trabajos de video por API en un rango de fechas. |
| POST /api/v1/uploads/import | Dale a Blendin una URL pública y descarga el video o la imagen por ti. |
| POST /api/v1/media/publish | Publica un video, una imagen o un carrusel por URL. También llega a TikTok con una publicación importada, con el consentimiento de cada publicación. |
Todo lo que crea contenido, como generate, ejecuta la ruta de la propia app como titular de la clave, así que los límites del plan y lo que incluye tu plan se manejan en un solo lugar. La referencia completa está en Developers, dentro de la app, con un botón para copiarla como Markdown para un LLM.
Webhooks firmados, con reintentos.
Firmados con HMAC-SHA256
Cada entrega lleva un encabezado Blendin-Signature con una marca de tiempo y una firma sobre la marca de tiempo y el cuerpo sin procesar, hecha con el secreto de tu endpoint.
Reintentos programados
Una entrega que no responde en 10 segundos se reintenta después de 1 minuto, 5 minutos, 30 minutos y 2 horas, con el mismo id cada vez para que puedas eliminar duplicados.
Se desactiva tras 10 fallos
Un endpoint que falla 10 entregas seguidas se marca como caído y deja de recibir hasta que lo reactivas.
Trece eventos
post.scheduled, post.published, post.failed, draft.created, brand_kit.updated, webhook.test, generation.completed, generation.failed, lead.captured, dm.received, comment.received, account.needs_reconnect y post.deleted.
Conéctalo a las herramientas que usas.
Zapier, Make y n8n pueden escuchar un webhook de Blendin o llamar a la API con una clave, así que una publicación que sale o un lead nuevo pueden iniciar un flujo que armaste ahí. Apuntas su disparador de webhook o su paso HTTP hacia Blendin. Esa es toda la conexión: webhooks firmados y la API pública.
- ZapierMediante webhooks y la API.
- MakeMediante webhooks y la API.
- n8nMediante webhooks y la API.
Los webhooks y las claves de API empiezan en Creator: 1 webhook y 2 claves. Pro tiene 5 y 5, Business 20 y 10. Free no tiene ninguno, y MCP con OAuth sigue funcionando ahí. post.published llega a Creator, y lead.captured está en Pro y Business.
Las marcas pertenecen a sus dueños, se muestran solo para identificar el producto, sin que implique aval.
Lo que la API no hace
Empieza cada integración nueva con una simulación: es la forma más barata de ver qué enviaría Blendin.
Pregúntanos lo que quieras.
¿Qué puede hacer la API de Blendin?
Publicar y programar en Instagram (Reels, Stories, portadas, Reels de prueba, colaboradores), Facebook, Threads, LinkedIn y YouTube, subir archivos, listar tus cuentas, leer tu biblioteca y calendario, reprogramar y cancelar, iniciar una generación, y leer métricas, comentarios y kits de marca según el permiso. A TikTok se llega con una publicación importada y el consentimiento de cada publicación.
¿Cómo consigo una clave de API?
Créala desde la pestaña de claves de API en Developers, dentro de la app, con la sesión del titular. La clave se muestra una sola vez y solo se guarda su hash. Las claves empiezan con bln_live_, tienen permisos acotados y se pueden revocar en cualquier momento.
¿Qué planes incluyen claves de API?
Free no tiene ninguna. Creator tiene 2, Pro 5 y Business 10. MCP con OAuth no necesita clave y funciona en todos los planes.
¿Qué es una simulación?
Una solicitud con dry_run en true. Blendin revisa la cuenta y arma lo que enviaría, y se detiene. No se publica nada. Hazla primero en cada integración nueva.
¿Puedo programar publicaciones por la API?
Sí. Envía scheduled_at como una hora ISO 8601 con zona, entre un minuto y un año por delante. El trabajo queda guardado como programado y se ejecuta unos cinco minutos después de su hora, como máximo. Puedes cancelarlo mientras siga programado.
¿Cómo evito publicar dos veces?
Envía una idempotency_key, o un encabezado Idempotency-Key de hasta 128 caracteres. Un reintento con la misma clave devuelve el mismo trabajo y nunca crea una segunda publicación.
¿Cuáles son los límites de uso?
120 solicitudes por minuto por cuenta, compartidas entre todas las claves y todas las conexiones MCP de esa cuenta. Pasado ese límite, la API responde 429 con un encabezado Retry-After.
¿Qué eventos de webhook existen?
post.scheduled, post.published, post.failed, draft.created, brand_kit.updated, webhook.test, generation.completed, generation.failed, lead.captured, dm.received, comment.received, account.needs_reconnect y post.deleted. Creator recibe post.published, post.failed y webhook.test.
¿Cómo se firman los webhooks?
Con HMAC-SHA256. Cada entrega lleva un encabezado Blendin-Signature con una marca de tiempo y una firma calculada sobre la marca de tiempo y el cuerpo sin procesar con el secreto de tu endpoint, que se muestra una sola vez. Las entregas fallidas se reintentan después de 1 minuto, 5 minutos, 30 minutos y 2 horas, y un endpoint que falla 10 entregas seguidas se desactiva.
¿Puedo generar contenido por la API?
Sí, para carruseles, imágenes, publicaciones de texto e hilos, con el permiso generate. Ejecuta la ruta de generación de la propia app como titular de la clave, así que los límites del plan y lo que incluye tu plan se aplican igual que en la app, y si no alcanza responde 402 antes de crear nada.
Haz tu primera llamada.
Creator y los planes superiores incluyen claves de API (2, 5, 10). En Free, conecta un asistente por MCP.
