Descripción general

Comparación de los endpoints de Search Posts de la X API

El endpoint v2 Search Tweets eventualmente reemplazará al endpoint estándar v1.1 search/posts y a la Enterprise Search API. Si tienes código, apps o herramientas que utilizan una versión anterior de un endpoint de search de X y estás considerando migrar a los endpoints más recientes de X API v2, esta guía es para ti.

Comparación de recent search

La siguiente tabla compara los diversos tipos de endpoints de recent search:

Description	Standard v1.1	X API v2
Host domain	https://api.x.com	https://api.x.com
Endpoint path	/1.1/search/tweets.json	/2/tweets/search/recent
Autenticación	OAuth 1.0a User Context OAuth 2.0 App-Only	OAuth 1.0a User Context OAuth 2.0 Authorization Code with PKCE OAuth 2.0 App-Only
Formato de timestamp	YYYYMMDD	YYYY-MM-DDTHH:mm:ssZ ISO 8601 / RFC 3339
Devuelve Posts no más antiguos de	7 días	7 días
Métodos HTTP admitidos	GET	GET
Límites de tasa de solicitud predeterminados	180 solicitudes por 15 min con OAuth 1.0a User Context 450 solicitudes por 15 min con OAuth 2.0 App-Only	Self-serve: 60 solicitudes por 15 min con OAuth 2.0 App-Only 60 solicitudes por 15 min con OAuth 1.0a User Context 60 solicitudes por 15 min con OAuth 2.0 Authorization Code with PKCE
Ofrece URLs completamente expandidas		✔
Máximo de Posts por respuesta (predeterminado)	100 (15)	100 (10)
Formato JSON de Post	Formato Standard v1.1	Formato X API v2 (determinado por los parámetros de solicitud fields y expansions, no es retrocompatible con formatos v1.1) Para obtener más información sobre cómo migrar del formato Standard v1.1 al formato X API v2, visita nuestra guía de migración de formatos de datos.
Admite la selección de qué fields se devuelven en el payload		✔
Admite solicitar y recibir annotations		✔
Admite solicitar métricas específicas dentro del objeto Post		✔
Admite el operador y campo conversation_id		✔
Proporciona historial de edición de Post	✔	✔
Nombre de la clave JSON para el array de datos de Post	statuses	data
Nombre de la clave JSON para paginación	search_metadata.next_results	meta.next_token
Admite navegación del archivo por rango de tiempo	✔	✔
Resolución temporal de las solicitudes basadas en tiempo	día	segundo
Zona horaria	UTC	UTC
Parámetros de solicitud para navegar por tiempo	until	start_time end_time
Parámetros de solicitud para navegar por ID de Post	since_id max_id	since_id until_id
Parámetro de solicitud para paginación	Proporciona consulta codificada en URL	next_token
Requiere el uso de credenciales de una developer App asociada a un Project		✔

Comparación de full-archive search

La siguiente tabla compara los diversos tipos de endpoints de full-archive search:

Description	Enterprise	X API v2
Host domain	https://gnip-api.x.com	https://api.x.com
Endpoint path	/search/fullarchive/accounts/:account_name/:label	/2/tweets/search/all
Autenticación	Basic auth	OAuth 2.0 App-Only
Formato de timestamp	YYYYMMDDHHMM	YYYY-MM-DDTHH:mm:ssZ ISO 8601 / RFC 3339
Devuelve Posts no más antiguos de	El archivo completo desde marzo de 2006	El archivo completo desde marzo de 2006
Métodos HTTP admitidos	GET POST	GET
Límites de tasa de solicitud predeterminados	El límite por minuto variará según el partner como se especifica en tu contrato. 20 solicitudes por seg con Basic auth	300 solicitudes por 15 min con OAuth 2.0 App-Only 1 solicitud por 1 seg con OAuth 2.0 App-Only
Ofrece URLs completamente expandidas	✔	✔
Posts por respuesta	Máximo: 500 Predeterminado: 100	Máximo: 500 Predeterminado: 10
Formato JSON de Post	Formato Native Enriched o Activity Streams	Formato X API v2 (determinado por los parámetros de solicitud fields y expansions)
Admite la selección de qué fields se devuelven en el payload		✔
Admite solicitar y recibir annotations		✔
Admite solicitar métricas específicas dentro del objeto Post		✔
Admite el operador y campo conversation_id		✔
Proporciona historial de edición de Post	✔	✔
Nombre de la clave JSON para el array de datos de Post	results	data
Nombre de la clave JSON para paginación	next	meta.next_token
Resolución temporal de las solicitudes basadas en tiempo	segundo	segundo
Zona horaria	UTC	UTC
Admite navegación del archivo por ID de Post		✔
Parámetros de solicitud para navegación por tiempo	fromDate toDate	start_time end_time
Parámetros de solicitud para navegar por ID de Post		since_id until_id
Parámetro de solicitud para paginación	next_token	next_token
Requiere el uso de credenciales de una developer App asociada a un Project que tenga acceso Academic Research		✔

Comparación de operadores de filtrado Las cuatro versiones diferentes (standard, enterprise y v2) de search Posts difieren en qué operadores están disponibles, y también tienen distintos niveles de disponibilidad de operadores dentro de cada versión, que se explican a continuación. Enterprise

No hay sub-niveles de operadores enterprise

X API v2

Self-serve: disponible al usar cualquier Project
Enterprise: disponible al usar un Project

Puedes obtener más información sobre cada uno de estos conjuntos de operadores en sus respectivas guías:

Ahora que entendemos los diferentes niveles de operadores dentro de X API v2, aquí está la tabla que mapea la disponibilidad de operadores para search Posts (ten en cuenta que si la celda está en blanco, el operador no está disponible):

Search operator	Standard	Enterprise	v2
keyword	Disponible q:keyword	Disponible	Disponible
emoji	Disponible q:😄	Disponible	Disponible
”exact phrase”	Disponible	Disponible	Disponible
#	Disponible	Disponible	Disponible
$	Disponible	Disponible	Disponible
@	Disponible	Disponible	Disponible
from:	Disponible	Disponible	Disponible
to:	Disponible	Disponible	Disponible
url:	Disponible	Disponible	Disponible
retweets_of:		Disponible	Disponible
context:			Disponible
entity:			Self-serve - Solo disponible con recent search
conversation_id:			Disponible
place:		Disponible	Disponible
place_country:		Disponible	Disponible
point_radius:	parámetro geocode	Disponible	Disponible
bounding_box:		Disponible	Disponible
is:retweet	filter:retweets	Disponible	Disponible
is:reply		Disponible	Disponible
is:quote		Disponible	Disponible
is:verified		Disponible	Disponible
-is:nullcast		Disponible	Disponible
has:hashtags		Disponible	Disponible
has:cashtags		Disponible	Disponible
has:links	filter:links	Disponible	Disponible
has:mentions		Disponible	Disponible
has:media	filter:media	Disponible	Disponible
has:images	filter:images, filter:twimg	Disponible	Disponible
has:videos	filter:videos filter:native_video	Disponible	Disponible
has:geo		Disponible	Disponible
lang:	lang - puede usarse como operador o parámetro	Disponible	Disponible
has:profile_geo		Disponible
profile_country		Disponible
profile_locality		Disponible
profile_region		Disponible
proximity		Disponible
:(	Disponible
:)	Disponible
?	Disponible
filter:periscope	Disponible
list:	Disponible		Disponible
filter:replies	Disponible
filter:pro_video	Disponible
filter:social	Disponible
filter:trusted	Disponible
filter:follows	Disponible
filter:has_engagement	Disponible
include:antisocial	Disponible
include:offensive_user	Disponible
include:antisocial_offensive_user	Disponible
include:sensitive_content	Disponible
source:	Disponible
min_replies:	Disponible
min_retweets:	Disponible
min_faves:	Disponible
card_name:	Disponible
card_domain:	Disponible

Otros recursos de migración Centro de migración de la X API Consulta código de ejemplo para estos endpoints Search Posts: Standard v1.1 a X API v2 Search Posts: Enterprise a X API v2

Getting Started

Products

Fundamentals

Partners & Customers

Resources

Descripción general

Comparación de los endpoints de Search Posts de la X API

Comparación de recent search

Comparación de full-archive search

​Comparación de los endpoints de Search Posts de la X API

​Comparación de recent search

​Comparación de full-archive search

Comparación de los endpoints de Search Posts de la X API

Comparación de recent search

Comparación de full-archive search