Visão geral

Comparando os endpoints Search Posts da X API

O endpoint Search Tweets da v2 acabará por substituir o endpoint standard v1.1 search/posts e a enterprise 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
Caminho do endpoint	/1.1/search/tweets.json	/2/tweets/search/recent
Autenticação	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
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 (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.
Suporta selecionar quais fields retornam no payload		✔
Suporta solicitar e receber annotations		✔
Suporta solicitar metrics específicas dentro do objeto Post		✔
Suporta o operador e field 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 associado a um Project		✔

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://api.x.com
Caminho do endpoint	/search/fullarchive/accounts/:account_name/:label	/2/tweets/search/all
Autenticação	Basic auth	OAuth 2.0 App-Only
Formato de timestamp	YYYYMMDDHHMM	YYYY-MM-DDTHH:mm:ssZ ISO 8601 / RFC 3339
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	Formato X API v2 (determinado pelos parâmetros de requisição fields e expansions)
Suporta selecionar quais fields retornam no payload		✔
Suporta solicitar e receber annotations		✔
Suporta solicitar metrics específicas dentro do objeto Post		✔
Suporta o operador e field 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 associado a um Project 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:

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 Confira algumas amostras de código para estes endpoints Search Posts: Standard v1.1 para X API v2 Search Posts: Enterprise para X API v2

Getting Started

Products

Fundamentals

Partners & Customers

Resources

Visão geral

Comparando os endpoints Search Posts da X API

Comparação de recent search

Comparação de full-archive search

​Comparando os endpoints Search Posts da X API

​Comparação de recent search

​Comparação de full-archive search

Comparando os endpoints Search Posts da X API

Comparação de recent search

Comparação de full-archive search