Pular para o conteúdo principal
DevelopersDisponível

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.

Uma simulação: um POST para /api/v1/publish com dry_run definido como true responde 202 com um job para consultar. Nada é publicado.

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.

app.blendin.ai/api/v1

1. Liste as suas contas

Escopo accounts:read, parte da chave padrão.

Solicitação
curl https://app.blendin.ai/api/v1/accounts \
  -H "Authorization: Bearer bln_live_YOUR_KEY"
Resposta
{ "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.

Solicitação
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"
  }'
Resposta, 202
{ "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.

Solicitação
curl https://app.blendin.ai/api/v1/publish/<id> \
  -H "Authorization: Bearer bln_live_YOUR_KEY"
Resposta
{ "job": {
  "id": "uuid",
  "status": "container_ready",
  "platform": "instagram",
  "account_id": "uuid",
  "dry_run": true,
  "error": null,
  "created_at": "...",
  "finished_at": "..."
} }
Formatos tirados da referência da API pública. Troque YOUR_KEY por uma chave de Developers no aplicativo.

Chaves que pedem só o que precisam.

Como funcionam as chaves de API do Blendin
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.
Permissões da API e o que cada uma libera
Padrão: publish, accounts:readPublicar e agendar, envios, cancelar e listar as suas contas conectadas. Uma chave sem escopos recebe exatamente estas duas.
library:read e library:writeListar posts, ler um, ver o calendário, editar uma legenda ou um primeiro comentário.
analytics:readInteraçã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:writeLer 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:writeLer 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:writeLer kits de marca e editar campos de estilo. Uma cor que a marca não tem é null.
generateIniciar uma geração e consultar. Usa a cota do seu plano.
lead_flows, link_in_bio, webhooksCada um tem a própria permissão de leitura e de escrita.
Chaves de API e endpoints de webhook por plano
 FreeCreatorProBusiness
Chaves de API criadas por você02510
Endpoints de webhook01520
Eventos de webhookNenhumpost.published, post.failed, webhook.testTodos os eventosTodos os eventos

O que cada rota faz.

Rotas da API do Blendin, uma por linha
POST /api/v1/publishPublicar 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/uploadsReceber 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/accountsAs suas contas conectadas e se cada uma pode publicar ou precisa ser reconectada. Escopo accounts:read.
GET /api/v1/meO 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/postsA 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>/publishPublicar ou agendar um post existente no LinkedIn, Instagram, Facebook, Threads ou TikTok, com uma simulação antes.
POST /api/v1/posts/<id>/rescheduleMover um post agendado. As contas dele continuam as mesmas.
GET /api/v1/scheduledPosts agendados e jobs de vídeo da API em um intervalo de datas.
POST /api/v1/uploads/importDê ao Blendin uma URL pública e ele baixa o vídeo ou a imagem para você.
POST /api/v1/media/publishPublicar 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.

Ferramentas de automação

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.

Uma tela de celular com ícones de aplicativos: o Blendin no meio, ligado por linhas aos logos do Zapier, do Make e do n8n. Eles se conectam pelos webhooks e pela API pública do Blendin.

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.