> ## Documentation Index
> Fetch the complete documentation index at: https://docs.x.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Visão geral

> A versão mais recente da X API v2 é um grande marco. Por isso, dividimos esta seção de migração em algumas partições: a X API v2 agora é a X API principal.

export const Button = ({href, children}) => {
  return <div className="not-prose">
    <a href={href}>
      <button className="x-btn">
        <span>{children}</span>
        <svg width="3" height="24" viewBox="0 -9 3 24" class="h-6 rotate-0 overflow-visible"><path d="M0 0L3 3L0 6" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round"></path></svg>
      </button>
    </a>
  </div>;
};

A versão mais recente da X API v2 é um grande marco. Por isso, dividimos esta seção de migração em algumas partições:

| Novidades da X API v2                | Conheça os novos endpoints e funcionalidades que lançamos na X API v2.                                            |
| :----------------------------------- | :---------------------------------------------------------------------------------------------------------------- |
| Pronto para migrar?                  | Comece sua migração com um conjunto de guias e instruções.                                                        |
| Guia de migração de formato de dados | Aprenda a adaptar seus parsers de dados que anteriormente funcionavam com os formatos standard v1.1 e enterprise. |
| Mapa de endpoints da X API           | Veja como os endpoints standard v1.1 e enterprise mapeiam para os novos endpoints da X API v2.                    |

***

## O que é a X API v2?

A X API v2 agora é a X API principal e é onde o investimento em produto e a inovação estão concentrados. Fizemos parceria com desenvolvedores para construir a próxima geração da X API, atendendo melhor à nossa diversificada comunidade de desenvolvedores. Com base no feedback dos desenvolvedores, reconstruímos a API para atender a uma gama mais ampla de necessidades, introduzimos novos recursos e endpoints e aprimoramos a experiência do desenvolvedor.

A X API v2 agora é a X API principal e é onde o investimento em produto e a inovação estão concentrados. Nos últimos anos, fizemos parceria com desenvolvedores e reconstruímos a API para atender melhor a uma coleção mais ampla de necessidades, introduzir novos recursos e endpoints e aprimorar a experiência do desenvolvedor. Estamos comprometidos em continuar a construir uma plataforma de desenvolvedores aberta e ansiosos para ver o que você construirá com a X API v2.

## Por que migrar?

A X API v2 é construída sobre uma base moderna e mais sustentável e inclui endpoints substitutos aprimorados para os produtos standard v1.1 e enterprise, além de funcionalidades totalmente novas. Recomendamos fortemente que os clientes das APIs legadas (v1.1 e enterprise) comecem a migrar para a v2, pois pretendemos descontinuá-las eventualmente. Use a X API para ouvir e analisar a conversa pública, engajar-se com pessoas no X e inovar.

Nesta seção, discutiremos os endpoints e funcionalidades.

## Endpoints da V2

Você pode ver uma lista completa dos endpoints v2 e seus equivalentes pré-v2 através do guia a seguir:

<Button href="/x-api/migrate/x-api-endpoint-map">
  Mapa de endpoints da X API
</Button>

Embora a maioria dos endpoints na X API v2 sejam substituições, introduzimos vários novos endpoints. Aqui estão vários exemplos de novos endpoints que lançamos na v2:

* [Endpoints de Spaces](/x-api/spaces/introduction) para ajudar as pessoas a aproveitar mais o X Spaces e permitir que os desenvolvedores ajudem a moldar o futuro das conversas em áudio.
* [Hide replies](/x-api/posts/hide-replies/introduction), que permite construir ferramentas que ajudam a limitar o impacto de respostas abusivas, que distraem ou enganosas em escala.
* Novos endpoints de Lists que permitem [fixar e desafixar Lists](/x-api/lists/pinned-lists/introduction) ou consultar as Lists fixadas de alguém.
* Novos [endpoints de batch compliance](/x-api/compliance/batch-compliance/introduction) que permitem garantir que os dados de usuários e Tweets armazenados estejam em conformidade.

## Novas funcionalidades

A X API v2 também inclui novos recursos que ajudarão você a obter mais valor com a X API. Muitas das novidades foram impulsionadas pelo seu feedback e incluem certos recursos que eram reservados anteriormente para clientes enterprise.

Algumas das melhorias na API incluem:

* [Design consistente entre endpoints](/x-api/fundamentals/consistency)
* [Capacidade de especificar quais fields e objetos são retornados no payload da resposta](/x-api/fundamentals/data-dictionary/reference#how-to-use-fields-and-expansions)
* [Objetos de dados novos e mais detalhados](/x-api/fundamentals/data-dictionary)
* [Recebimento e filtragem de dados com novas informações contextuais fornecidas por annotations de Tweets](/x-api/fundamentals/post-annotations)
* [Acesso a novas métricas](/x-api/fundamentals/metrics)
* [Identificação e filtragem simples de conversas que pertencem a uma thread de resposta](/x-api/fundamentals/conversation-id)
* [Funcionalidade avançada e maior acesso a dados para pesquisadores acadêmicos](https://developer.x.com/content/developer-twitter/en/products/twitter-api/academic-research)
* [Funcionalidade de recuperação e redundância para endpoints de streaming](/x-api/fundamentals/recovery-and-redundancy)
* [Retorno fácil de contagens de Tweets que correspondem a uma consulta](/x-api/posts/counts/introduction)
* [Suporte a Edit Tweets](/x-api/fundamentals/edit-posts)
* Filtragem de spam com alta confiança
* URLs encurtadas são totalmente expandidas para filtragem e análise mais eficazes
* Objetos JSON de resposta simplificados, removendo campos descontinuados e modernizando rótulos
* Retorno de 100% dos Tweets públicos e disponíveis correspondentes em consultas de busca
* "Rules" de streaming para você fazer alterações sem interromper conexões
* Linguagem de consulta mais expressiva para busca de Tweets, contagens de Tweets e filtered stream
* Especificação OpenAPI para construir novas bibliotecas e rastrear mudanças de forma mais transparente

### Descubra objetos de resposta novos e atualizados

Os seguintes seis objetos de dados estão disponíveis com os endpoints v2:

| Objeto                                                        | Descrição                                                                                                                                                                                                  |
| :------------------------------------------------------------ | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [Tweet](/x-api/fundamentals/data-dictionary/reference#tweet)  | O objeto Tweet tem uma longa lista de campos de nível raiz, como `id`, `text` e `created_at`. Objetos Tweet também são o objeto pai de vários objetos filhos, incluindo `user`, `media`, `poll` e `place`. |
| [User](/x-api/fundamentals/data-dictionary/reference#user)    | O objeto user contém metadados da conta de usuário do X que descrevem o usuário referenciado.                                                                                                              |
| [Spaces](/x-api/fundamentals/data-dictionary/reference#space) | O objeto Space consiste em campos como                                                                                                                                                                     |