Seus posts, pela API.
Chaves com escopo, simulações, agendamento e webhooks assinados, para os scripts e as ferramentas que publicam por você, incluindo os fluxos que você monta no Zapier, no Make ou no n8n. Uma chave só pode fazer o que o titular concedeu, e uma simulação mostra o que sairia antes de qualquer coisa sair.
O Free não tem chaves de API criadas por você. Creator 2, Pro 5, Business 10.
A resposta curta
Três chamadas, um post seguro.
Formatos reais de solicitação e de resposta. Liste as suas contas, simule um Reel e depois consulte o job.
1. Liste as suas contas
Escopo accounts:read, parte da chave padrão.
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. Simule um Reel
Escopo publish. Uma simulação confere tudo e não 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. Consulte o job
A cada 5 a 10 segundos. Uma simulação termina em 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": "..."
} }Chaves que pedem só o que precisam.
| Como é uma chave? | bln_live_ seguido de caracteres aleatórios. Envie como Authorization: Bearer ou em um cabeçalho X-API-Key. |
|---|---|
| Como ela é guardada? | Só o sha256 dela é guardado. A chave em si é mostrada uma vez, quando você a cria. |
| Quem pode criar uma? | Só o titular do espaço de trabalho, a partir de uma sessão logada no aplicativo. Nunca com outra chave. |
| Posso revogar uma chave? | Sim, a qualquer momento. Uma chave revogada, expirada ou desconhecida responde o mesmo 401. |
| Qual é o limite de solicitações? | 120 solicitações por minuto por conta, compartilhadas por todas as chaves e todas as conexões MCP. |
| Como são os erros? | Sempre um objeto de erro com um código e uma mensagem, nunca um stack trace. |
| Padrão: publish, accounts:read | Publicar e agendar, envios, cancelar e listar as suas contas conectadas. Uma chave sem escopos recebe exatamente estas duas. |
|---|---|
| library:read e library:write | Listar posts, ler um, ver o calendário, editar uma legenda ou um primeiro comentário. |
| analytics:read | Interação por post com totais, métricas da conta e melhores posts. Um post que ainda está coletando dados devolve o status e métricas vazias, nunca um zero. |
| comments:read e comments:write | Ler comentários das contas do Instagram conectadas com o Instagram Business e publicar uma resposta pública, exatamente o texto que você enviar. |
| inbox:read e inbox:write | Ler conversas de DM e responder dentro da janela de 24 horas. Precisa da Caixa de DMs, que está em implantação. |
| brand_kits:read e brand_kits:write | Ler kits de marca e editar campos de estilo. Uma cor que a marca não tem é null. |
| generate | Iniciar uma geração e consultar. Usa a cota do seu plano. |
| lead_flows, link_in_bio, webhooks | Cada um tem a própria permissão de leitura e de escrita. |
| Free | Creator | Pro | Business | |
|---|---|---|---|---|
| Chaves de API criadas por você | 0 | 2 | 5 | 10 |
| Endpoints de webhook | 0 | 1 | 5 | 20 |
| Eventos de webhook | Nenhum | post.published, post.failed, webhook.test | Todos os eventos | Todos os eventos |
O que cada rota faz.
| POST /api/v1/publish | Publicar ou agendar um vídeo no Instagram, LinkedIn, Facebook, Threads ou YouTube. Aceita simulações, scheduled_at, chaves de idempotência, capas de Reels, reels de teste e colaboradores. Escopo publish. |
|---|---|
| GET /api/v1/publish/<id> | Ler um job. Cancele um agendado com DELETE no mesmo caminho. Escopo publish. |
| POST /api/v1/uploads | Receber uma URL de envio assinada para um vídeo ou uma capa de Reel, para os arquivos grandes irem direto para o armazenamento. |
| GET /api/v1/accounts | As suas contas conectadas e se cada uma pode publicar ou precisa ser reconectada. Escopo accounts:read. |
| GET /api/v1/me | O seu plano, a cota do plano que resta para geração, as contas conectadas, os kits de marca e os escopos da chave. |
| GET /api/v1/posts | A biblioteca, os mais novos primeiro, mais uma rota para ler um post e editar a legenda dele. Escopo library:read. |
| POST /api/v1/posts/<id>/publish | Publicar ou agendar um post existente no LinkedIn, Instagram, Facebook, Threads ou TikTok, com uma simulação antes. |
| POST /api/v1/posts/<id>/reschedule | Mover um post agendado. As contas dele continuam as mesmas. |
| GET /api/v1/scheduled | Posts agendados e jobs de vídeo da API em um intervalo de datas. |
| POST /api/v1/uploads/import | Dê ao Blendin uma URL pública e ele baixa o vídeo ou a imagem para você. |
| POST /api/v1/media/publish | Publicar um vídeo, uma imagem ou um carrossel por URL. Também chega ao TikTok por um post importado, com consentimento em cada post. |
Tudo o que cria conteúdo, como generate, roda a própria rota do aplicativo como o titular da chave, então os limites do plano e a cota do seu plano ficam em um lugar só. A referência completa fica em Developers, no aplicativo, com um botão Copiar como Markdown para LLM.
Webhooks assinados, com novas tentativas.
Assinados com HMAC-SHA256
Cada entrega leva um cabeçalho Blendin-Signature com um timestamp e uma assinatura sobre o timestamp e o corpo bruto, feita com o segredo do seu endpoint.
Novas tentativas programadas
Uma entrega que não responde em 10 segundos é reenviada depois de 1 minuto, 5 minutos, 30 minutos e 2 horas, sempre com o mesmo id, para você poder eliminar duplicadas.
Desativado depois de 10 falhas
Um endpoint que falha 10 entregas seguidas é marcado como inativo e para de receber até você reativá-lo.
Treze 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 e post.deleted.
Conecte às ferramentas que você usa.
Zapier, Make e n8n podem escutar um webhook do Blendin ou chamar a API com uma chave, então um post publicado ou um lead novo pode iniciar um fluxo que você montou lá. Você aponta o gatilho de webhook ou a etapa HTTP deles para o Blendin. Essa é a conexão inteira: webhooks assinados e a API pública.
- ZapierPelos webhooks e pela API.
- MakePelos webhooks e pela API.
- n8nPelos webhooks e pela API.
Os webhooks e as chaves de API começam no Creator: 1 webhook e 2 chaves. O Pro tem 5 e 5, o Business 20 e 10. O Free não tem nenhum dos dois, e o MCP com OAuth continua funcionando nele. O post.published chega ao Creator, e o lead.captured está no Pro e no Business.
Os logos são marcas registradas dos seus donos, mostrados só para identificar o produto, sem implicar endosso.
O que a API não faz
Comece toda integração nova com uma simulação: é o jeito mais barato de ver o que o Blendin enviaria.
Pergunte o que quiser.
O que a API do Blendin faz?
Publica e agenda no Instagram (Reels, Stories, capas, reels de teste, colaboradores), Facebook, Threads, LinkedIn e YouTube, envia mídia, lista as suas contas, lê a sua biblioteca e o seu calendário, reagenda e cancela, inicia uma geração e lê análises, comentários e kits de marca conforme a permissão. O TikTok é alcançado por um post importado, com consentimento em cada post.
Como consigo uma chave de API?
Crie uma na aba de chaves de API em Developers, no aplicativo, com o login do titular da conta. A chave é mostrada uma vez e só o hash dela fica guardado. As chaves começam com bln_live_, têm escopo e podem ser revogadas a qualquer momento.
Quais planos incluem chaves de API?
O Free não tem nenhuma. O Creator tem 2, o Pro 5 e o Business 10. O MCP com OAuth não precisa de chave e funciona em todos os planos.
O que é uma simulação?
Uma solicitação com dry_run definido como true. O Blendin confere a conta e monta o que enviaria, e então para. Nada é publicado. Rode primeiro em toda integração nova.
Posso agendar posts pela API?
Sim. Envie scheduled_at como um horário ISO 8601 com fuso, entre um minuto e um ano à frente. O job fica guardado como agendado e roda em até uns cinco minutos do horário. Você pode cancelar enquanto ele ainda está agendado.
Como evito postar duas vezes?
Envie um idempotency_key, ou um cabeçalho Idempotency-Key de até 128 caracteres. Uma nova tentativa com a mesma chave devolve o mesmo job e nunca cria um segundo post.
Quais são os limites de solicitações?
120 solicitações por minuto por conta, compartilhadas por todas as chaves e todas as conexões MCP dessa conta. Passando disso, a API responde 429 com um cabeçalho Retry-After.
Quais eventos de webhook existem?
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 e post.deleted. O Creator recebe post.published, post.failed e webhook.test.
Como os webhooks são assinados?
Com HMAC-SHA256. Cada entrega leva um cabeçalho Blendin-Signature com um timestamp e uma assinatura calculada sobre o timestamp e o corpo bruto com o segredo do seu endpoint, que é mostrado uma vez. As entregas com falha são reenviadas depois de 1 minuto, 5 minutos, 30 minutos e 2 horas, e um endpoint que falha 10 entregas seguidas é desativado.
Posso gerar conteúdo pela API?
Sim, para carrosséis, imagens, posts de texto e sequências, com a permissão generate. Ela roda a própria rota de geração do aplicativo como o titular da chave, então os limites do plano e a cota do seu plano valem exatamente como no aplicativo, e uma cota que não cobre a geração responde 402 antes de qualquer coisa ser feita.
Faça a sua primeira chamada.
O Creator e os planos acima incluem chaves de API (2, 5, 10). No Free, conecte um assistente por MCP no lugar.
