Operadores de reglas de flujo

Esta página ofrece una lista de operadores disponibles al crear reglas para Filtered Stream v2.

​

Lista de operadores

Nota: Algunos operadores cuentan con un nombre alternativo, o alias.

Operador	type	Descripción
keyword	Independiente	Coincide con una palabra clave presente en el cuerpo de una Publicación. Se trata de una coincidencia tokenizada, lo que significa que tu cadena de palabras 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 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 entonces con la cadena de palabras clave utilizada en tu regla. Para poder hacer coincidir cadenas que contengan caracteres de puntuación (por ejemplo, coca-cola), símbolos o separadores, debes encerrar tu palabra clave entre comillas dobles. Ejemplo: pepsi OR cola OR "coca cola"
emoji	Independiente	Hace coincidir un emoji dentro del cuerpo de una Publicación. De forma similar a una palabra clave, los emojis se tratan como una coincidencia tokenizada, 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 agregarlo a una regla. Ejemplo: (😃 OR 😡) 😬
"exact phrase match"	Independiente	Coincide con la frase exacta en el cuerpo de una Publicación. Ejemplo: ("X API" OR #v2) -"filtered stream"
"keyword1 keyword2"~N	Independiente	Operador de proximidad que hace coincidir una Publicación en la que las palabras clave están a una distancia máxima de N tokens entre sí. Las palabras clave en orden inverso pueden estar separadas por no más de N-2 tokens. N no puede ser mayor que 6. Ejemplo: "social media"~5 OR "API"~3
#	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	Coincide con cualquier Publicación que mencione el nombre de usuario indicado, si el nombre de usuario es 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 carácter inicial del token es el carácter undefinedtwtr OR @XDevelopers -$fb`
from:	Independiente	Coincide con cualquier Publicación de un usuario específico. El valor puede ser el nombre de usuario (excluyendo el carácter @) o el id numérico del usuario. Solo puedes 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 el carácter @) o el ID numérico del usuario. Solo se puede pasar un único nombre de usuario o ID por operador to:. Ejemplo: to:XDevelopers OR to:api -to:x
url:	Independiente	Realiza una coincidencia basada en tokens en cualquier URL con formato válido de una Publicación. Este operador puede hacer coincidir 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” (donde la URL corta redirige a https://developer.x.com) coincidirá con las dos reglas siguientes: from:XDevelopers url:"https://developer.x.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 las frases que contengan signos de puntuación o caracteres especiales deben ir entre comillas dobles (por ejemplo, url:"/developer"). Del mismo modo, para hacer coincidir un protocolo específico, debe ir entre comillas dobles (por ejemplo, url:"https://developer.x.com"). Solo se puede pasar una única URL por operador url:.
retweets_of:	Independiente	Alias disponible: retweets_of_user: Coincide con las Publicaciones que son Retweets del usuario especificado. El valor puede ser el nombre de usuario (sin el carácter @) o la id numérica del usuario. Solo puedes pasar un único nombre de usuario o id por operador retweets_of:. Ejemplo: retweets_of:XDevelopers OR retweets_of:twitterapi Consulta AQUÍ los métodos para buscar ids numéricas de cuentas de X.
context:	Independiente	Devuelve Publicaciones con un id de dominio específico y/o un par id de dominio, id de entidad donde * representa un comodín. Para obtener más información sobre este operador, visita nuestra página sobre anotaciones de Publicaciones. Solo puedes pasar un único dominio/entidad por operador context:. context:domain_id.entity_id context:domain_id.* context:*.entity_id Ejemplos: context:10.799022225751871488 (domain_id.entity_id devuelve Publicaciones que coinciden con ese par dominio-entidad específico) context:47.* (domain_id.* devuelve Publicaciones que coinciden con ese id de dominio, con cualquier par dominio-entidad) context:*.799022225751871488 (*.entity_id devuelve Publicaciones que coinciden con ese id de entidad, con cualquier par dominio-entidad)
entity:	Independiente	Coincide con Publicaciones que tengan un valor de cadena de entidad específico. Para obtener más información sobre este operador, visita nuestra página sobre anotaciones. Solo puedes pasar una única entidad por 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 identificador de conversación. Un identificador de conversación corresponde al identificador de Publicación (Post ID) de la Publicación que inició una conversación. A medida que se publican respuestas (Replies) a una Publicación, incluidas respuestas a respuestas, el conversation_id se añade a su payload JSON. Solo puedes pasar un único identificador de conversación por operador conversation_id:. Ejemplo: conversation_id:1334987486343299072 (from:XDevelopers OR from:api)
bio:	Independiente	Alias disponible: user_bio: Coincide con una palabra clave o una frase presente en la biografía del autor de la Publicación. Se trata de una coincidencia tokenizada dentro del contenido del campo description del objeto User. Ejemplo: bio:developer OR bio:"data engineer" OR bio:academic
bio_name:	Independiente	Coincide con una palabra clave dentro del nombre del perfil del usuario que publicó la Publicación. Se trata de una coincidencia tokenizada dentro del contenido del campo «name» de un usuario en el User object. Ejemplo: bio_name:phd OR bio_name:md
bio_location:	Independiente	Alias disponible: user_bio_location: Coincide con Publicaciones que han sido publicadas por usuarios cuya ubicación contiene la palabra clave o frase especificada. Este operador realiza una coincidencia tokenizada, similar a las reglas normales de palabras clave aplicadas al cuerpo del mensaje. Esta ubicación forma parte del User object, coincide con el campo ‘location’ y es una cadena no normalizada, generada por el usuario y de formato libre. También es diferente de la ubicación de una Publicación (consulta place:). Ejemplo: bio_location:"big apple" OR bio_location:nyc OR bio_location:manhattan
place:	Independiente	Coincide con Publicaciones etiquetadas con la ubicación especificada o con el ID de lugar de X. Los nombres de lugares con varias palabras (“New York City”, “Palo Alto”) deben ir entre comillas. Solo puedes pasar 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 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:"new york city" OR place:seattle OR place:fd70c22040963ac7
place_country:	Independiente	Coincide con Publicaciones cuyo código de país asociado a un lugar/ubicación etiquetados coincide con el código ISO alfa-2 de dos caracteres proporcionado. 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 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_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 de Place 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 25mi - 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 encierran 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 del Retweet están adjuntos a la Publicación original. Tampoco coincidirá con lugares adjuntos 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 del 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 cuadro delimitador, donde west_long es la longitud de ese punto y south_lat es la latitud. - east_long north_lat representan la esquina noreste del cuadro delimitador, donde east_long es la longitud de ese punto y north_lat es la latitud. - El ancho y el alto del cuadro delimitador 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 se encuentran entre corchetes, 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 de los Retweets están asociados a la Publicación original. Tampoco coincidirá con lugares asociados a la Publicación original de un Tweet citado. Ejemplo: bounding_box:[-105.301758 39.964069 -105.178505 40.09455]
is:retweet	Requiere conjunción	Devuelve los Retweets que cumplen el resto de la regla especificada. Este operador solo busca Retweets auténticos (por ejemplo, los generados con el botón Retweet). Este operador no incluirá los Quote Tweets. Ejemplo: data @XDevelopers -is:retweet
is:reply	Requiere conjunción	Entrega solo respuestas explícitas que coincidan con una regla. También puede negarse para excluir de la entrega las respuestas que coincidan con una regla. Cuando se usa con el flujo filtrado, este operador coincide con respuestas a una Publicación original, respuestas en Publicaciones citadas y respuestas en Retweets. Ejemplo: from:XDevelopers is:reply
is:quote	Requiere conjunción	Devuelve todos los Tweets citados, también conocidos como Publicaciones con comentario. Ejemplo: "sentiment analysis" is:quote
is:verified	Requiere conjunción	Devuelve únicamente las Publicaciones cuyos autores estén verificados por 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 usarse en forma negada. Para obtener más información sobre las 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 las Publicaciones que contienen un símbolo de cashtag (precedido por el carácter ‘&#39;. Por ejemplo, `tag).<br /><br />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 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, GIF o vídeo, según lo determinado por X. No coincidirá con contenido multimedia creado con Periscope ni con Publicaciones con enlaces a otros sitios de alojamiento de contenido multimedia. Ejemplo: (kittens OR puppies) has:media
has:images	Requiere conjunción	Coincide con Publicaciones que contienen una URL reconocida que apunta a una imagen. Ejemplo: #meme has:images
has:video_link	Requiere conjunción	Alias disponible: has:videos Coincide con Publicaciones que contienen videos nativos de X, cargados directamente en X. Este operador no devolverá coincidencias para videos creados con Periscope ni para Publicaciones con enlaces a otros sitios de alojamiento de videos. 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 lugar de X, con el nombre para mostrar correspondiente, polígono geográfico y otros campos o, en raros casos, una coordenada geográfica de latitud-longitud. Nota: Los operadores que hacen coincidencia por lugar (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
sample:	Requiere conjunción	Devuelve una muestra porcentual aleatoria de Publicaciones que coinciden con una regla, en lugar de todo el conjunto de Publicaciones. El valor del porcentaje debe expresarse como un número entero entre 1 y 100 (por ejemplo, sample:10 devolverá una muestra aleatoria del 10 %). Este operador primero reduce el alcance del flujo al porcentaje que especificaste y luego la regla/filtro se aplica a ese subconjunto muestreado. En otras palabras, si estás usando, por ejemplo, sample:10, cada Publicación tendrá un 10 % de probabilidad de estar en la muestra. Este operador se aplica a toda la regla y requiere que todos los términos unidos mediante OR se agrupen. Ejemplo: #nowplaying @spotify sample:15
lang:	Requiere conjunción	Coincide con Publicaciones que han sido clasificadas por X como pertenecientes a un idioma determinado (únicamente 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 varios idiomas con AND no producirá ningún resultado. 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’ (indefinido). Ejemplo: recommend #paris lang:en La siguiente lista representa los idiomas actualmente admitidos y su correspondiente identificador de idioma BCP 47:	Idioma	BCP 47		*	-		Amhárico	am		Árabe	ar		Armenio	hy		Vasco	eu		Bengalí	bn		Bosnio	bs		Búlgaro	bg		Birmano	my		Croata	hr		Catalán	ca		Checo	cs		Danés	da		Neerlandés	nl		Inglés	en		Estonio	et		Finés	fi		Francés	fr		Georgiano	ka		Alemán	de		Griego	el		Guyaratí	gu		Criollo haitiano	ht		Hebreo	iw		Hindi	hi		Hindi latinizado	hi-Latn		Húngaro	hu		Islandés	is		Indonesio	in		Italiano	it		Japonés	ja		Canarés	kn		Jemer	km		Coreano	ko		Lao	lo		Letón	lv		Lituano	lt		Malayalam	ml		Maldivo	dv		Maratí	mr		Nepalí	ne		Noruego	no		Odia (oriya)	or		Panyabí	pa		Pastún	ps		Persa	fa		Polaco	pl		Portugués	pt		Rumano	ro		Ruso	ru		Serbio	sr		Chino simplificado	zh-CN		Sindhi	sd		Cingalés	si		Eslovaco	sk		Esloveno	sl		Kurdo sorani	ckb		Español	es		Sueco	sv		Tagalog	tl		Tamil	ta		Telugu	te		Tailandés	th		Tibetano	bo		Chino tradicional	zh-TW		Turco	tr		Ucraniano	uk		Urdu	ur		Uigur	ug		Vietnamita	vi		Galés	cy
followers_count:		Coincide con Publicaciones cuando el autor tiene una cantidad de seguidores dentro del rango indicado. Si se especifica un solo número, coincidirá cualquier número igual o superior. Ejemplo: followers_count:500 Además, se puede especificar un rango para que coincida con cualquier número dentro de ese rango. Ejemplo: followers_count:1000..10000
tweets_count:		Alias disponible: statuses_count: Coincide con Publicaciones cuando el autor ha publicado una cantidad de Publicaciones que esté dentro del rango indicado. Si se especifica un solo número, coincidirá cualquier número igual o superior. Ejemplo: tweets_count:1000 Además, se puede especificar un rango para que coincida con cualquier número dentro de ese rango. Ejemplo: tweets_count:1000..10000
following_count:		Alias disponible: friends_count: Coincide con Publicaciones cuando el autor tiene un recuento de amigos (el número de usuarios a los que sigue) que se encuentra dentro del rango indicado. Si se especifica un único número, coincidirá cualquier valor igual o superior. Ejemplo: following_count:500 Además, se puede especificar un rango para que coincida cualquier valor dentro del rango dado. Ejemplo: following_count:1000..10000
listed_count:		Alias disponible: user_in_lists_count: Coincide con publicaciones cuando el autor está incluido en el número especificado de listas. Si se especifica un solo número, coincidirá cualquier número igual o superior. Ejemplo: listed_count:10 Además, se puede especificar un rango para hacer coincidir cualquier número dentro del rango dado. Ejemplo: listed_count:10..100
url_title:		Alias disponible: within_url_title: Realiza una búsqueda por palabra clave o frase en los metadatos title HTML de la URL expandida. Ejemplo: url_title:snow
url_description:		Alias disponible: within_url_description: Realiza una búsqueda de palabras clave o frases en los metadatos de la descripción de la página expandida. Ejemplo: url_description:weather
url_contains:		Busca Publicaciones cuyas URL contengan literalmente la frase o palabra clave indicada. Para buscar patrones que incluyan signos de puntuación (es decir, google.com), encierra el término de búsqueda entre comillas. NOTA: Esto también se aplicará a la URL expandida. Ejemplo: url_contains:photos
source:		Coincide con cualquier Publicación generada por la aplicación de origen indicada. El valor debe ser el nombre de la aplicación o la URL de la aplicación. No se puede usar por sí solo. Ejemplo: source:"X for iPhone" Nota: Como desarrollador de aplicaciones de X, las Publicaciones creadas de forma programática por tu aplicación tendrán como origen el nombre de tu aplicación y la URL de su sitio web configurados en tu app settings.
in_reply_to_tweet_id:		Alias disponible: in_reply_to_status_id: Devuelve solo respuestas explícitas a la Publicación especificada. Ejemplo: in_reply_to_tweet_id:1539382664746020864
retweets_of_tweet_id:		Alias disponible: retweets_of_status_id: Devuelve solo Retweets explícitos (o nativos) de la Publicación especificada. Ten en cuenta que el ID de estado utilizado debe ser el id de una Publicación original y no de un Retweet. Ejemplo: retweets_of_tweet_id:1539382664746020864