> ## 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
> O endpoint Search Tweets da v2 acabará por substituir o endpoint standard v1.1 search/posts e. Referência para o tier standard da X API v2 sobre migrate.
## Comparando os endpoints Search Posts da X API
O endpoint Search Tweets da v2 acabará por substituir o endpoint [standard v1.1 search/posts](/x-api/posts/search/introduction) e a [enterprise Search API](/x-api/enterprise-gnip-2.0/fundamentals/search-api). Se você tem código, apps ou ferramentas que usam uma versão mais antiga de um endpoint de busca da X e está considerando migrar para os endpoints mais recentes da X API v2, este guia é para você.
***
## Comparação de recent search
A tabela a seguir compara os diversos tipos de endpoints de recent search:
| **Descrição** | **Standard v1.1** | **X API v2** |
| :---------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------ | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Domínio do host | [https://api.x.com](https://api.x.com) | [https://api.x.com](https://api.x.com) |
| Caminho do endpoint | /1.1/search/tweets.json | /2/tweets/search/recent |
| [Autenticação](/resources/fundamentals/authentication) | OAuth 1.0a User Context
OAuth 2.0 App-Only | OAuth 1.0a User Context
OAuth 2.0 Authorization Code com PKCE
OAuth 2.0 App-Only |
| Formato de timestamp | YYYYMMDD | YYYY-MM-DDTHH:mm:ssZ
[ISO 8601 / RFC 3339](https://tools.ietf.org/html/rfc3339#section-5.6) |
| Retorna Posts com no máximo | 7 dias | 7 dias |
| Métodos HTTP suportados | GET | GET |
| Rate limits padrão de requisição | 180 requisições por 15 min com OAuth 1.0a User Context
450 requisições por 15 min com OAuth 2.0 App-Only | **Self-serve:**
60 requisições por 15 min com OAuth 2.0 App-Only
60 requisições por 15 min com OAuth 1.0a User Context
60 requisições por 15 min com OAuth 2.0 Authorization Code com PKCE |
| Oferece URLs totalmente expandidas | | ✔ |
| Máximo de Posts por resposta (padrão) | 100 (15) | 100 (10) |
| Formato JSON do Post | Formato Standard v1.1 | [Formato X API v2](/x-api/fundamentals/data-dictionary) (determinado pelos parâmetros de requisição fields e expansions, não compatível com versões anteriores do v1.1)
Para saber mais sobre como migrar do formato Standard v1.1 para o formato X API v2, visite nosso [guia de migração de formatos de dados](/x-api/migrate/data-format-migration). |
| Suporta selecionar quais [fields](/x-api/fundamentals/fields) retornam no payload | | ✔ |
| Suporta solicitar e receber [annotations](/x-api/fundamentals/post-annotations) | | ✔ |
| Suporta solicitar [metrics](/x-api/fundamentals/metrics) específicas dentro do objeto Post | | ✔ |
| Suporta o operador e field [conversation\_id](/x-api/fundamentals/conversation-id) | | ✔ |
| Fornece histórico de edições de Post | ✔ | ✔ |
| Nome da chave JSON para o array de dados de Post | statuses | data |
| Nome da chave JSON para paginação | search\_metadata.next\_results | meta.next\_token |
| Suporta navegar pelo arquivo por intervalo de tempo | ✔ | ✔ |
| Resolução de tempo em requisições baseadas em tempo | dia | segundo |
| Fuso horário | UTC | UTC |
| Parâmetros de requisição para navegar por tempo | until | start\_time
end\_time |
| Parâmetros de requisição para navegar por ID de Post | since\_id
max\_id | since\_id
until\_id |
| Parâmetro de requisição para paginação | Fornece query codificada em URL | next\_token |
| Requer o uso de credenciais de um [App de desenvolvedor](/resources/fundamentals/developer-apps) associado a um [Project](/resources/fundamentals/developer-apps) | | ✔ |
### Comparação de full-archive search
A tabela a seguir compara os diversos tipos de endpoints de full-archive search:
| **Descrição** | **Enterprise** | **X API v2** |
| :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :---------------------------------------------------------------------------------------------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------- |
| Domínio do host | [https://gnip-api.x.com](https://gnip-api.x.com) | [https://api.x.com](https://api.x.com) |
| Caminho do endpoint | /search/fullarchive/accounts/:account\_name/:label | /2/tweets/search/all |
| [Autenticação](/resources/fundamentals/authentication) | Basic auth | OAuth 2.0 App-Only |
| Formato de timestamp | YYYYMMDDHHMM | YYYY-MM-DDTHH:mm:ssZ
[ISO 8601 / RFC 3339](https://tools.ietf.org/html/rfc3339#section-5.6) |
| Retorna Posts com no máximo | Todo o arquivo desde março de 2006 | Todo o arquivo desde março de 2006 |
| Métodos HTTP suportados | GET
POST | GET |
| Rate limits padrão de requisição | O rate limit por minuto varia por parceiro conforme especificado no seu contrato.
20 requisições por seg com Basic auth | 300 requisições por 15 min com OAuth 2.0 App-Only
1 requisição por 1 seg com OAuth 2.0 App-Only |
| Oferece URLs totalmente expandidas | ✔ | ✔ |
| Posts por resposta | Máximo: 500
Padrão: 100 | Máximo: 500
Padrão: 10 |
| Formato JSON do Post | Formato [Native Enriched ou Activity Streams](/x-api/enterprise-gnip-2.0/fundamentals/data-dictionary) | Formato [X API v2](/x-api/fundamentals/data-dictionary) (determinado pelos parâmetros de requisição fields e expansions) |
| Suporta selecionar quais [fields](/x-api/fundamentals/fields) retornam no payload | | ✔ |
| Suporta solicitar e receber [annotations](/x-api/fundamentals/post-annotations) | | ✔ |
| Suporta solicitar [metrics](/x-api/fundamentals/metrics) específicas dentro do objeto Post | | ✔ |
| Suporta o operador e field [conversation\_id](/x-api/fundamentals/conversation-id) | | ✔ |
| Fornece histórico de edições de Post | ✔ | ✔ |
| Nome da chave JSON para o array de dados de Post | results | data |
| Nome da chave JSON para paginação | **next** | meta.next\_token |
| Resolução de tempo em requisições baseadas em tempo | segundo | segundo |
| Fuso horário | UTC | UTC |
| Suporta navegar pelo arquivo por ID de Post | | ✔ |
| Parâmetros de requisição para navegar por tempo | fromDate
toDate | start\_time
end\_time |
| Parâmetros de requisição para navegar por ID de Post | | since\_id
until\_id |
| Parâmetro de requisição para paginação | next\_token | next\_token |
| Requer o uso de credenciais de um [App de desenvolvedor](/resources/fundamentals/developer-apps) associado a um [Project](/resources/fundamentals/developer-apps) que tenha acesso Academic Research | | ✔ |
**Comparação de operadores de filtragem**
As quatro versões diferentes (standard, enterprise e v2) do search Posts diferem em quais operadores estão disponíveis e também têm níveis variados de disponibilidade de operadores dentro de cada versão, que são explicados abaixo.
Enterprise
* Não há subníveis de operadores enterprise
X API v2
* **Self-serve:** Disponível ao usar qualquer Project
* **Enterprise:** Disponível ao usar um Project
Você pode aprender mais sobre cada um desses conjuntos de operadores em seus respectivos guias:
* [Operadores Enterprise](/x-api/enterprise-gnip-2.0/fundamentals/search-api#available-operators)
* [Operadores da X API v2](/x-api/posts/search/integrate/build-a-query#operators)
Agora que entendemos os diferentes níveis de operadores dentro da X API v2, aqui está a tabela que mapeia a disponibilidade dos operadores para search Posts (observe que, se a célula estiver em branco, o operador não está disponível):
| Operador de busca | Standard | Enterprise | v2 |
| :---------------------------------- | :----------------------------------------------- | :--------- | :----------------------------------------------- |
| keyword | Available
q:keyword | Available | Available |
| emoji | Available
q:😄 | Available | Available |
| "exact phrase" | Available | Available | Available |
| # | Available | Available | Available |
| \$ | Available | Available | Available |
| @ | Available | Available | Available |
| from: | Available | Available | Available |
| to: | Available | Available | Available |
| url: | Available | Available | Available |
| retweets\_of: | | Available | Available |
| context: | | | Available |
| entity: | | | Self-serve - Disponível apenas com recent search |
| conversation\_id: | | | Available |
| place: | | Available | Available |
| place\_country: | | Available | Available |
| point\_radius: | parâmetro geocode | Available | Available |
| bounding\_box: | | Available | Available |
| is:retweet | filter:retweets | Available | Available |
| is:reply | | Available | Available |
| is:quote | | Available | Available |
| is:verified | | Available | Available |
| -is:nullcast | | Available | Available |
| has:hashtags | | Available | Available |
| has:cashtags | | Available | Available |
| has:links | filter:links | Available | Available |
| has:mentions | | Available | Available |
| has:media | filter:media | Available | Available |
| has:images | filter:images, filter:twimg | Available | Available |
| has:videos | filter:videos
filter:native\_video | Available | Available |
| has:geo | | Available | Available |
| lang: | lang - pode ser usado como operador ou parâmetro | Available | Available |
| has:profile\_geo | | Available | |
| profile\_country | | Available | |
| profile\_locality | | Available | |
| profile\_region | | Available | |
| proximity | | Available | |
| :( | Available | | |
| :) | Available | | |
| ? | Available | | |
| filter:periscope | Available | | |
| list: | Available | | Available |
| filter:replies | Available | | |
| filter:pro\_video | Available | | |
| filter:social | Available | | |
| filter:trusted | Available | | |
| filter:follows | Available | | |
| filter:has\_engagement | Available | | |
| include:antisocial | Available | | |
| include:offensive\_user | Available | | |
| include:antisocial\_offensive\_user | Available | | |
| include:sensitive\_content | Available | | |
| source: | Available | | |
| min\_replies: | Available | | |
| min\_retweets: | Available | | |
| min\_faves: | Available | | |
| card\_name: | Available | | |
| card\_domain: | Available | | |
**Outros recursos de migração**
[Hub de migração da X API](/x-api/migrate/overview)
[Confira algumas amostras de código para estes endpoints](https://github.com/xdevplatform/Twitter-API-v2-sample-code "Confira algumas amostras de código para estes endpoints")
[Search Posts: Standard v1.1 para X API v2](/x-api/posts/search/migrate/standard-to-twitter-api-v2)
[Search Posts: Enterprise para X API v2](/x-api/posts/search/migrate/enterprise-to-twitter-api-v2)