Comparando os endpoints de contagem de Posts da X API
O endpoint de contagem de Posts da v2 eventualmente substituirá o endpoint de contagem da Enterprise Search API. Se você tem código, Apps ou ferramentas que usam uma versão mais antiga de um endpoint de contagem de Posts e está considerando migrar para os endpoints mais recentes da X API v2, este guia é para você. Esta página contém duas tabelas de comparação:- Contagem de Posts recentes
- Contagem de Posts do arquivo completo
- Comparação de operadores de filtragem
Comparação das contagens de Posts recentes
A versão Enterprise dos endpoints de contagem de Posts permite obter contagens para 30 dias ou do arquivo completo. Portanto, o endpoint de contagem de Posts recentes da v2, que considera um período de 7 dias, não substitui diretamente nenhum dos endpoints mencionados. No entanto, para facilitar as comparações, veremos como o endpoint de contagem de Posts recentes da v2 se compara ao endpoint Enterprise de 30 dias. A tabela a seguir compara os vários tipos de endpoints de contagem de Posts recentes:| Descrição | Enterprise | X API v2 |
|---|---|---|
| Domínio do host | https://gnip-api.x.com | https://api.x.com |
| Caminho do endpoint | /search/30day/accounts/:account_name/:label/counts.json | /2/tweets/counts/recent |
| Authentication | Autenticação básica | OAuth 2.0 Bearer Token |
| Formato de timestamp | YYYYMMDDhhmm | YYYY-MM-DDTHH:mm:ssZ ISO 8601 / RFC 3339 |
| Retorna contagens de Posts com no máximo | 31 dias | 7 dias |
| Métodos HTTP compatíveis | GET | GET |
| Limites de taxa de requisição padrão | 20 requisições por 1 s, agregadas entre dados de busca e requisições de contagem O limite por minuto varia conforme o parceiro, conforme especificado em seu contrato. | 180 requisições por 15 min por usuário 450 requisições por 15 min por App |
| Suporta filtragem usando annotations | ✔ | |
| Suporta filtragem usando 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 toDate | start_time end_time |
| Parâmetros de requisição para navegar por ID do Post | since_id until_id | |
| Requer o uso de credenciais de um developer App associado a um project | ✔ |
Comparação de contagens de Posts no arquivo completo
A tabela a seguir compara os diferentes tipos de endpoints de busca no arquivo completo:| Descrição | Enterprise | X API v2 |
|---|---|---|
| Domínio do host | https://gnip-api.x.com | https://api.x.com |
| Caminho do endpoint | /search/fullarchive/accounts/:account_name/:label/counts | /2/tweets/counts/all |
| Authentication | Basic auth | OAuth 2.0 Bearer Token |
| Formato de timestamp | YYYYMMDDHHMM | YYYY-MM-DDTHH:mm:ssZ ISO 8601 / RFC 3339 |
| Retorna contagens de Posts que não são mais antigos que | Arquivo completo desde março de 2006 | Arquivo completo desde março de 2006 |
| Métodos HTTP compatíveis | GET POST | GET |
| Limites de taxa de requisições padrão | O limite de taxa por minuto varia por parceiro, conforme especificado no seu contrato. 20 requisições por seg | 300 requisições por 15 min por App 1 requisição por 1 seg por App |
| Granularidade | Dia, hora, minuto | Dia, hora, minuto |
| Suporta filtragem usando annotations | ✔ | |
| Suporta filtragem usando conversation_id | ✔ | |
| Nome da chave JSON para o array de dados de Posts | results | data |
| Parâmetros de solicitação para seleção do período de tempo | fromDate toDate | start_time end_time |
| Parâmetros de solicitação para navegação por ID do Post | since_id until_id | |
| Nome da chave JSON para paginação | next | meta.next_token |
| Parâmetro de solicitação para paginação | next_token | next_token ou pagination_token |
| Fuso horário | UTC | UTC |
| Requer o uso de credenciais de um developer App associado a um Project que tenha Academic Research access | ✔ |
Comparação de operadores de filtragem
As duas versões diferentes (Enterprise e v2) de contagem de Posts diferem quanto aos operadores disponíveis e também têm níveis variados de disponibilidade de operadores em cada versão, conforme explicado abaixo. Enterprise- Não há subníveis de operadores Enterprise. Todos os operadores Enterprise estão disponíveis para todos os usuários Enterprise.
- Core: Esses operadores estão disponíveis para qualquer usuário v2.
- Advanced: Esses operadores estão disponíveis apenas para usuários aprovados para acesso Academic Research.
| 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 - Only available with 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 |