A plataforma para desenvolvedores do X agora cobra a API por solicitação, em vez de por nível de assinatura. A criação de publicações é cobrada por chamada, e o POST /2/tweets é limitado a 100 solicitações por usuário a cada 15 minutos e 10.000 por aplicativo a cada 24 horas. Se você está decidindo se vale a pena construir diretamente sobre ela, esses dois fatos definem a maior parte da sua arquitetura.
Quanto custa a API do X, de fato?
A página oficial de preços descreve um modelo de créditos, não planos nomeados. Você compra créditos, define um limite de gasto, e cada chamada é descontada do saldo.
| Operação | Preço informado |
|---|---|
| Criação de publicação | $0,015 por solicitação |
| Publicação contendo uma URL | $0,200 por solicitação |
| Publicação (invocada) | $0,010 por solicitação |
| DM e interações de usuário | $0,015 por solicitação |
| Excluir interações | $0,010 por solicitação |
| Leitura: publicações | $0,005 por recurso |
| Leitura: usuários, DMs, seguindo/seguidores | $0,010 por recurso |
| Leitura: curtidas, silenciamentos, bloqueios | $0,001 por recurso |
| Leituras próprias (seus dados) | $0,001 por recurso |
Dois detalhes importam mais do que os preços unitários. Uma publicação contendo uma URL custa mais de 13 vezes o preço de uma publicação simples, o que é um item de linha relevante se você publica links para viver. E os planos pagos por uso têm um teto de 3 milhões de leituras de publicações por ciclo mensal de faturamento, então produtos com muita leitura esbarram em um limite que nenhuma quantidade de créditos comprados remove.
Os recursos são deduplicados dentro de uma janela de 24 horas em UTC, então solicitar o mesmo recurso duas vezes no mesmo dia é cobrado uma vez.
Nota: os números aqui foram verificados em docs.x.com/x-api/getting-started/pricing em setembro de 2026. As plataformas mudam isso sem aviso.
O que não conseguimos verificar. Níveis antigos Free, Basic e Pro com limites mensais de publicações são amplamente citados pela web. Não conseguimos carregar uma página oficial que os liste: as páginas atuais de preços e introdução descrevem cobrança por uso, sem níveis nomeados, e a URL de níveis retorna 404. Não estamos reafirmando números de terceiros. Consulte o Developer Console para as taxas que se aplicam à sua conta.
O que a API do X pode publicar, e o que não pode?
O POST /2/tweets aceita text, opcionalmente media.media_ids, reply, poll, geo, reply_settings e algumas flags como made_with_ai e paid_partnership.
A mídia não faz parte dessa chamada. Você faz o upload separadamente pelos endpoints de upload em partes e passa o media_id resultante. Uma publicação aceita até 4 fotos, 1 GIF animado ou 1 vídeo.
As lacunas que vale a pena conhecer antes de se comprometer:
quote_tweet_idé exclusivo do Enterprise. A citação de publicações não está disponível no endpoint geral.- Os tetos de vídeo dependem da conta que publica, não do seu aplicativo. Contas padrão têm limite de 20 minutos e 8 GB; contas X Premium e verificadas, de 125 minutos e 16 GB. Seu carregador precisa lidar com os dois casos, porque o limite pertence ao usuário em nome de quem você está publicando.
- As enquetes são restritas. De 2 a 4 opções, duração entre 5 e 10.080 minutos.
- A referência de criação não informa um limite de caracteres. Não conseguimos verificar um a partir dessa página. Veja o post sobre o limite de caracteres do X para o que o produto realmente aplica.
Nota: os números aqui foram verificados em docs.x.com/x-api/posts/creation-of-a-post em setembro de 2026. As plataformas mudam isso sem aviso.
Qual é o modelo de autenticação, em termos simples?
Dois modos, e a publicação só funciona em um deles.
Token de portador apenas do aplicativo. Uma única credencial que representa seu aplicativo. Ela lê dados públicos. Não pode publicar, porque não há um usuário em nome de quem publicar.
OAuth 2.0 Authorization Code com PKCE, no contexto do usuário. O usuário é enviado para a caixa de diálogo de autorização do X, retorna com um código, e você o troca por um token de acesso. A publicação exige o escopo tweet.write, junto com tweet.read e users.read. Se você quiser continuar publicando depois que o token de acesso expirar, precisa solicitar offline.access no momento da autorização, o que é o que faz um token de atualização ser emitido.
Esse último ponto é o que pega as pessoas. offline.access é opcional, por autorização. Se você o omitir, todo usuário terá que reautorizar de forma interativa, o que é fatal para um agendador que publica às 3 da manhã. A documentação não informa o tempo de vida do token de acesso, então trate-o como curto e renove proativamente.
Quais são os limites de taxa para publicação?
| Endpoint | Por usuário | Por aplicativo |
|---|---|---|
POST /2/tweets | 100 a cada 15 minutos | 10.000 a cada 24 horas |
Toda resposta traz x-rate-limit-limit, x-rate-limit-remaining e x-rate-limit-reset (um timestamp Unix). Leia esses valores em vez de contar suas próprias chamadas, porque seu contador e o do X vão se desalinhar no momento em que ocorrer uma nova tentativa.
A documentação é explícita ao afirmar que limites de taxa e faturamento são questões separadas. Ficar dentro do limite de taxa não limita seu gasto, e definir um limite de gasto não impede que você receba 429s. Você precisa dos dois controles.
Nota: os números aqui foram verificados em docs.x.com/x-api/fundamentals/rate-limits em setembro de 2026. As plataformas mudam isso sem aviso.
O que realmente vai custar três semanas?
Não é a chamada de publicação. A chamada de publicação é resolvida em uma tarde.
Renovação de token. Solicitar offline.access, armazenar tokens de renovação criptografados, lidar com a rotação, e ter um caminho de reconexão para usuários cuja renovação falha. Isso é um processo em segundo plano com seus próprios modos de falha, não uma função.
Upload de mídia em partes. INIT, APPEND, FINALIZE, e depois consultar o status de processamento antes que o media_id fique utilizável em uma publicação. Vídeos falham na transcodificação, e falham depois que seu upload já retornou 200.
Tetos de vídeo por conta. 20 minutos contra 125 minutos é um desvio de comportamento com base em de quem é a conta em que você está publicando, e você não consegue saber isso apenas pelas credenciais do seu aplicativo.
Contabilidade de custos. Um preço por solicitação significa que alguém precisa atribuir o gasto aos clientes, ou você vai descobrir a sobretaxa de URL em uma fatura.
Tratamento de 429 que não é apenas esperar. A janela por usuário é de 15 minutos. Um loop de nova tentativa ingênuo transforma uma publicação limitada por taxa em um processo travado.
A versão resumida
- O preço é por créditos, pago por uso. A criação de publicação custa $0,015 por solicitação; uma publicação com URL custa $0,200.
- As leituras no plano pago por uso têm teto de 3 milhões de publicações por ciclo mensal de faturamento.
- O
POST /2/tweetspermite 100 por usuário a cada 15 minutos, 10.000 por aplicativo a cada 24 horas. - A publicação exige o contexto de usuário OAuth 2.0 PKCE com
tweet.write, além deoffline.accessse você quiser tokens de renovação. - Os uploads de mídia são separados: 4 fotos, 1 GIF ou 1 vídeo. A citação de publicações é exclusiva do Enterprise.
- Os níveis nomeados Free/Basic/Pro não puderam ser verificados em uma página oficial em setembro de 2026.
Fazer isso uma vez, em vez de uma vez por plataforma
O trabalho acima é real, e tem a cara do X. O LinkedIn exige dois aplicativos separados com escopos diferentes. O TikTok exige passar por uma auditoria da Content Posting API. O Threads usa uma sequência de contêiner e depois publicação, com um ciclo de renovação de token de 60 dias. Nada disso se transfere de uma plataforma para a outra.
O BulkPublish expõe uma única API REST em 15 plataformas: Facebook, Instagram, TikTok, YouTube, X, Bluesky, Threads, Pinterest, LinkedIn, Google Business Profile, Mastodon, Discord, Telegram, Tumblr e Snapchat. Um único modelo de autenticação, um único pipeline de mídia, um único objeto de publicação, com a renovação de token por plataforma e o polling assíncrono de status tratados por trás disso. A documentação para desenvolvedores e a referência da API REST cobrem os endpoints.