A API X (antiga API do Twitter) passou por mudanças drásticas desde a aquisição por Elon Musk em 2023. O que antes era uma plataforma gratuita e amigável para desenvolvedores agora é um serviço premium com faixas de preço rigorosas e níveis de acesso cuidadosamente controlados. Para desenvolvedores que constroem bots, integram dados em tempo real ou criam ferramentas de gestão de redes sociais, entender o cenário atual da API X é fundamental.
Este guia abrangente mostra tudo o que você precisa saber para obter as credenciais da API X em 2026, entender os custos reais e otimizar a implementação para eficiência.
- Como a precificação da X API evoluiu de gratuita para paga e o emergente modelo de pagamento por uso
- Resumo dos planos atuais e qual deles atende ao seu caso de uso
- Processo passo a passo para obter suas credenciais de API no Portal do Desenvolvedor
- Métodos modernos de autenticação e escopos de permissão
- Cinco estratégias de otimização comprovadas para reduzir custos e melhorar o desempenho
Vamos começar entendendo onde a API X se encaixa no seu fluxo de desenvolvimento e o que já está disponível.
A Evolução da API X: O que Mudou
A API do Twitter evoluiu dramaticamente ao longo dos anos. Aqui está a linha do tempo das mudanças mais importantes:
| Data | Evento | Impacto nos Desenvolvedores |
|---|---|---|
| Outubro de 2022 | Elon Musk adquire o Twitter | Começam as especulações sobre mudanças na API. |
| Fevereiro de 2023 | Acesso gratuito à API removido | Clientes de terceiros (Tweetbot, Echofon) foram descontinuados; a precificação passa a ser obrigatória |
| Março de 2023 | Planos pagos apresentados (US$100, US$2.500, US$42.000) | Preço de entrada salta 100x; ecossistema de desenvolvedores fragmentado |
| Junho de 2024 | O preço do plano básico dobrou para US$200/mês. | Maior barreira de entrada para desenvolvedores independentes |
| Outubro de 2024 | Rebranding oficial: Twitter → X | Documentação e branding atualizados; isso pode confundir usuários antigos |
| Novembro de 2025 | Lançamento beta de preços por uso | Novo modelo baseado no consumo com vouchers de desenvolvedor no valor de $500 para testes |
O acesso gratuito evoluiu para US$ 200 a US$ 5.000/mês em quatro anos. Antes de planejar a implementação, entenda o que a API realmente oferece e qual plano atende às suas necessidades.
O que você pode construir com a X API?
A API da X oferece acesso programático à infraestrutura da X — desde recuperar dados até publicar conteúdo e automatizar respostas. Abaixo, as aplicações mais comuns:
Monitoramento de Marca e Inteligência Social
Monitore menções, a atividade dos concorrentes e conversas em alta em tempo real. Fluxos filtrados enviam alertas instantâneos quando palavras-chave específicas ou contas geram atividade, permitindo que as equipes respondam rapidamente a eventos relevantes para a marca.
Programação de Conteúdo
Automatize os cronogramas de publicação, gerencie várias contas a partir de um painel único e coordene fluxos de trabalho de conteúdo. Agências e criadores usam essas ferramentas para gerenciar dezenas de contas X sem ciclos manuais de login e postagem.
Integração de Conteúdo do Site
Incorpore feeds ao vivo do X, tweets individuais e tópicos em alta diretamente em sites. Publicadores mantêm o conteúdo sincronizado com a atividade em tempo real do X, sem exigir atualizações manuais ou embeds desatualizados.
Data Analysis and Research
Acesse dados estruturados para estudos em grande escala, análise de tendências e pesquisa de mercado. A API oferece histórico de pesquisas, métricas de engajamento e dados de usuários em volumes que seriam impossíveis de coletar manualmente.
IA e Análise de Sentimento
Alimente modelos de aprendizado de máquina, modelos de linguagem e sistemas de análise de sentimento com dados em tempo real. As aplicações vão do monitoramento da audiência à análise de discurso e à análise preditiva.
Preço da API X: O Sistema de Níveis 2026
Até hoje, a X testa um modelo revolucionário de pagamento por uso, mas o sistema tradicional por camadas continua como padrão ativo. Veja o que você precisa saber sobre as duas abordagens.
💲 Preços Padrão Atuais
A estrutura de preços escalonada consiste em três planos principais, cada um projetado para diferentes escalas de uso:
| Nível | Custo Mensal | Economias Anuais | Melhor para | Principais Recursos |
|---|---|---|---|---|
| Gratuito | $0 | — | Apenas para desenvolvimento e teste. | 500 posts/mês, leitura intensiva, 1 requisição a cada 24h na maioria dos endpoints, acesso aos endpoints limitado. |
| Básico | $200 | $2,100/ano (12,5% de economia) | Projetos pequenos, monitoramento de conteúdo, uso de apenas um app | 15.000 solicitações de leitura/mês, 50.000 solicitações de gravação/mês, acesso ao endpoint padrão |
| Pro | $5.000 | $54.000/ano (economia de 10%) | Aplicações em crescimento, conjunto completo de recursos, sistemas críticos para o negócio | 1.000.000 de solicitações de leitura/mês, 300.000 de solicitações de gravação/mês, acesso completo ao endpoint, suporte prioritário |
| Enterprise | Mais de $42,000+ | Preços personalizados | Sistemas em larga escala, infraestrutura dedicada | Limites de taxa personalizados, SLAs, suporte dedicado, recursos avançados, descontos por volume |
Enquanto o Plano Básico é 25x mais barato ($200 vs $5.000), o Pro oferece 100x mais capacidade de leitura e desbloqueia recursos críticos, como busca em arquivo completo e filtragem em tempo real. A maioria das empresas escala diretamente de Gratuito → Básico → Pro.
💢 O que mudou: a morte do acesso gratuito
A transição do acesso gratuito para pago cumpriu dois objetivos: gerar receita a partir do valor dos dados da plataforma e reduzir abusos. O acesso à API gratuito permitia bots de spam, coletadores de dados e automação maliciosa em grande escala.
Disponível no plano Gratuito
- 500 posts por mês no calendário (aprox. 16-17 por dia)
- Limitado a 1 requisição por 24 horas na maioria dos endpoints.
- Sem postar, curtir ou interagir – apenas acesso de leitura a dados públicos
- Não é possível postar, criar recursos ou realizar ações na conta.
- Sem acesso a tendências, mensagens diretas ou recursos avançados
🔮 O Novo Modelo de Pagamento por Uso (Beta)
Em novembro de 2025, a X lançou um beta fechado para uma abordagem de precificação revolucionária: pague apenas pelo que usar. Em vez de taxas mensais fixas, os desenvolvedores no beta pagam preços individuais por diferentes operações de API – semelhante à cobrança por uso da AWS ou do Google Cloud.
Como funciona o Pay-Per-Use
O modelo de precificação beta atribui custos específicos a cada tipo de operação. Por exemplo:
- A leitura de uma postagem tem um preço específico (varia de acordo com a operação)
- A busca por postagens custa mais (maior carga computacional)
- Criar uma postagem tem sua própria tarifa.
- O acesso a tendências usa um nível de preços diferente.
- Mensagens diretas têm cobrança separada.
Todos os desenvolvedores na beta fechada recebem um voucher de US$ 500 para testar antes de usar em produção.
Vantagens potenciais em relação aos planos fixos
- Sem cobrança por capacidade não utilizada (ao contrário de preços por faixas fixas)
- Capacidade de escalar para cima ou para baixo sem mudanças de plano
- Controle granular de gastos por recurso
- Atribuição de custos mais transparente
A X oferece um calculador de custos da API interativo onde você pode inserir seus padrões de uso esperados e ver exatamente quanto você pagaria.
Autenticação X: Como Comprovar Sua Identidade
Antes de fazer qualquer requisição de API, você precisa se autenticar — comprove à X que você está autorizado a acessar dados específicos. A API X v2 oferece vários métodos de autenticação, cada um adequado a cenários diferentes.
🔐 Código de Autorização OAuth 2.0 (Recomendado para novos desenvolvimentos)
OAuth 2.0 é o padrão moderno de autenticação recomendado para todo novo desenvolvimento. É mais seguro que as abordagens legadas e lida com dados de usuários públicos e privados.
Quando usar OAuth 2.0
- Criando novas aplicações do zero
- Aplicações Web e apps móveis que exigem login de usuário
- Acessando dados de usuário privados (listas privadas, posts de rascunho)
- Executar ações em nome dos usuários (postar, curtir, seguir)
Como Funciona
- O usuário clica em “Entrar com X” na sua aplicação
- Seu app redireciona os usuários para a página de autorização do X.
- O usuário concede permissões (você define os escopos solicitados)
- X retorna um código de autorização
- Seu app troca o código por um token de acesso.
- Você usa este token para requisições de API em nome do usuário.
Credenciais obrigatórias: ID do Cliente, Segredo do Cliente e URL de Redirecionamento (configurados nas configurações do seu aplicativo de desenvolvedor).
🔑 Contexto de Usuário OAuth 1.0a (Legado, Ainda Suportado)
Este método antigo ainda é suportado, mas não é recomendável para novos desenvolvimentos. OAuth 1.0a autentica em nome de um usuário específico e é principalmente útil para aplicações legadas.
- Tweets publicados ou mensagens diretas em nome de um usuário
- Recuperando a linha do tempo privada de um usuário específico
- Gerenciando recursos personalizados do usuário
👥 Bearer Token (App-Only, Best for Public Data)
Autenticação por token Bearer é a abordagem mais simples para acessar dados públicos sem contexto de usuário. Use isto quando estiver criando ferramentas que precisam apenas de informações públicas.
Quando Usar
- Procurando publicações públicas
- Obtendo perfis públicos de usuários
- Acessando tendências disponíveis publicamente
- Criando ferramentas de análise para conteúdo público
Como funciona: Forneça as credenciais do seu app (Chave de API e Segredo), obtenha um Token Bearer e inclua o token nos cabeçalhos das requisições da API. Não é necessária a intervenção do usuário.
X API v2: Endpoints e Tipos de Recurso
A API X vem em duas versões: v1.1 (legado, não é mais atualizado) e v2 (padrão atual). Todos os novos projetos devem usar a v2, que oferece acesso a endpoints organizados por tipo de recurso – Posts, Usuários, Tendências, Engajamento e muito mais. Cada recurso suporta operações específicas (ler, criar, atualizar e excluir), dependendo do seu plano e de permissões.
Publicações (Tweets) – O Recurso Central
O que você pode fazer: Recuperar publicações, buscar publicações que correspondam aos critérios, criar novas publicações, excluir publicações, acessar linhas do tempo
Pontos finais comuns:
- GET /2/tweets — Consultar posts específicos por ID
- GET /2/tweets/search/recent — Pesquisar publicações recentes (últimos 7 dias)
- POST /2/tweets — Criar uma nova publicação
- GET /2/users/:id/tweets — Obter publicações de um usuário específico
Posts são a base da API X. Quase todos os casos de uso envolvem recuperar, pesquisar ou criar posts de alguma forma.
Usuários – Informações do Perfil
O que você pode fazer: Acessar perfis de usuários, obter informações de seguidores, pesquisar usuários
Pontos finais comuns:
- GET /2/users/by/username/:username — Obter usuário pelo nome de usuário
- GET /2/users/:id — Obter usuário por ID
- GET /2/users/:id/followers — Obter os seguidores do usuário
Endpoints de usuário permitem criar perfis, acompanhar seguidores e verificar informações de conta sem precisar acessar o X manualmente.
Engajamento – Curtidas, Retweets, Respostas
O que você pode fazer: Ver métricas de engajamento, acompanhar quem curtiu ou retweetou posts, gerenciar a interação com usuários
Pontos finais comuns:
- GET /2/tweets/:id/liked_by — Veja quem curtiu uma publicação
- POST /2/users/:id/likes — Curtir uma publicação
- GET /2/tweets/:id/quote_tweets — Obter tweets citados (retweets com comentários adicionados)
Os endpoints de engajamento alimentam painéis analíticos e ferramentas de gestão de comunidade, rastreando interações e respostas ao conteúdo.
Listas – Coleções de Usuários
O que você pode fazer: Criar e gerenciar listas curadas de usuários, acessar postagens dos membros da lista
Pontos finais comuns:
- GET /2/lists — Liste suas listas
- POST /2/lists/:id/members — Adicionar membro à lista
- GET /2/lists/:id/tweets — Obter postagens dos membros da lista
Listas são úteis para organizar contas e criar feeds segmentados sem seguir todos publicamente.
Tendências – O que está acontecendo agora
O que você pode fazer: Acesse tópicos em alta e hashtags em tempo real
Pontos finais comuns:
- GET /2/trends — Obter tópicos em alta
- GET /2/users/personalized_trends — Obtenha tópicos de tendência personalizados para um usuário
Dados de tendências alimentam recursos de descoberta e ajudam aplicações a exibir conversas relevantes que estão acontecendo agora no X.
Fluxo filtrado – Dados em tempo real
O que você pode fazer: Inscreva-se em um feed em tempo real de publicações que atendam às suas regras e receba notificações à medida que as publicações forem criadas.
Pontos finais comuns:
- GET /2/tweets/search/stream — Conecte-se ao fluxo filtrado
- POST /2/tweets/search/stream/rules — Criar ou modificar regras de stream
Fluxo filtrado é poderoso para aplicações que precisam de atualizações em tempo real (monitorar menções à marca, acompanhar palavras-chave específicas, etc.) sem consultar continuamente o endpoint de busca.
Mensagens Diretas – Comunicação Privada
O que você pode fazer: Enviar e receber mensagens diretas, gerenciar conversas
Pontos finais comuns:
- GET /2/dm_events — Recuperar mensagens diretas
- POST /2/dm_conversations/:id/messages — Enviar uma mensagem
Endpoints de mensagens diretas habilitam automação do suporte ao cliente e sistemas de notificação, construídos sobre o X.
Limites de Taxa e Gerenciamento de Quotas
A API X v2 impõe dois tipos de limites: limites de taxa de requisição (em janelas de 15 minutos) e limites mensais de consumo de posts (monitorados ao longo do mês civil).
📨 Limites de Taxa de Requisição (por janelas de 15 minutos)
Diferentes endpoints têm limites de chamadas diferentes, com base no seu nível.
| Exemplo de Endpoint | Plano Gratuito | Plano Básico | Plano Pro |
|---|---|---|---|
| GET /2/users/:id (localizar usuário) | 1 requisição / 24 horas | 100 solicitações / 24 horas | 900 requisições / 15 minutos |
| POST /2/tweets (criar publicação) | Não disponível | Disponível | Disponível |
| GET /2/tweets/search/recent | Limitado | Disponível | 450 solicitações / 15 minutos |
O plano gratuito usa limites por endpoint medidos em janelas de 24 horas (muito restritivas). Os planos Básico e Pro utilizam janelas de 15 minutos, que são muito mais generosas, pois a janela se reinicia com frequência.
📊 Limites Mensais de Consumo de Posts
Separados dos limites de taxa de requisições, os endpoints de busca e streaming consomem uma cota mensal de posts. Uma vez consumidos, você não poderá consultar esses endpoints até o próximo mês civil.
- Plano gratuito: 10.000 publicações/mês
- Plano básico: 500.000 publicações/mês
- Plano Pro: Mais de 2.000.000 posts/mês
Esses limites se aplicam especificamente a: busca recente, fluxo filtrado, timelines de usuários, e timelines de menções.
🚨 O que acontece quando você atinge o limite
Quando você excede um limite de taxa, o X retorna uma resposta de erro HTTP 429 (Too Many Requests) com um cabeçalho Retry-After indicando quantos segundos esperar antes de tentar novamente.
Quando você exceder a cota mensal de posts, o X retorna um erro 429 indicando que o limite de cotas foi atingido. Você fica bloqueado de consultar esse endpoint até o início do próximo mês civil.
Cinco estratégias de otimização: reduza custos e melhore o desempenho
Com limites de taxa e quotas mensais limitadas, a otimização impacta diretamente a capacidade e o custo da sua aplicação. Aqui estão estratégias comprovadas para reduzir o consumo de APIs.
1. Use a Seleção de Campos para reduzir o tamanho da resposta
Por padrão, as respostas da API retornam muitos campos que você pode não precisar. O parâmetro fields permite solicitar apenas dados específicos.
Em vez de:
GET /2/tweets?ids=TWEET_IDUsar:
GET /2/tweets?ids=TWEET_ID&tweet.fields=created_at,public_metrics&expansions=author_id&user.fields=usernameA segunda requisição retorna apenas os dados de que você precisa, resultando em respostas menores e processamento mais rápido.
2. Implementar cache em nível de aplicativo
Armazene em cache as respostas da API no seu banco de dados ou na camada de cache com valores TTL apropriados:
- Conteúdo estático (nomes de usuário, nomes de exibição): 24 horas
- Conteúdo semi-dinâmico (texto da postagem, contagens de engajamento): 6 horas
- Conteúdo em tempo real (tópicos em alta): 30 minutos a 1 hora
Impacto real: Um painel que antes buscava posts em alta a cada 15 minutos pode passar a buscar a cada 2 horas com cache, reduzindo as chamadas diárias de API de 96 para 12 — uma redução de 87,5%.
3. Requisições em lote sempre que possível
Alguns endpoints aceitam múltiplos IDs em uma única requisição.
Em vez de 3 solicitações separadas:
GET /2/tweets?ids=ID1 GET /2/tweets?ids=ID2 GET /2/tweets?ids=ID3Use 1 requisição em lote:
GET /2/tweets?ids=ID1,ID2,ID3Isso reduz seu consumo de 3 requisições para 1, economizando 67% da sua cota.
4. Use Lógica de Backoff e Tentativas de Repetição
Ao atingir limites de taxa ou erros temporários, tente novamente com backoff exponencial:
- Aguarde 1 segundo antes de tentar novamente 1
- Aguarde 2 segundos antes de tentar novamente
- Aguarde 4 segundos antes de tentar novamente 3
- Aguarde 8 segundos antes de tentar novamente 4
Isso evita sobrecarregar a API e dá tempo para resolver problemas temporários.
5. Considere Fluxo Filtrado em vez de Polling
Em vez de perguntar repetidamente “Existem novas postagens que correspondem aos meus critérios?” (polling), inscreva-se em webhooks para receber notificações quando publicações que atendem aos seus critérios aparecerem.
Abordagem de verificação: Verificação a cada 5 minutos = 288 verificações/dia. A maioria das verificações retorna “sem novos dados” (cota desperdiçada).
Abordagem de Fluxo Filtrado: Receba notificações apenas quando os dados mudarem. Zero solicitações desperdiçadas. Atualizações em tempo real.
Tratamento de Erros: Problemas Comuns e Soluções
Entender códigos de erro comuns ajuda você a depurar e se recuperar com tranquilidade.
| Código de Erro | Status HTTP | Propósito | Solução |
|---|---|---|---|
| Solicitação inválida | 400 | Solicitação inválida ou campos obrigatórios ausentes | Revise o formato de solicitação, garanta que todos os parâmetros obrigatórios estejam presentes |
| Não autorizado | 401 | Credenciais ausentes ou inválidas | Verifique se o Bearer Token ou os tokens OAuth estão corretos e não expiraram |
| Proibido | 403 | Autenticado, mas não autorizado (permissões insuficientes) | Solicite escopos adicionais no fluxo OAuth e obtenha a reaprovação do usuário |
| Não encontrado | 404 | Recurso não existe (ID inválido, conteúdo excluído) | Verifique se o ID do recurso está correto e ainda existe |
| Limite de taxa atingido | 429 | Muitas solicitações dentro do intervalo de tempo. | Implemente backoff, aguarde a janela de limite de taxa ser redefinida (verifique o cabeçalho Retry-After) |
| Quota excedida | 429 | Cota mensal de postagens esgotada | Aguarde até o próximo mês civil ou solicite aumento de cota |
🔧 Respostas de Erro de Análise
Quando ocorre um erro, o X retorna JSON com os detalhes:
{ "errors": [ { "message": "O valor do parâmetro de consulta `ids` é inválido", "type": "https://api.x.com/2/problems/invalid-request" } ] }Melhor prática: Sempre envolva chamadas de API em blocos try-catch e registre erros em um sistema de monitoramento. Isso ajuda a identificar padrões e depurar problemas com mais rapidez.
Obtenha sua Chave de API X: Passo a Passo
O processo ficou significativamente mais simples em comparação com a antiga API do Twitter, mas ainda há etapas críticas:
🔗 Passo 1: Crie uma Conta de Desenvolvedor
- Acesse o X Developer Portal
- Faça login com sua conta X (ou crie uma)
- Conclua a configuração completa do perfil do desenvolvedor
- Aguardando aprovação (geralmente 5–10 minutos)
Usuários de primeira viagem verão um assistente de onboarding que o guiará na criação do seu primeiro Projeto e App. Se não vir isso, clique em “Projetos & Apps” na barra lateral esquerda.
📂 Passo 2: Criar um Projeto
Um Projeto é um contêiner para um ou mais Apps. Pense nele como um espaço de trabalho.
- No Developer Portal, clique em “Criar Projeto”
- Nomeie seu projeto (ex.: “Painel de Analytics”)
- Descreva seu caso de uso
- Selecione seu nível de acesso (comece com Gratuito para testar)
Por padrão, você está no nível Gratuito. Para atualizar: vá até a seção “Produtos” no portal do desenvolvedor → localize o cartão X API v2 e clique em “Ver Níveis de Acesso” → Selecione o nível desejado.
🔨 Passo 3: Criar um App
- Dentro do seu projeto, clique em “Criar App”
- Escolha um nome para o App (por exemplo, “Brand Monitor Bot”).
- Aceitar termos
- Gere suas chaves de API
🔑 Passo 4: Acesse suas Credenciais
Vá até a guia “Chaves e Tokens” do seu app. Você encontrará:
- Chave de API (Chave de Consumidor): Um identificador público para o seu aplicativo. Seguro compartilhar no código-fonte.
- Chave Secreta da API (Segredo do Consumidor): Mantenha-a em segurança! Nunca a exponha no código do lado do cliente ou no controle de versões.
- Bearer Token (para autenticação apenas com aplicativo): Usado para autenticação apenas com aplicativo (somente leitura, sem contexto de usuário). Também mantenha-o seguro.
- ID do Cliente e Segredo (para OAuth 2.0): credenciais OAuth 2.0. Visíveis apenas se você ativar OAuth 2.0 nas configurações do seu aplicativo.
Ferramentas e Recursos Recomendados
- Documentação Oficial da API X: A fonte autorizada para todos os endpoints, parâmetros e exemplos.
- Referência de Limites de Taxa: Descritivo completo de todos os limites de taxa de endpoints por nível.
- X Postman Collection: Requisições de API prontas para testar no Postman. Elimina a criação manual de endpoints.
- Fórum da Comunidade de Desenvolvedores X: Conecte-se com outros desenvolvedores, tire dúvidas, relate problemas.
- X Dev GitHub: Código de exemplo oficial, SDKs e bibliotecas para Python, JavaScript, Java e muito mais.
- Bibliotecas de Cliente: SDKs oficiais e mantidos pela comunidade em várias linguagens. Economize tempo em relação a requisições HTTP diretas.
FAQ: Perguntas frequentes sobre a X API
Posso usar a API X gratuitamente?
Qual é a diferença entre OAuth 2.0 e tokens Bearer?
Por quanto tempo duram os tokens de acesso?
O que acontece se eu exceder meu limite de taxa?
Posso aumentar meus limites de uso ou a cota mensal de postagens?
Qual plano devo escolher para o meu projeto?
Precisa de mais ajuda? Consulte a Documentação do Desenvolvedor X ou visite o Fórum da Comunidade de Desenvolvedores X para se conectar com outros desenvolvedores e obter respostas da comunidade.
Próximos Passos
Construir com a API X é simples assim que você entende os preços, limites de taxa e estratégias de otimização. Quer você esteja monitorando conversas da marca, automatizando conteúdo ou analisando tendências, a API oferece tudo o que você precisa. Comece com um projeto pequeno, implemente as cinco estratégias de otimização logo no início e cresça a partir daí.
A diferença entre uma aplicação escalável e outra que enfrenta dificuldades costuma depender dos detalhes de implementação. Planeje com cuidado, otimize ao máximo desde o primeiro dia, e sua integração X prosperará. Pronto para começar? Acesse developer.x.com, crie seu primeiro projeto e comece a construir!
