Ir al contenido principal
DevelopersDisponible

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.

Una simulación: un POST a /api/v1/publish con dry_run en true responde 202 con un trabajo para consultar. No se publica nada.

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.

app.blendin.ai/api/v1

1. Lista tus cuentas

Alcance accounts:read, incluido en la clave predeterminada.

Solicitud
curl https://app.blendin.ai/api/v1/accounts \
  -H "Authorization: Bearer bln_live_YOUR_KEY"
Respuesta
{ "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.

Solicitud
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"
  }'
Respuesta, 202
{ "job": { ... },
  "poll": "/api/v1/publish/<id>",
  "replayed": false }

3. Consulta el trabajo

Cada 5 a 10 segundos. Una simulación termina en container_ready.

Solicitud
curl https://app.blendin.ai/api/v1/publish/<id> \
  -H "Authorization: Bearer bln_live_YOUR_KEY"
Respuesta
{ "job": {
  "id": "uuid",
  "status": "container_ready",
  "platform": "instagram",
  "account_id": "uuid",
  "dry_run": true,
  "error": null,
  "created_at": "...",
  "finished_at": "..."
} }
Estructuras tomadas de la referencia de la API pública. Reemplaza YOUR_KEY por una clave de Developers en la app.

Claves que piden solo lo que necesitan.

Cómo funcionan las claves de API de Blendin
¿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.
Los permisos de la API y lo que habilita cada uno
Por defecto: publish, accounts:readPublicar y programar, subir archivos, cancelar y listar tus cuentas conectadas. Una clave sin alcances recibe exactamente estos dos.
library:read y library:writeListar publicaciones, leer una, ver el calendario, editar un texto o un primer comentario.
analytics:readInteracció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:writeLeer 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:writeLeer 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:writeLeer kits de marca y editar campos de estilo. Un color que la marca no tiene es null.
generateIniciar una generación y consultarla. Usa lo que incluye tu plan.
lead_flows, link_in_bio, webhooksCada uno tiene su propio permiso de lectura y escritura.
Claves de API y endpoints de webhook por plan
 FreeCreatorProBusiness
Claves de API que creas tú02510
Endpoints de webhook01520
Eventos de webhookNingunopost.published, post.failed, webhook.testTodos los eventosTodos los eventos

Qué hace cada ruta.

Rutas de la API de Blendin, una por fila
POST /api/v1/publishPublica 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/uploadsObté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/accountsTus cuentas conectadas y si cada una puede publicar o necesita reconectarse. Alcance accounts:read.
GET /api/v1/meTu plan, lo que te queda para generar, las cuentas conectadas, los kits de marca y los alcances de la clave.
GET /api/v1/postsLa 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>/publishPublica o programa una publicación existente en LinkedIn, Instagram, Facebook, Threads o TikTok, con una simulación primero.
POST /api/v1/posts/<id>/rescheduleMueve una publicación programada. Sus cuentas se mantienen.
GET /api/v1/scheduledPublicaciones programadas y trabajos de video por API en un rango de fechas.
POST /api/v1/uploads/importDale a Blendin una URL pública y descarga el video o la imagen por ti.
POST /api/v1/media/publishPublica 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.

Herramientas de automatización

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.

La pantalla de un teléfono con íconos de apps: Blendin al centro, unido por líneas a los logos de Zapier, Make y n8n. Se conectan mediante los webhooks y la API pública de Blendin.

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.