Publique tweets do seu backend com uma Twitter Posting API

Um POST autenticado para /social-posts é toda a integração com a Twitter posting API: envie texto, até quatro imagens ou um vídeo para sua conta do X conectada, publique na hora ou coloque na fila com scheduledAt e um timezone IANA.

Terminal mostrando uma requisição POST para a twitter posting API do AdaptlyPost publicando um tweet com duas imagens em uma conta do X conectada

A Confiança de Criadores e Equipes

Veja como criadores, profissionais de marketing e pequenas empresas usam o AdaptlyPost para manter a consistência e economizar horas toda semana.

Sou engenheiro de software, não marketeiro. Minha parceira tem uma página no TikTok, então ajudo agendando os posts dela, preparo tudo de uma vez e deixo a IA cuidar das legendas. Agora me toma uns 20 minutos por semana.

Denys Zinych
Denys Zinych

Engenheiro de Software

Eu gerencio minha página de nail art e uma marca pessoal. Agendar ambas de um único painel mudou tudo, agora publico de forma consistente e meu engajamento subiu bastante em um mês.

Irena
Irena

Criadora de Conteúdo

Sou SWE e, sinceramente, péssimo em postar com consistência. Só organizo uma semana de atualizações para a minha marca pessoal quando tenho um tempinho livre, e a IA escreve as legendas por plataforma para eu não ter que reescrever a mesma coisa de cinco formas diferentes.

Dorian Opacki
Dorian Opacki

Engenheiro de Software

Sou engenheiro de software, não marketeiro. Minha parceira tem uma página no TikTok, então ajudo agendando os posts dela, preparo tudo de uma vez e deixo a IA cuidar das legendas. Agora me toma uns 20 minutos por semana.

Denys Zinych
Denys Zinych

Engenheiro de Software

Eu gerencio minha página de nail art e uma marca pessoal. Agendar ambas de um único painel mudou tudo, agora publico de forma consistente e meu engajamento subiu bastante em um mês.

Irena
Irena

Criadora de Conteúdo

Sou SWE e, sinceramente, péssimo em postar com consistência. Só organizo uma semana de atualizações para a minha marca pessoal quando tenho um tempinho livre, e a IA escreve as legendas por plataforma para eu não ter que reescrever a mesma coisa de cinco formas diferentes.

Dorian Opacki
Dorian Opacki

Engenheiro de Software

Sou engenheiro de software, não marketeiro. Minha parceira tem uma página no TikTok, então ajudo agendando os posts dela, preparo tudo de uma vez e deixo a IA cuidar das legendas. Agora me toma uns 20 minutos por semana.

Denys Zinych
Denys Zinych

Engenheiro de Software

Eu gerencio minha página de nail art e uma marca pessoal. Agendar ambas de um único painel mudou tudo, agora publico de forma consistente e meu engajamento subiu bastante em um mês.

Irena
Irena

Criadora de Conteúdo

Sou SWE e, sinceramente, péssimo em postar com consistência. Só organizo uma semana de atualizações para a minha marca pessoal quando tenho um tempinho livre, e a IA escreve as legendas por plataforma para eu não ter que reescrever a mesma coisa de cinco formas diferentes.

Dorian Opacki
Dorian Opacki

Engenheiro de Software

Não sou pessoa de redes sociais mas preciso publicar meu trabalho em algum lugar. O escritor IA faz um rascunho decente, eu ajusto um pouco, agendo, pronto. Passei de postar uma vez por mês para três vezes por semana.

Denys Kholin
Denys Kholin

Designer Freelancer

Conectamos nosso agente OpenClaw ao AdaptlyPost e agora nossa IA publica atualizações de produto em todos os canais automaticamente. Parece futurista mas honestamente simplesmente funciona. A integração via API foi direta.

Taras Shynkarenko
Taras Shynkarenko

Fundador de Startup

Não sou pessoa de redes sociais mas preciso publicar meu trabalho em algum lugar. O escritor IA faz um rascunho decente, eu ajusto um pouco, agendo, pronto. Passei de postar uma vez por mês para três vezes por semana.

Denys Kholin
Denys Kholin

Designer Freelancer

Conectamos nosso agente OpenClaw ao AdaptlyPost e agora nossa IA publica atualizações de produto em todos os canais automaticamente. Parece futurista mas honestamente simplesmente funciona. A integração via API foi direta.

Taras Shynkarenko
Taras Shynkarenko

Fundador de Startup

Não sou pessoa de redes sociais mas preciso publicar meu trabalho em algum lugar. O escritor IA faz um rascunho decente, eu ajusto um pouco, agendo, pronto. Passei de postar uma vez por mês para três vezes por semana.

Denys Kholin
Denys Kholin

Designer Freelancer

Conectamos nosso agente OpenClaw ao AdaptlyPost e agora nossa IA publica atualizações de produto em todos os canais automaticamente. Parece futurista mas honestamente simplesmente funciona. A integração via API foi direta.

Taras Shynkarenko
Taras Shynkarenko

Fundador de Startup

Como funciona

Passo 1

Resolva o OAuth do Twitter uma vez, no painel

Não há fluxo de OAuth na API - você conecta o X no painel e depois cria uma chave em Settings > API Tokens. Toda requisição carrega Authorization: Bearer adaptly_..., e GET /social-accounts retorna o id da conta do X conectada que você passa em twitterConnectionIds. Para setups white-label, POST /connect-links gera um link que seu próprio usuário final abre para conectar a conta do X dele.

Passo 2

Envie o tweet por POST em /social-posts

text, platforms, timezone e twitterConnectionIds são obrigatórios em toda chamada. O X não tem objeto de config na API - não existe twitterConfigs, então não há nada específico da plataforma para definir: sem enquetes, sem quote posts, sem respostas, sem primeiro comentário, sem controle de prévia de link. Uma conta do X por requisição é imposto com um 400, então publicar o mesmo tweet a partir de duas contas do X significa duas chamadas.

Passo 3

Leia o resultado do X e redispare aquela entrada

O corpo da requisição é checado de forma síncrona no momento da criação: text acima de 280 caracteres, mais de quatro imagens ou duas contas do X em uma chamada retornam um 400 imediatamente e nenhum registro de post é gravado. GET /social-posts/:id/results reporta o que aconteceu depois de aceitarmos e despacharmos o tweet - a entrada do X com status, publishedAt e platformPostId, o id nativo do tweet, nunca um permalink. Quando o próprio X recusa o post - texto duplicado, uma conexão cujo token foi revogado, um vídeo que ele rejeita durante seu próprio processamento -, o motivo chega em errorMessage, e POST /social-posts/:id/retry redispara apenas aquele platformId. Todo endpoint de webhook registrado recebe os quatro eventos - post.published, post.failed, post.partially_failed e post.scheduled - sem nenhuma assinatura por evento para escolher.

Preços simples e transparentes

Escolha o plano perfeito para você

Creator

Perfeito para indivíduos e empreendedores

$19

/mês

  • 30 contas sociais conectadas

  • Posts agendados ilimitados

  • 1 membro de equipe

  • 3 espaços de trabalho

  • 150 créditos/mês

  • Legendas IA

  • Estúdio de imagens IA

  • Acesso à API e integração OpenClaw

  • Posts de imagem, vídeo e carrossel

Mais popular

Pro

Para profissionais e equipes em crescimento

$39

/mês

  • 60 contas sociais conectadas

  • Posts agendados ilimitados

  • 5 membros de equipe

  • 15 espaços de trabalho

  • 400 créditos/mês

  • Legendas IA

  • Estúdio de imagens IA

  • Acesso à API e integração OpenClaw

  • Posts de imagem, vídeo e carrossel

Enterprise

Para agências e empresas prontas para escalar

$89

/mês

  • 100 contas sociais conectadas

  • Posts agendados ilimitados

  • 20 membros de equipe

  • 50 espaços de trabalho

  • 1000 créditos/mês

  • Legendas IA

  • Estúdio de imagens IA

  • Acesso à API e integração OpenClaw

  • Posts de imagem, vídeo e carrossel

Todos os planos incluem teste gratuito de 7 dias

Quer ver a comparação completa de recursos? Ver página de preços

O que você pode publicar no Twitter pela API

Tweets de texto, checados em 280 caracteres

O payload completo é text, platforms com TWITTER, um timezone IANA e twitterConnectionIds. Qualquer coisa acima de 280 caracteres volta como um 400 antes de a chamada chegar ao X - sem truncamento silencioso e sem divisão automática, porque cadeias de respostas não são suportadas em lugar nenhum da API. Uma chamada é um tweet.

Até quatro imagens por tweet

Anexe de uma a quatro URLs de imagem. Quatro é o teto rígido do X, e um tweet com várias imagens é exatamente isso - várias imagens em um post, não uma unidade de carrossel nativa do X. POST /upload-urls aceita apenas image/jpeg, image/png e image/webp, então arquivos GIF, HEIC e AVIF não podem passar por ele.

Um vídeo, de até 140 segundos

MP4 ou MOV, no máximo 512 MB, um vídeo por tweet. O próprio X não aceita vídeo misturado com imagens, então mantenha os dois separados. Diferente do TikTok, o X aceita mediaUrls no seu próprio host HTTPS, então você pode pular a etapa de upload por completo - ou enviar arquivos por POST /upload-urls para links pré-assinados que expiram em uma hora.

Publique agora, agende, rascunhe ou enfileire em massa

Envie scheduledAt com o timezone para colocar um tweet na fila, ou use saveAsDraft e dispare POST /social-posts/:id/publish depois. POST /social-posts/bulk aceita de 1 a 100 tweets em uma única requisição, todos compartilhando a mesma conexão do X, com scheduledAt obrigatório em cada item. PATCH /social-posts/:id edita qualquer coisa ainda não publicada.

Publique seu primeiro tweet a partir do código

Conecte o X no painel, crie uma chave em Settings > API Tokens e envie um POST para /social-posts. A especificação em /openapi.json não exige autenticação e importa direto no Make, no n8n ou no seu próprio gerador de clientes.