Bluesky
BulkPublish
API do Bluesky
Publique, agende e gerencie o Bluesky a partir do seu próprio código. Uma API REST e uma chave cobrem o Bluesky e todas as outras redes que você conectar, então você escreve a integração uma vez só.
O que a API do Bluesky cobre
Tudo abaixo faz parte da API publicada e já funciona com o Bluesky.
| Recurso | Endpoint |
|---|---|
| Criar, agendar, editar e publicar posts | POST /api/posts |
| Enviar imagens e vídeos | POST /api/media |
| Encontrar o próximo horário livre da sua fila | GET /api/posts/queue-slot |
| Criar agendamentos recorrentes | POST /api/schedules |
| Publicar novos itens de um feed RSS | POST /api/rss-feeds |
| Publicar um primeiro comentário automaticamente | platformSpecific._firstComment |
| Publicar threads com várias partes | postFormat: "thread" |
| Ler as métricas de cada post | GET /api/posts/{id}/metrics |
| Ler e responder comentários de posts publicados | GET /api/posts/{id}/engagement, POST /api/posts/{id}/comments/reply |
| Ler e responder mensagens diretas | GET /api/inbox/conversations, POST /api/inbox/conversations/{id}/messages |
| Verificar se a conexão está saudável | GET /api/channels/{id}/health |
| Consultar o uso do seu plano | GET /api/quotas/usage |
Tipos de post que você pode publicar no Bluesky
Escolha o tipo com postTypeOverrides. Um tipo que o Bluesky não oferece é recusado antes de qualquer coisa entrar na fila.
| Tipo de publicação | Mídia |
|---|---|
post Post | Opcional, até 4 imagens ou vídeos |
Agende um post do Bluesky com curl
Três requisições: encontre seu canal, envie o arquivo se o post tiver um e crie o post. Troque a chave por uma de Configurações, depois Chaves de API, e o 12 pelo id do seu próprio canal.
1. Liste seus canais e anote o id da sua conta do Bluesky.
curl https://app.bulkpublish.com/api/channels \
-H "Authorization: Bearer bp_your_key_here" 2. Crie o post.
curl -X POST https://app.bulkpublish.com/api/posts \
-H "Authorization: Bearer bp_your_key_here" \
-H "Content-Type: application/json" \
-d '{
"content": "New post is up",
"channels": [{ "channelId": 12 }],
"status": "scheduled",
"scheduledAt": "2026-12-01T09:00:00Z",
"platformSpecific": {
"_firstComment": "Full write-up on the blog"
}
}' A resposta é o post criado, com seu id e status. Busque-o depois com GET /api/posts/{id} para ver como foi.
Opções do Bluesky
O Bluesky não tem opções extras. Texto, mídia e tipo de post são tudo o que uma requisição precisa.
Análises do Bluesky pela API
Estas métricas voltam para cada post do Bluesky em GET /api/posts/{id}/metrics, com registros ao longo do tempo.
- Curtidas
- Comentários
- Compartilhamentos
- Salvamentos
Comentários e mensagens
Pela API você pode ler e responder comentários de posts publicados e ler e responder mensagens diretas.
Ler comentários funciona em todos os planos. Responder comentários exige um plano pago, e a caixa de entrada faz parte do Pro e do Business. Enquanto um recurso não estiver ativado na sua conta, a API responde 403 com um código que você pode verificar.
Acesso à API em todos os planos
Todos os planos incluem chaves de API, inclusive o Free. Veja o que cada um permite.
| Plano | Chaves de API | Requisições por dia |
|---|---|---|
| Free | 1 | 30 |
| Pro | 5 | 5.000 |
| Business | 10 | 50.000 |
Construir direto no Bluesky ou usar o BulkPublish
Ir direto é uma escolha válida, principalmente se você precisa de algo que o BulkPublish não oferece. Isto é o que AT Protocol API exige de você, conferido com a documentação em outubro de 2026.
- Um post com mídia exige várias chamadas: enviar ou criar, esperar o processamento e depois publicar.
O BulkPublish cuida da conexão por você: renova os tokens, confere cada post com as regras do Bluesky antes de entrar na fila e informa no post qual destino falhou, então seu código faz uma única requisição.
Prefere pedir a um assistente?
Claude, ChatGPT e Cursor fazem o mesmo pelo servidor MCP do Bluesky, com comandos em vez de código.
Prefere um calendário a código?
A mesma conta do Bluesky pode ser agendada pelo app, com calendário de conteúdo e envio em massa.
Perguntas frequentes
Dúvidas comuns sobre a API do Bluesky.
Existe uma API do Bluesky que eu possa usar sem construir a integração sozinho?
Sim. O BulkPublish oferece o Bluesky por meio da sua API REST. Conecte sua conta do Bluesky uma vez e depois publique, agende e gerencie com uma chave. A mesma chave funciona em todas as outras redes que você conectar.
O que posso publicar no Bluesky pela API?
Os tipos de post são Post. Cada um é conferido com as regras de mídia do Bluesky antes de entrar na fila, então uma requisição que o Bluesky recusaria falha na hora, com um erro claro.
Posso agendar posts do Bluesky pela API?
Sim. Envie o status "scheduled" com um horário em scheduledAt e um timezone, ou peça antes o próximo horário livre da sua fila. Agendamentos recorrentes e feeds RSS também estão disponíveis.
Posso ler as análises do Bluesky pela API?
Sim. As métricas por post incluem Curtidas, Comentários, Compartilhamentos e Salvamentos, com registros ao longo do tempo.
Posso ler e responder comentários ou mensagens do Bluesky pela API?
Sim. Você pode ler e responder comentários de posts publicados e ler e responder mensagens diretas. Responder comentários exige um plano pago, e a caixa de entrada faz parte do Pro e do Business.
A API do Bluesky custa algo a mais?
Não. O acesso à API está em todos os planos. O Free inclui 1 chave e 30 requisições por dia, o Pro 5 chaves e 5.000 por dia, o Business 10 chaves e 50.000 por dia.
Preciso de uma conta de desenvolvedor do Bluesky ou de uma revisão de app?
Não para usar o BulkPublish. Você conecta sua conta do Bluesky na página Canais e publica com uma chave do BulkPublish. Se preferir construir direto na API do Bluesky, a seção acima lista o que ela exige de você.
Um assistente de IA também consegue fazer isso?
Sim. A página do servidor MCP do Bluesky mostra como conectar Claude, ChatGPT ou Cursor e o que pedir.
Outras redes
A mesma chave e o mesmo formato de requisição funcionam em 15 redes.
Comece a publicar no Bluesky pelo código
Crie uma conta grátis, conecte o Bluesky e gere uma chave. Sem cartão.