Para se inscrever para receber atualizações, “Ative as notificações” para @API.Documentation Index
Fetch the complete documentation index at: https://x-preview-mintlify-aed10b63.mintlify.app/llms.txt
Use this file to discover all available pages before exploring further.
Endpoints de pesquisa migrando para o novo índice de pesquisa
Hoje, migramos os endpoints de pesquisa da X API v2 (/2/tweets/search/recent, /2/tweets/search/all, /2/tweets/counts/recent, /2/tweets/counts/all) para o novo índice de pesquisa da plataforma principal do X. Isso traz grandes melhorias de desempenho, uma redução drástica de erros 503 e três novos operadores de precisão: min\_likes:, min\_replies: e min\_reposts:. Observação: os reposts não são mais retornados nos resultados de pesquisa baseados em palavras-chave (o Filtered Stream permanece inalterado). Saiba mais aqui.Atualização de preços da X API: “Owned Reads” agora a $0.001
A partir de 20 de abril de 2026, introduzimos os novos preços de “Owned Reads” a **1) para endpoints elegíveis ao acessar seus próprios dados:GET /2/users/{id}/bookmarks, /blocking, /muting, /pinned_lists, /tweets, /mentions, /liked_tweets, /followers, /following, /owned_lists, /followed_lists e /list_memberships. Também atualizamos as escritas — POST /2/tweets agora custa 0.20 por Post (respostas invocadas continuam a $0.01). As ações de seguir, curtir e citar Posts via API foram removidas de todos os níveis self-serve. Saiba mais aqui.Descontinuação do endpoint Account Activity Replay
Hoje, anunciamos a descontinuação dePOST /2/account_activity/replay/webhooks/{webhook_id}/subscriptions/all, com efeito a partir de 25 de março de 2026 às 12:00 ET. Use o novo endpoint consolidado POST /2/webhooks/replay em vez disso — ele oferece funcionalidade idêntica. Saiba mais aqui.Filtro de direção para assinaturas da X Activity API
Hoje, adicionamos um filtrodirection opcional às assinaturas da X Activity API. Os assinantes agora podem restringir eventos de DM e chat a sent, received ou ambos, reduzindo o ruído quando somente eventos enviados ou recebidos são necessários.Atualizações no formato de tipos de evento na X Activity API
Hoje, anunciamos mudanças na nomenclatura dos tipos de evento na X Activity API, com efeito a partir de 18 de março de 2026. Os tipos de evento em PascalCase (por exemplo,ProfileBioUpdate) estão sendo descontinuados em favor de um formato em minúsculas separado por pontos (por exemplo, profile.update.bio). Atualize qualquer filtragem, instruções switch ou lógica de desserialização que dependa dos valores antigos. Saiba mais aqui.Eventos legados de Direct Message na X Activity API
Hoje, adicionamos eventos legados de DM (dm.received, dm.sent, dm.read, dm.indicate_typing) à X Activity API. Isso transfere a entrega de eventos de DM da Account Activity API para a pipeline de menor latência da XAA.Combate ao spam gerado por LLM
Hoje, fizemos alterações para reduzir respostas automatizadas e de baixa qualidade no X. As respostas programáticas viaPOST /2/tweets agora só são permitidas quando o autor do Post original “invocou” o respondedor (mencionando essa conta com @ ou citando um de seus Posts). Restrições adicionais se aplicam à menção com @ ou à citação programática de usuários. Essas alterações afetam apenas os níveis self-serve — o acesso Enterprise não é impactado. Saiba mais aqui.Lançamento dos preços Pay-Per-Use da X API
Hoje, lançamos oficialmente os preços Pay-Per-Use da X API — um modelo flexível baseado em créditos, criado para desenvolvedores indie, startups e entusiastas. Destaques:- Um novo Developer Console em console.x.com
- O XDK (X Developer Kit) com SDKs próprios de Python e TypeScript
- Um Playground interativo para testes
- Um servidor MCP para modelos de IA
- Ganhe até 20% de volta em créditos da API da xAI/Grok a cada dólar gasto na X API
Eventos de Spaces na X Activity API
Hoje, adicionamos eventos do ciclo de vida do Spaces (spaces.start, spaces.end) à X Activity API. Assine por ID de usuário para ser notificado em tempo real quando um Space começa ou termina.Descontinuação de operadores baseados em contagem
Hoje, descontinuamos os operadoresmin\_likes, min\_replies e min\_reposts em /2/tweets/search/recent e /2/tweets/search/all. Essa alteração não afeta os operadores equivalentes no Filtered Stream. Estamos avaliando a melhor forma de reativá-los no futuro. Saiba mais aqui.Suporte a OAuth 2.0 adicionado à Account Activity API v2
Hoje, adicionamos suporte completo a OAuth 2.0 à Account Activity API v2. Os desenvolvedores agora podem criar assinaturas usando OAuth 2.0 com escopos granulares (por exemplo,follow.read) em vez do modelo tudo-ou-nada de permissões do OAuth 1.0a. As integrações existentes baseadas em OAuth 1.0a continuam funcionando sem interrupção — quando presentes, as permissões de OAuth 1.0a substituem totalmente os escopos do OAuth 2.0. Saiba mais aqui.Apresentando o X API Playground
Hoje, apresentamos o X API Playground — um servidor local auto-hospedado que emula os endpoints da X API v2. Desenvolva e teste integrações sem fazer chamadas reais à API nem atingir limites de taxa. Inclui dados simulados realistas, persistência de estado, validação por OpenAPI, simulação de limites de taxa e uma interface web. Instale comgo install github.com/xdevplatform/playground/cmd/playground@latest. Saiba mais aqui.Lançamento dos endpoints de News
Hoje, lançamos os novos endpoints de News na X API v2:GET /2/news/search— retorna notícias em tendência que correspondem a uma consulta de pesquisaGET /2/news/{id}— busca uma notícia específica pelo ID
news.fields para selecionar campos como name, summary, contexts, cluster\_posts\_results e last\_updated\_at\_ms. Saiba mais aqui.Lançamento dos XDKs de Python e TypeScript
Hoje, lançamos os XDKs (X Developer Kits) oficiais de Python e TypeScript para a X API v2. Os XDKs cuidam de autenticação (Bearer Token, OAuth 2.0 PKCE, OAuth 1.0a), paginação automática, streaming em tempo real com tratamento de reconexão e cobertura abrangente de todos os endpoints v2. Instale compip install xdk ou npm install @xdevplatform/xdk. Saiba mais aqui.Filtragem por palavra-chave para assinaturas da X Activity API
Hoje, adicionamos filtragem por palavra-chave às assinaturas da X Activity API. Além da filtragem por ID de usuário, os assinantes agora podem refinar ainda mais a entrega de eventos por palavra-chave — útil para eventos de News e outros tipos de evento em que o alto volume de eventos justifica filtragem adicional.Eventos de selo de verificação, selo de afiliado e atualização de @handle na X Activity API
Hoje, expandimos a X Activity API para entregar tipos adicionais de eventos relacionados a perfis:profile.update.verified— quando o status de verificação de um usuário mudaprofile.update.affiliate— quando o selo de afiliado de um usuário mudaprofile.update.screenname— quando um usuário altera seu @handle
Piloto de preços Pay-Per-Use da X API
Hoje, anunciamos um piloto fechado e limitado para um novo modelo de preços baseado em créditos e em uso. Os desenvolvedores compram créditos antecipadamente e são cobrados por solicitação — sem taxas de assinatura fixas e sem limites mensais de objetos. Tarifas iniciais do piloto: 0.01/User Read, 0.01/Content Create, 0.015/User Interaction. Saiba mais aqui.Lançamento da beta aberta da X Activity API
Hoje, lançamos a beta aberta da X Activity API — um novo conjunto de endpoints para se inscrever em eventos de atividade em tempo real no X com latência abaixo de um segundo. Assine tipos de eventos de perfil (ProfileBioUpdate, ProfilePictureUpdate, ProfileBannerUpdate, ProfileGeoUpdate, ProfileUrlUpdate), filtre por ID de usuário e receba eventos correspondentes por meio de um stream HTTP persistente (GET /2/activity/stream) ou de webhooks. As assinaturas são gerenciadas via POST /2/activity/subscriptions. Saiba mais aqui.Edição de Posts via X API
Hoje, lançamos a capacidade de editar Posts recentes de forma programática via X API. Use o endpoint existentePOST /2/posts com um novo objeto edit_options contendo previous_post_id. Requisitos: o usuário autenticado deve ter X Premium, o Post deve ser seu e ter sido criado na última hora. Consulte a documentação atualizada em Create or Edit Post. Saiba mais aqui.Connections API para gerenciar conexões ativas de streaming
Hoje, lançamos a Connections API para gerenciar conexões ativas de streaming de forma programática:GET /2/connections— lista conexões de streaming ativas e históricasDELETE /2/connections/all— encerra todas as conexões de streaming ativas do appDELETE /2/connections/{endpoint_id}— encerra conexões de um endpoint de streaming específicoDELETE /2/connections— encerra conexões específicas por UUID
Community Notes: endpoint Evaluate Note
Hoje, adicionamos o endpointPOST /2/evaluate_note à Community Notes API. Os AI Note Writers agora podem avaliar uma nota em rascunho antes do envio para receber sinais sobre sua possível utilidade, alinhamento de afirmações/opiniões e outros feedbacks do modelo.Lançamento da Filtered Stream Webhooks API
Hoje, lançamos a Filtered Stream Webhooks API, que entrega Posts públicos correspondentes de forma assíncrona a um webhook registrado, em vez de exigir uma conexão persistente. As regras são gerenciadas usando os endpoints existentes de/2/tweets/search/stream/rules, e os Posts correspondentes (incluindo o histórico de edições) são entregues como JSON ao seu webhook. Disponível para desenvolvedores Enterprise; suporta mais de 25.000 regras por projeto, com regras de até 2.048 caracteres. Saiba mais aqui.Remoção dos endpoints Like e Follow do nível Free
Para combater abuso, manipulação da plataforma e engajamento falso, removemosPOST /2/users/:id/likes e POST /2/users/:id/following do nível Free da X API, com efeito imediato. Os níveis pagos (Basic, Pro, Enterprise) não são afetados. Saiba mais aqui.Endpoint de consulta de regras do PowerStream
Hoje, adicionamos o endpointGET /2/powerstream/rules, permitindo que os clientes do PowerStream recuperem programaticamente as regras configuradas em suas instâncias do PowerStream.Transmissão de Posts da Comunidade via share_with_followers
Hoje, adicionamos um novo parâmetro booleano opcional share_with_followers em POST /2/tweets. Ao postar com um community_id e share_with_followers: true, o Post da comunidade também é transmitido para as timelines dos seguidores do usuário autenticado — correspondendo à caixa de seleção “Compartilhar também com seguidores” no x.com.Lançamento da Community Notes API
Hoje, lançamos a Community Notes API — um novo conjunto de endpoints para que AI Note Writers participem de forma programática do Community Notes:GET /2/notes/search/posts_eligible_for_notes— pesquisa Posts elegíveis para receber uma Community NoteGET /2/notes/search/notes_written— recupera notas escritas anteriormente pelo AI Note Writer autenticadoPOST /2/notes— envia uma Community Note