Saltar al contenido principal
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.
OperadortypeDescripción
keywordIndependienteCoincide 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"
emojiIndependienteHace 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"IndependienteCoincide con la frase exacta en el cuerpo de una Publicación.

Ejemplo: ("X API" OR #v2) -"filtered stream"
"keyword1 keyword2"~NIndependienteOperador 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
#IndependienteCoincide 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
@IndependienteCoincide 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
$IndependienteCoincide 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:IndependienteCoincide 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:IndependienteCoincide 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:IndependienteRealiza 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:IndependienteAlias 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:IndependienteDevuelve 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:IndependienteCoincide 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:IndependienteCoincide 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:IndependienteAlias 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:IndependienteCoincide 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:IndependienteAlias 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:IndependienteCoincide 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:IndependienteCoincide 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:IndependienteCoincide 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:IndependienteAlias 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:retweetRequiere conjunciónDevuelve 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:replyRequiere conjunciónEntrega 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:quoteRequiere conjunciónDevuelve todos los Tweets citados, también conocidos como Publicaciones con comentario.

Ejemplo: "sentiment analysis" is:quote
is:verifiedRequiere conjunciónDevuelve únicamente las Publicaciones cuyos autores estén verificados por X.

Ejemplo: #nowplaying is:verified
-is:nullcastRequiere conjunciónElimina 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:hashtagsRequiere conjunciónCoincide con las Publicaciones que contienen al menos un hashtag.

Ejemplo: from:XDevelopers -has:hashtags
has:cashtagsRequiere conjunciónCoincide 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:linksRequiere conjunciónEste operador devuelve Publicaciones que contienen enlaces y contenido multimedia en el cuerpo de la Publicación.

Ejemplo: from:XDevelopers announcement has:links
has:mentionsRequiere conjunciónCoincide con Publicaciones que mencionan a otro usuario de X.

Ejemplo: #nowplaying has:mentions
has:mediaRequiere conjunciónAlias 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:imagesRequiere conjunciónCoincide con Publicaciones que contienen una URL reconocida que apunta a una imagen.

Ejemplo: #meme has:images
has:video_linkRequiere conjunciónAlias 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:geoRequiere conjunciónCoincide 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ónDevuelve 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ónCoincide 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:

IdiomaBCP 47
*-
Amháricoam
Árabear
Armeniohy
Vascoeu
Bengalíbn
Bosniobs
Búlgarobg
Birmanomy
Croatahr
Catalánca
Checocs
Danésda
Neerlandésnl
Inglésen
Estonioet
Finésfi
Francésfr
Georgianoka
Alemánde
Griegoel
Guyaratígu
Criollo haitianoht
Hebreoiw
Hindihi
Hindi latinizadohi-Latn
Húngarohu
Islandésis
Indonesioin
Italianoit
Japonésja
Canaréskn
Jemerkm
Coreanoko
Laolo
Letónlv
Lituanolt
Malayalamml
Maldivodv
Maratímr
Nepalíne
Noruegono
Odia (oriya)or
Panyabípa
Pastúnps
Persafa
Polacopl
Portuguéspt
Rumanoro
Rusoru
Serbiosr
Chino simplificadozh-CN
Sindhisd
Cingaléssi
Eslovacosk
Eslovenosl
Kurdo soranickb
Españoles
Suecosv
Tagalogtl
Tamilta
Telugute
Tailandésth
Tibetanobo
Chino tradicionalzh-TW
Turcotr
Ucranianouk
Urduur
Uigurug
Vietnamitavi
Galéscy
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