Operadores de búsqueda

Esta página ofrece una lista de operadores que puedes usar al crear una consulta en los endpoints de la API Search v2.

​

Lista de operadores

Nota: Para algunos operadores hay disponible un nombre alternativo (alias).

Operador	Type	Descripción
keyword	Independiente	Coincide con una palabra clave dentro del cuerpo de una Publicación. Esta es una coincidencia tokenizada, lo que significa que tu cadena de palabra clave se comparará con el texto tokenizado del cuerpo de la Publicación. La tokenización divide las palabras según signos de puntuación, símbolos y caracteres separadores del plano básico de Unicode. Por ejemplo, una Publicación con el texto “I like coca-cola” se dividiría en los siguientes tokens: I, like, coca, cola. Estos tokens se compararían con la cadena de palabra clave usada en tu consulta. Para hacer coincidir cadenas que contengan signos de puntuación (por ejemplo, coca-cola), símbolos o caracteres separadores, debes encerrar tu palabra clave entre comillas dobles. Ejemplo: pepsi OR cola OR "coca cola"
emoji	Independiente	Coincide con un emoji dentro del cuerpo de una Publicación. De forma similar a una palabra clave, los emojis se tratan como coincidencias tokenizadas, lo que significa que tu emoji se comparará con el texto tokenizado del cuerpo de la Publicación. Ten en cuenta que, si un emoji tiene una variante, debes encerrarlo entre comillas dobles para incluirlo en una consulta. Ejemplo: (😃 OR 😡) 😬
"exact phrase match"	Independiente	Coincide con la frase exacta en el cuerpo de una Publicación. Ejemplo: ("X API" OR #v2) -"recent search"
#	Independiente	Coincide con cualquier Publicación que contenga un hashtag reconocido, siempre que el hashtag sea una entidad reconocida en una Publicación. Este operador realiza una coincidencia exacta, NO una coincidencia tokenizada, lo que significa que la regla #thanku coincidirá con Publicaciones que tengan exactamente el hashtag #thanku, pero no con aquellas que tengan el hashtag #thankunext. Ejemplo: #thankunext #fanart OR @arianagrande
@	Independiente	Hace coincidir cualquier Publicación que mencione el nombre de usuario proporcionado, siempre que dicho nombre de usuario sea una entidad reconocida (incluido el carácter @). Ejemplo: (@XDevelopers OR @API) -@X
$	Independiente	Coincide con cualquier Publicación que contenga el ‘cashtag’ especificado (donde el primer carácter del token es el carácter ).<br /><br />Ten en cuenta que el operador de cashtag se basa en la extracción de la entidad &#39;symbols&#39; de X para encontrar cashtags, en lugar de intentar extraer el cashtag del contenido de la Publicación.<br /><br />Ejemplo: `twtr OR @XDevelopers -$fb`
from:	Independiente	Coincide con cualquier Publicación de un usuario específico. El valor puede ser el nombre de usuario (sin el carácter @) o el id numérico del usuario. Solo se puede pasar un único nombre de usuario/id por operador from:. Ejemplo: from:XDevelopers OR from:API -from:X
to:	Independiente	Coincide con cualquier Publicación que sea una respuesta a un usuario específico. El valor puede ser el nombre de usuario (sin incluir el carácter @) o el id numérico del usuario. Solo puedes proporcionar un único nombre de usuario/id por operador to:. Ejemplo: to:XDevelopers OR to:API -to:X
url:	Independiente	Realiza una coincidencia tokenizada en cualquier URL con formato válido de una Publicación. Este operador busca coincidencias en el contenido de los campos url o expanded_url. Por ejemplo, una Publicación que contenga “You should check out X Developer Labs: https://t.co/c0A36SWil4” (con la URL corta que redirige a https://developer.twitter.com) cumplirá ambas de las siguientes reglas: from:XDevelopers url:"https://developer.twitter.com" (porque coincidirá con el contenido de entities.urls.expanded_url) from:XDevelopers url:"https://t.co" (porque coincidirá con el contenido de entities.urls.url) Los tokens y frases que contengan puntuación o caracteres especiales deben ir entre comillas dobles (por ejemplo, url:"/developer"). Del mismo modo, para buscar una coincidencia con un protocolo específico, enciérralo entre comillas dobles (por ejemplo, url:"https://developer.twitter.com").
retweets_of:	Independiente	Coincide con Publicaciones que son Retweets del usuario especificado. El valor puede ser el nombre de usuario (excluyendo el carácter @) o el id numérico de usuario. Solo puedes incluir un único nombre de usuario/id por operador retweets_of:. Ejemplo: retweets_of:twitterdev OR retweets_of:twitterapi
in_reply_to_tweet_id:	Independiente	Alias disponible: in_reply_to_status_id: Coincide con las respuestas a la Publicación especificada. Ejemplo: in_reply_to_tweet_id:1539382664746020864
retweets_of_tweet_id:	Independiente	Alias disponible: retweets_of_status_id: Coincide con los Retweets explícitos (o nativos) de la Publicación especificada. Ten en cuenta que el ID de la Publicación utilizado debe ser el ID de una Publicación original y no de un Retweet. Ejemplo: retweets_of_tweet_id:1539382664746020864
quotes_of_tweet_id:	Independiente	Alias disponible: quotes_of_status_id: Coincide con los Tweets con cita de la Publicación especificada. Ten en cuenta que el id de la Publicación utilizado debe ser el id de una Publicación original y no de un Tweet con cita. Ejemplo: quotes_of_tweet_id:1539382664746020864
context:	Independiente	Coincide con Publicaciones que tienen un par específico de id de dominio/id de entidad. Para obtener más información sobre este operador, visita nuestra página sobre anotaciones. Solo puedes incluir un único dominio/entidad por operador context:. context:domain_id.entity_id Sin embargo, puedes combinar varios dominios/entidades usando el operador OR: (context:47.1139229372198469633 OR context:11.1088514520308342784) Ejemplos: context:10.799022225751871488 (domain_id.entity_id devuelve Publicaciones que coinciden con ese par específico de dominio-entidad)
entity:	Independiente	Devuelve Publicaciones que coinciden con un valor de cadena de entidad específico. Para obtener más información sobre este operador, visita nuestra página sobre anotaciones. Ten en cuenta que esto solo está disponible con la búsqueda reciente. Solo puedes usar un único operador entity:. entity:"string declaration of entity/place" Ejemplos: entity:"Michael Jordan" OR entity:"Barcelona"
conversation_id:	Independiente	Coincide con las Publicaciones que comparten un mismo ID de conversación. Un ID de conversación corresponde al ID de la Publicación que inició una conversación. A medida que se publican respuestas a una Publicación, incluso respuestas a otras respuestas, el conversation_id se agrega a su payload JSON. Solo puedes pasar un único ID de conversación por operador conversation_id:. Ejemplo: conversation_id:1334987486343299072 (from:XDevelopers OR from:api)
list:	Independiente	Coincide con Publicaciones de usuarios que son miembros de una Lista especificada. Por ejemplo, si @XDevelopers y @api fueran miembros de la Lista 123 e incluyeras list:123 en tu consulta, tu respuesta solo contendrá Publicaciones publicadas por esas cuentas. Puedes encontrar los ID de listas usando el endpoint List lookup. Ten en cuenta que solo puedes usar un único operador list: por consulta y que solo puedes especificar una única Lista por operador list:. Ejemplo: list:123
place:	Independiente	Coincide con Publicaciones etiquetadas con la ubicación especificada o el ID de lugar de X. Los nombres de lugares de varias palabras (“New York City”, “Palo Alto”) deben ir entre comillas. Solo puedes usar un único lugar por operador place:. Nota: Consulta el endpoint estándar v1.1 GET geo/search para saber cómo obtener IDs de lugar de X. Nota: Este operador no coincidirá con Retweets, ya que los lugares de un Retweet están asociados a la Publicación original. Tampoco coincidirá con lugares asociados a la Publicación original de un Quote Tweet. Ejemplo: place:"new york city" OR place:seattle OR place:fd70c22040963ac7
place_country:	Independiente	Coincide con Publicaciones en las que el código de país asociado a un lugar/ubicación etiquetado coincide con el código ISO alfa-2 de dos caracteres especificado. Puedes encontrar una lista de códigos ISO válidos en Wikipedia. Solo puedes pasar un único código ISO por operador place_country:. Nota: Este operador no coincidirá con Retweets, ya que los lugares de los Retweets están asociados a la Publicación original. Tampoco coincidirá con los lugares asociados a la Publicación original de un Quote Tweet. Ejemplo: place_country:US OR place_country:MX OR place_country:CA
point_radius:	Independiente	Coincide con el objeto place.geo.coordinates de la Publicación cuando está presente y, en X, con un polígono geográfico de un lugar, donde el polígono del lugar está completamente contenido dentro de la región definida. point_radius:[longitude latitude radius] - Las unidades de radio admitidas son millas (mi) y kilómetros (km) - El radio debe ser menor que 25 mi - La longitud está en el rango de ±180 - La latitud está en el rango de ±90 - Todas las coordenadas están en grados decimales - Los argumentos de la regla se incluyen entre corchetes y se separan por espacios Solo puedes pasar un único polígono geográfico por operador point_radius:. Nota: Este operador no coincidirá con Retweets, ya que los lugares de un Retweet están asociados a la Publicación original. Tampoco coincidirá con los lugares asociados a la Publicación original de un Quote Tweet. Ejemplo: point_radius:[2.355128 48.861118 16km] OR point_radius:[-41.287336 174.761070 20mi]
bounding_box:	Independiente	Alias disponible: geo_bounding_box: Coincide con el objeto place.geo.coordinates de la Publicación cuando está presente y, en X, con un polígono geográfico de un lugar, donde el polígono de lugar está completamente contenido dentro de la región definida. bounding_box:[west_long south_lat east_long north_lat] - west_long south_lat representan la esquina suroeste del bounding box, donde west_long es la longitud de ese punto y south_lat es la latitud. - east_long north_lat representan la esquina noreste del bounding box, donde east_long es la longitud de ese punto y north_lat es la latitud. - El ancho y la altura del bounding box deben ser menores que 25 mi - La longitud está en el rango de ±180 - La latitud está en el rango de ±90 - Todas las coordenadas están en grados decimales. - Los argumentos de la regla están contenidos entre corchetes y separados por espacios. Solo puedes pasar un único polígono geográfico por operador bounding_box:. Nota: Este operador no coincidirá con Retweets, ya que los lugares del Retweet están asociados a la Publicación original. Tampoco coincidirá con los lugares asociados a la Publicación original de un Quote Tweet. Ejemplo: bounding_box:[-105.301758 39.964069 -105.178505 40.09455]
is:retweet	Requiere conjunción	Coincide con los Retweets que cumplen el resto de la regla especificada. Este operador solo tiene en cuenta Retweets auténticos (por ejemplo, los generados mediante el botón Retweet). Este operador no incluye los Quote Tweets. Ejemplo: data @XDevelopers -is:retweet
is:reply	Requiere conjunción	Devuelve solo respuestas explícitas que coincidan con una regla. También se puede negar para excluir de la entrega las respuestas que coincidan con una consulta. Nota: Este operador también está disponible con el endpoint de stream filtrado. Cuando se usa con el stream filtrado, este operador coincide con respuestas a una Publicación original, respuestas en Tweets citados y respuestas en Retweets. Ejemplo: from:XDevelopers is:reply
is:quote	Requiere conjunción	Devuelve todos los Tweets citados, también conocidas como Publicaciones con comentarios. Ejemplo: "sentiment analysis" is:quote
is:verified	Requiere conjunción	Devuelve únicamente Publicaciones cuyos autores estén verificados en X. Ejemplo: #nowplaying is:verified
-is:nullcast	Requiere conjunción	Elimina las Publicaciones creadas únicamente con fines promocionales en ads.twitter.com que tienen "source":"Twitter for Advertisers (legacy)" o "source":"Twitter for Advertisers". Este operador debe utilizarse en forma negada. Para más información sobre Publicaciones nullcast, consulta nuestra página sobre disponibilidad de Publicaciones. Ejemplo: "mobile games" -is:nullcast
has:hashtags	Requiere conjunción	Coincide con las Publicaciones que contienen al menos un hashtag. Ejemplo: from:XDevelopers -has:hashtags
has:cashtags	Requiere conjunción	Coincide con Publicaciones que contienen un símbolo de cashtag (precedido por el carácter $). Por ejemplo, $tag. Ejemplo: #stonks has:cashtags
has:links	Requiere conjunción	Este operador devuelve Publicaciones que contienen enlaces y contenido multimedia en el cuerpo de la Publicación. Ejemplo: from:XDevelopers announcement has:links
has:mentions	Requiere conjunción	Coincide con las Publicaciones que mencionan a otro usuario de X. Ejemplo: #nowplaying has:mentions
has:media	Requiere conjunción	Alias disponible: has:media_link Coincide con Publicaciones que contienen un objeto multimedia, como una foto, un GIF o un video, según lo determine X. No coincidirá con contenido multimedia creado con Periscope ni con Publicaciones que incluyan enlaces a otros sitios de alojamiento de contenido multimedia. Ejemplo: (kittens OR puppies) has:media
has:images	Requiere conjunción	Coincide con las Publicaciones que contienen una URL reconocida de una imagen. Ejemplo: #meme has:images
has:video_link	Requiere conjunción	Alias disponible: has:videos Coincide con Publicaciones que contienen vídeos nativos de X, subidos directamente a X. No coincidirá con vídeos creados con Periscope ni con Publicaciones que incluyan enlaces a otros sitios de alojamiento de vídeo. Ejemplo: #icebucketchallenge has:video_link
has:geo	Requiere conjunción	Coincide con Publicaciones que tienen datos de geolocalización específicos de la Publicación proporcionados por el usuario de X. Esto puede ser una ubicación en forma de un lugar de X, con el nombre para mostrar correspondiente, polígono geográfico y otros campos, o, en casos poco frecuentes, una coordenada geográfica de latitud y longitud. Nota: Los operadores que coinciden en place (geo de la Publicación) solo incluirán coincidencias de Publicaciones originales. Los Retweets no contienen datos de lugar. Ejemplo: recommend #paris has:geo -bakery
lang:	Requiere conjunción	Coincide con Publicaciones que han sido clasificadas por X como pertenecientes a un idioma en particular (si, y solo si, la Publicación ha sido clasificada). Es importante tener en cuenta que actualmente cada Publicación solo se clasifica como perteneciente a un único idioma, por lo que combinar (AND) varios idiomas no arrojará resultados. Solo puedes pasar un único identificador de idioma BCP 47 por operador lang:. Nota: si no se puede realizar ninguna clasificación de idioma, el resultado proporcionado es ‘und’ (por indefinido). Ejemplo: recommend #paris lang:en La lista a continuación muestra los idiomas actualmente admitidos y su correspondiente identificador de idioma BCP 47: Amárico: am	Alemán: de	Malabar: ml	Eslovaco: sk Árabe: ar	Griego: el	Maldivo: dv	Esloveno: sl Armenio: hy	Guyaratí: gu	Maratí: mr	Kurdo sorani: ckb Euskera: eu	Criollo haitiano: ht	Nepalí: ne	Español: es Bengalí: bn	Hebreo: iw	Noruego: no	Sueco: sv Bosnio: bs	Hindi: hi	Oriya: or	Tagalo: tl Búlgaro: bg	Hindi latinizado: hi-Latn	Panyabí: pa	Tamil: ta Birmano: my	Húngaro: hu	Pastún: ps	Telugu: te Croata: hr	Islandés: is	Persa: fa	Tailandés: th Catalán: ca	Indonesio: in	Polaco: pl	Tibetano: bo Checo: cs	Italiano: it	Portugués: pt	Chino tradicional: zh-TW Danés: da	Japonés: ja	Rumano: ro	Turco: tr Neerlandés: nl	Canarés: kn	Ruso: ru	Ucraniano: uk Inglés: en	Jemer: km	Serbio: sr	Urdu: ur Estonio: et	Coreano: ko	Chino simplificado: zh-CN	Uigur: ug Finés: fi	Lao: lo	Sindhi: sd	Vietnamita: vi Francés: fr	Letón: lv	Cingalés: si	Galés: cy Georgiano: ka	Lituano: lt