> ## 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 de Post counts da v2 acabará por substituir o endpoint de counts da enterprise Search API. Referência para o tier standard da X API v2 sobre migrate.

## Comparando os endpoints de Post counts da X API

O endpoint de Post counts da v2 acabará por substituir o [endpoint de counts da enterprise Search API](/x-api/enterprise-gnip-2.0/fundamentals/search-api#counts-requests-post-count). Se você tem código, apps ou ferramentas que usam uma versão mais antiga de um endpoint de Post counts e está considerando migrar para os endpoints mais recentes da X API v2, este guia é para você.

## Comparação de Post counts recentes

A versão enterprise dos endpoints de Post counts permite obter contagens para 30 dias ou para o arquivo completo. Portanto, o endpoint de recent Post counts da v2, que analisa um período de 7 dias, não é uma substituição direta para nenhum dos endpoints mencionados.

No entanto, para ajudar nas comparações, veremos como o endpoint de recent Post counts da v2 se compara ao endpoint enterprise de 30 dias.

A tabela a seguir compara os diversos tipos de endpoints de recent Post counts:

| **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/30day/accounts/:account\_name/:label/counts.json                                                                                                                  | /2/tweets/counts/recent                                                                            |
| [Autenticação](/resources/fundamentals/authentication)                                                                                                            | Basic authentication                                                                                                                                                      | OAuth 2.0 Bearer Token                                                                             |
| Formato de timestamp                                                                                                                                              | YYYYMMDDhhmm                                                                                                                                                              | YYYY-MM-DDTHH:mm:ssZ  <br />[ISO 8601 / RFC 3339](https://tools.ietf.org/html/rfc3339#section-5.6) |
| Retorna contagens de Posts com no máximo                                                                                                                          | 31 dias                                                                                                                                                                   | 7 dias                                                                                             |
| Métodos HTTP suportados                                                                                                                                           | GET                                                                                                                                                                       | GET                                                                                                |
| Rate limits padrão de requisição                                                                                                                                  | 20 requisições por 1 seg, agregadas entre requisições de dados de busca e counts  <br />O rate limit por minuto varia por parceiro conforme especificado no seu contrato. | 180 requisições por 15 min por usuário  <br />450 requisições por 15 min por App                   |
| Suporta filtragem usando [annotations](/x-api/fundamentals/post-annotations)                                                                                      |                                                                                                                                                                           | ✔                                                                                                  |
| Suporta filtragem usando [conversation\_id](/x-api/fundamentals/conversation-id)                                                                                  |                                                                                                                                                                           | ✔                                                                                                  |
| Nome da chave JSON para o array de dados de Post                                                                                                                  | results                                                                                                                                                                   | data                                                                                               |
| Granularidade de tempo                                                                                                                                            | Dia, hora ou minuto                                                                                                                                                       | Dia, hora ou minuto                                                                                |
| Fuso horário                                                                                                                                                      | UTC                                                                                                                                                                       | UTC                                                                                                |
| Parâmetros de requisição para selecionar o período de tempo                                                                                                       | fromDate  <br />toDate                                                                                                                                                    | start\_time  <br />end\_time                                                                       |
| Parâmetros de requisição para navegar por ID de Post                                                                                                              |                                                                                                                                                                           | since\_id  <br />until\_id                                                                         |
| 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 Post counts full-archive

A tabela a seguir compara os diversos tipos de endpoints de busca full-archive:

| 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/counts                                                       | /2/tweets/counts/all                                                                               |
| [Autenticação](/resources/fundamentals/authentication)                                                                                                                                                                                     | Basic auth                                                                                                      | OAuth 2.0 Bearer Token                                                                             |
| Formato de timestamp                                                                                                                                                                                                                       | YYYYMMDDHHMM                                                                                                    | YYYY-MM-DDTHH:mm:ssZ  <br />[ISO 8601 / RFC 3339](https://tools.ietf.org/html/rfc3339#section-5.6) |
| Retorna Post counts 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  <br />POST                                                                                                 | GET                                                                                                |
| Rate limits padrão de requisição                                                                                                                                                                                                           | O rate limit por minuto varia por parceiro conforme especificado no seu contrato.  <br />20 requisições por seg | 300 requisições por 15 min por App  <br />1 requisição por 1 seg por App                           |
| Granularidade                                                                                                                                                                                                                              | Dia, hora, minuto                                                                                               | Dia, hora, minuto                                                                                  |
| Suporta filtragem usando [annotations](/x-api/fundamentals/post-annotations)                                                                                                                                                               |                                                                                                                 | ✔                                                                                                  |
| Suporta filtragem usando [conversation\_id](/x-api/fundamentals/conversation-id)                                                                                                                                                           |                                                                                                                 | ✔                                                                                                  |
| Nome da chave JSON para o array de dados de Post                                                                                                                                                                                           | results                                                                                                         | data                                                                                               |
| Parâmetros de requisição para selecionar o período de tempo                                                                                                                                                                                | fromDate  <br />toDate                                                                                          | start\_time  <br />end\_time                                                                       |
| Parâmetros de requisição para navegar por ID de Post                                                                                                                                                                                       |                                                                                                                 | since\_id  <br />until\_id                                                                         |
| Nome da chave JSON para paginação                                                                                                                                                                                                          | next                                                                                                            | meta.next\_token                                                                                   |
| Parâmetro de requisição para paginação                                                                                                                                                                                                     | next\_token                                                                                                     | next\_token ou pagination\_token                                                                   |
| Fuso horário                                                                                                                                                                                                                               | UTC                                                                                                             | UTC                                                                                                |
| 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](/x-api/getting-started/about-x-api) |                                                                                                                 | ✔                                                                                                  |

### Comparação de operadores de filtragem

As duas versões diferentes (enterprise e v2) de Post counts 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. Todos os operadores enterprise estão disponíveis para todos os usuários enterprise.

X API v2

* **Core:** Estes operadores estão disponíveis para qualquer usuário v2.
* **Advanced:** Estes operadores estão disponíveis apenas para usuários aprovados para acesso Academic Research.

Você pode aprender mais sobre cada um destes conjuntos de operadores em seus respectivos guias:

* [Operadores Enterprise](/x-api/enterprise-gnip-2.0/fundamentals/search-api#building-search-queries)
* [Operadores da X API v2](/x-api/posts/search/integrate/build-a-query)

Agora que entendemos esses diferentes níveis de operadores dentro da X API v2, aqui está a tabela que mapeia a disponibilidade de operadores para Post counts (observe que, se a célula estiver em branco, o operador não está disponível):

|                   | Enterprise | v2                                         |
| :---------------- | :--------- | :----------------------------------------- |
| keyword           | Available  | Core                                       |
| emoji             | Available  | Core                                       |
| “exact phrase”    | Available  | Core                                       |
| #                 | Available  | Core                                       |
| \$                | Available  | Advanced                                   |
| @                 | Available  | Core                                       |
| from:             | Available  | Core                                       |
| to:               | Available  | Core                                       |
| url:              | Available  | Core                                       |
| retweets\_of:     | Available  | Core                                       |
| context:          |            | Core                                       |
| entity:           |            | Core - Disponível apenas com recent search |
| conversation\_id: |            | Core                                       |
| place:            | Available  | Advanced                                   |
| place\_country:   | Available  | Advanced                                   |
| point\_radius:    | Available  | Advanced                                   |
| bounding\_box:    | Available  | Advanced                                   |
| is:retweet        | Available  | Core                                       |
| is:reply          | Available  | Core                                       |
| is:quote          | Available  | Core                                       |
| is:verified       | Available  | Core                                       |
| -is:nullcast      | Available  | Advanced                                   |
| has:hashtags      | Available  | Core                                       |
| has:cashtags      | Available  | Advanced                                   |
| has:links         | Available  | Core                                       |
| has:mentions      | Available  | Core                                       |
| has:media         | Available  | Core                                       |
| has:images        | Available  | Core                                       |
| has:videos        | Available  | Core                                       |
| has:geo           | Available  | Advanced                                   |
| lang:             | Available  | Core                                       |
| list:             |            | Advanced                                   |
| has:profile\_geo  | Available  |                                            |
| profile\_country  | Available  |                                            |
| profile\_locality | Available  |                                            |
| profile\_region   | Available  |                                            |
| proximity         | 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")

[Post counts: Enterprise para X API v2](/x-api/posts/counts/migrate/overview)
