Skip to main content

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

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

​
Comparación de búsqueda reciente

La siguiente tabla compara los distintos tipos de endpoints de búsqueda reciente:
DescripciónStandard v1.1X API v2
Dominio del hosthttps://api.x.comhttps://api.x.com
Ruta del endpoint/1.1/search/tweets.json/2/tweets/search/recent
AutenticaciónContexto de usuario OAuth 1.0a
OAuth 2.0 solo App		Contexto de usuario OAuth 1.0a

Código de autorización OAuth 2.0 con PKCE

OAuth 2.0 solo App
Formato de marca de tiempoYYYYMMDDYYYY-MM-DDTHH:mm:ssZ
ISO 8601 / RFC 3339
Devuelve Publicaciones con una antigüedad máxima de7 días7 días
Métodos HTTP compatiblesGETGET
Límites de tasa de solicitud predeterminados180 solicitudes por 15 min con contexto de usuario OAuth 1.0a

450 solicitudes por 15 min con OAuth 2.0 solo App		Autoservicio:

60 solicitudes por 15 min con OAuth 2.0 solo App

60 solicitudes por 15 min con contexto de usuario OAuth 1.0a

60 solicitudes por 15 min con código de autorización OAuth 2.0 con PKCE
Ofrece URLs completamente expandidas✔
Máximo de Publicaciones por respuesta (predeterminado)100 (15)100 (10)
Formato JSON de la PublicaciónFormato Standard v1.1Formato X API v2 (determinado por los parámetros de solicitud fields y expansions; no es compatible con versiones anteriores de los 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.
Permite seleccionar qué campos se devuelven en la carga útil✔
Permite solicitar y recibir anotaciones✔
Permite solicitar métricas específicas dentro del objeto de la Publicación✔
Permite usar el operador y campo conversation_id✔
Proporciona historial de edición de la Publicación✔✔
Nombre de la clave JSON para el arreglo de datos de la Publicaciónstatusesdata
Nombre de la clave JSON para la paginaciónsearch_metadata.next_resultsmeta.next_token
Permite navegar el archivo por rango de tiempo✔✔
Resolución temporal de las solicitudes basadas en tiempodíasegundo
Zona horariaUTCUTC
Parámetros de solicitud para navegar por tiempountilstart_time
end_time
Parámetros de solicitud para navegar por id de la Publicaciónsince_id
max_id		since_id
until_id
Parámetro de solicitud para la paginaciónProporciona una consulta codificada en URLnext_token
Requiere el uso de credenciales de una App de desarrollador asociada a un Proyecto✔

​
Comparación de búsqueda en el archivo completo

La siguiente tabla compara los diversos tipos de endpoints de búsqueda en el archivo completo:
DescripciónEnterpriseX API v2
Dominio de hosthttps://gnip-api.x.comhttps://api.x.com
Ruta del endpoint/search/fullarchive/accounts/:account_name/:label/2/tweets/search/all
AuthenticationBasic authOAuth 2.0 App-Only
Formato de marca de tiempoYYYYMMDDHHMMYYYY-MM-DDTHH:mm:ssZ
ISO 8601 / RFC 3339
Devuelve Publicaciones que no sean anteriores aEl archivo completo desde marzo de 2006El archivo completo desde marzo de 2006
Métodos HTTP compatiblesGET
POST		GET
Límites de tasa de solicitudes predeterminadosEl límite de tasa por minuto variará según el socio, tal como se especifica en su contrato.

20 solicitudes por segundo 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 resueltas✔✔
Publicaciones por respuestaMáximo: 500
Predeterminado: 100		Máximo: 500
Predeterminado: 10
Formato JSON de la PublicaciónFormato Native Enriched or Activity StreamsFormato X API v2 (determinado por los parámetros de solicitud fields y expansions)
Permite seleccionar qué fields se devuelven en el payload✔
Permite solicitar y recibir annotations✔
Permite solicitar metrics específicas dentro del objeto Post✔
Permite el operador y campo conversation_id✔
Proporciona historial de edición de la Publicación✔✔
Nombre de la clave JSON para el array de datos de la Publicaciónresultsdata
Nombre de la clave JSON para la paginaciónnextmeta.next_token
Resolución temporal de las solicitudes basadas en el tiemposecondsecond
Zona horariaUTCUTC
Permite navegar por el archivo mediante el ID de la Publicación✔
Parámetros de solicitud para la navegación por tiempofromDate
toDate		start_time
end_time
Parámetros de solicitud para la navegación por ID de la Publicaciónsince_id
until_id
Parámetro de solicitud para la paginaciónnext_tokennext_token
Requiere el uso de credenciales de una developer App asociada con un Project que tenga acceso de Academic Research✔
Comparación de operadores de filtrado Las cuatro versiones diferentes (Standard, Enterprise y v2) de búsqueda de Publicaciones difieren en qué operadores están disponibles y también presentan distintos niveles de disponibilidad de operadores dentro de cada versión, que se explican a continuación. Enterprise
  • No existen subniveles de operadores Enterprise
X API v2
  • Self-serve: Disponible cuando se utiliza cualquier Project
  • Enterprise: Disponible cuando se utiliza un Project
Puede 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 muestra la disponibilidad de operadores para la búsqueda de Publicaciones (tenga en cuenta que, si la celda se deja en blanco, el operador no está disponible):
Operador de búsquedaStandardEnterprisev2
keywordDisponible
q:keyword		DisponibleDisponible
emojiDisponible
q:😄		DisponibleDisponible
”exact phrase”DisponibleDisponibleDisponible
#DisponibleDisponibleDisponible
$DisponibleDisponibleDisponible
@DisponibleDisponibleDisponible
from:DisponibleDisponibleDisponible
to:DisponibleDisponibleDisponible
url:DisponibleDisponibleDisponible
retweets_of:DisponibleDisponible
context:Disponible
entity:Autoservicio: solo disponible con búsqueda reciente
conversation_id:Disponible
place:DisponibleDisponible
place_country:DisponibleDisponible
point_radius:parámetro geocodeDisponibleDisponible
bounding_box:DisponibleDisponible
is:retweetfilter:retweetsDisponibleDisponible
is:replyDisponibleDisponible
is:quoteDisponibleDisponible
is:verifiedDisponibleDisponible
-is:nullcastDisponibleDisponible
has:hashtagsDisponibleDisponible
has:cashtagsDisponibleDisponible
has:linksfilter:linksDisponibleDisponible
has:mentionsDisponibleDisponible
has:mediafilter:mediaDisponibleDisponible
has:imagesfilter:images, filter:twimgDisponibleDisponible
has:videosfilter:videos
filter:native_video		DisponibleDisponible
has:geoDisponibleDisponible
lang:lang: se puede usar como operador o como parámetroDisponibleDisponible
has:profile_geoDisponible
profile_countryDisponible
profile_localityDisponible
profile_regionDisponible
proximityDisponible
:(Disponible
:)Disponible
?Disponible
filter:periscopeDisponible
list:DisponibleDisponible
filter:repliesDisponible
filter:pro_videoDisponible
filter:socialDisponible
filter:trustedDisponible
filter:followsDisponible
filter:has_engagementDisponible
include:antisocialDisponible
include:offensive_userDisponible
include:antisocial_offensive_userDisponible
include:sensitive_contentDisponible
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 X API Consulta algunos ejemplos de código para estos endpoints Buscar Publicaciones: Standard v1.1 a X API v2 Buscar Publicaciones: Enterprise a X API v2