REST API
BulkPublish
REST API para agendar e publicar nas redes sociais
A mesma API que o app usa, aberta para você. Crie e agende posts, envie mídia, gerencie canais e leia análises por HTTP simples com JSON, em qualquer linguagem.
Operações de REST API
REST API pode usar 115 operações, organizadas abaixo em 19 áreas. A lista vem do próprio código com que REST API conversa, então tudo o que está nela funciona hoje.
| Área | Operações |
|---|---|
| Análises | Account-level analytics,Engagement metrics,Per-post metric history,Summary stats,Tracked-link performance,Trigger metrics sync |
| Chaves de API | API usage history,API usage stats,Create API key,Delete API key,List API keys |
| Notas do calendário | Create calendar note,Delete calendar note,List calendar notes,Update calendar note |
| Grupos de canais | Create channel set,Delete channel set,List channel sets,Update channel set |
| Canais | Check channel health,Disconnect channel,Get channel,Get platform-specific options for a channel,List channels,List platforms and their availability,Search users for @mention,Update channel settings |
| Links de conexão do cliente | Create a client connect link,List client connect links,Revoke a client connect link |
| Grupos de hashtags | Create hashtag group,Delete hashtag group,Get hashtag group,List hashtag groups,Update hashtag group |
| Caixa de entrada | Get a conversation's messages,Like, hide or delete a comment on a published post,List conversations,Reply in a conversation,Reply to a comment on a published post,Update a conversation (read, archive, snooze, assign) |
| Etiquetas | Create label,Delete label,List labels,Update label |
| Mídia | Abort multipart upload,Complete multipart upload,Delete media file,Finalize a direct upload,Get a direct upload URL,Get media file,Get media labels,Get media thumbnail,List media files,Set alt text,Set media labels,Start multipart upload (large videos, up to 1GB),Upload media (single request) |
| Notificações | Delete notifications,Get notification preferences,List notifications,Mark as read,Register a mobile push token,Unregister a mobile push token,Update preferences |
| OAuth | Exchange an authorization code or refresh token,Revoke a token |
| Organizações | Create organization,Delete organization,Get organization details,Leave an organization,List organizations,Rename organization,Switch active organization |
| Posts | Approve a pending post,Attach or detach a post's recurring schedule,Bulk actions,Create or get the post's review link,Create post,Delete post,Get next available queue slot,Get post,Get post engagement (commenters + reactors),Get post metrics,List posts,Publish as Story,Publish immediately,Reject a pending post,Retry failed platforms,Revoke the post's review link,Update post |
| Links de revisão | Create a client review link for a batch of posts,List client review links,Revoke a client review link |
| Autopostagem RSS | Add RSS feed,Delete RSS feed,List RSS feeds,Update RSS feed |
| Agendamentos recorrentes | Create schedule,Delete schedule,List recurring schedules,Update schedule |
| Modelos | Create post template,Delete post template,Get post template,List post templates,Update post template |
| Utilitários | Activity log,Add extra channel slots,Create AI credits checkout,Create X credits checkout,Generate an AI caption,Get quota usage,Preview link metadata,X (Twitter) API spend |
Para onde vão os posts
Tudo o que REST API agenda pode ir para qualquer uma destas 15 redes, para uma conta ou para todas de uma vez. Cada uma leva à sua própria página, com limites e tipos de post.
Configuração do REST API
Crie uma chave de API, envie-a como bearer token e comece pela referência interativa, onde dá para testar cada requisição no navegador antes de escrever uma linha de código.
- Crie uma conta no BulkPublish e conecte os canais em que você quer publicar.
- Abra Configurações, depois Desenvolvedor, e crie uma chave de API. Cada chave pertence a uma organização e pode ser revogada sem mexer no resto.
- Envie a chave como bearer token em toda requisição. A referência traz um exemplo pronto para cada operação.
Como as equipes usam isso
Para equipes que colocam a publicação dentro do próprio produto, de ferramentas internas ou de pipelines de dados, onde uma biblioteca seria uma dependência a mais.
- Suba um mês inteiro de posts de uma vez e deixe a fila publicar nos horários que você definiu.
- Escreva uma vez e publique em todo lugar. O mesmo post, adaptado por rede, sai em todos os canais conectados junto.
- Transforme o RSS de um blog ou podcast em posts automáticos assim que aparece algo novo.
- Puxe os números de volta. Impressões, engajamento e cliques em links voltam pelo mesmo caminho por onde os posts saíram.
Detalhes
As informações práticas sobre REST API em um só lugar, para configurar agora ou consultar depois.
| Detalhe | Valor |
|---|---|
| Autenticação | Chave de API, criada em Configurações e depois Desenvolvedor |
| Operações | 115 operações |
| Redes | 15 redes |
Abrir REST API · Ler a documentação da API
Perguntas frequentes
O que as pessoas costumam querer saber antes de conectar o REST API.
Quais partes do BulkPublish ele alcança?
115 operações, as da tabela acima. Posts, mídia, etiquetas, grupos de canais, agendamentos recorrentes, autopostagem por RSS e análises, ou seja, tudo o que o próprio app chama.
Como funciona a autenticação?
Por chave de API enviada como bearer token. Crie em Configurações e depois Desenvolvedor. Cada chave pertence a uma organização e pode ser revogada sozinha, sem incomodar as outras.
Em quais redes posso publicar?
Em todas as 15, em uma chamada só. Mande o mesmo texto para todas ou troque por rede, e cada post é conferido contra os limites da rede antes de entrar na fila, não depois de falhar.
Dá para subir imagens e vídeo?
Dá. Arquivo pequeno vai em uma requisição, ou você pega uma URL de upload direto e manda o vídeo grande para o armazenamento em partes. Os dois devolvem um id de mídia que você anexa ao post.
Dá para ler as análises de volta?
Dá. As métricas por post e os resumos por conta voltam de toda rede que publica esses números, e os cliques em links são medidos pelo próprio BulkPublish, então existem até onde a rede não informa nada.
O uso é gratuito?
É, em todos os planos, inclusive no gratuito. Não existe cobrança separada de API. O que você agenda conta no mesmo limite mensal de posts que qualquer coisa escrita no app.
Ainda com dúvidas? A Central de Ajuda explica passo a passo.
Guias e tutoriais
Tutoriais do nosso blog que usam REST API.
Outras integrações
O BulkPublish também funciona com outras 28 ferramentas. Escolha uma para ver como ela se conecta.
Comece a publicar
Crie uma conta, conecte seus canais e daqui a poucos minutos seu primeiro post já pode estar agendado. Plano gratuito, sem cartão, cancele quando quiser.