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

Lista de operadores

Nota: Para algunos operadores, hay un nombre alternativo o alias disponible.
OperadorTipoDescripción
keywordAutónomoCoincide con una palabra clave dentro del cuerpo de un Post. Es una coincidencia tokenizada, lo que significa que tu cadena de palabra clave se comparará con el texto tokenizado del cuerpo del Post. La tokenización separa las palabras según la puntuación, los símbolos y los caracteres separadores del plano básico multilingüe de Unicode.
Por ejemplo, un Post 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 regla. Para hacer coincidir cadenas que contengan signos de puntuación (por ejemplo, coca-cola), símbolos o caracteres separadores, debes encerrar la palabra clave entre comillas dobles.

Ejemplo:pepsi OR cola OR "coca cola"
emojiAutónomoCoincide con un emoji dentro del cuerpo de un Post. Al igual que una palabra clave, los emojis se emparejan mediante tokenización, lo que significa que tu emoji se comparará con el texto tokenizado del cuerpo del Post.

Ten en cuenta que, si un emoji tiene una variante, debes colocarlo entre comillas dobles para añadirlo a una regla.

Ejemplo:(😃 O 😡) 😬
"coincidencia de frase exacta"AutónomoCoincide con la frase exacta en el cuerpo de un Post.

Ejemplo:("X API" OR #v2) -"filtered stream"
"palabra clave 1 palabra clave 2"~NAutónomoOperador de proximidad que devuelve un Post en el que las palabras clave se encuentran dentro deNtokens el uno del otro.
Las palabras clave en orden inverso no pueden excederN-2tokens de diferencia.Nno puede ser superior a6.

Ejemplo:"redes sociales"~5 OR "API"~3
#AutónomoCoincide con cualquier Post que contenga un hashtag reconocido, siempre que el hashtag sea una entidad reconocida en un Post.

Este operador realiza una coincidencia exacta, NO una coincidencia por tokens, lo que significa que la regla#graciascoincidirá con las publicaciones que tengan el hashtag exacto #thanku, pero no con las que tengan el hashtag #thankunext.

Ejemplo:#thankunext #fanart O @arianagrande
@AutónomoCoincide con cualquier Post que mencione el nombre de usuario indicado, siempre que dicho nombre de usuario sea una entidad reconocida (incluido el carácter @).

Ejemplo:(@XDevelopers OR @api) -@x
$AutónomoCoincide con cualquier Post que contenga lo especificado’cashtag’(donde el carácter inicial del token es undefinedtwtr OR @XDevelopers -$fb`
from:AutónomoCoincide con cualquier Post de un usuario específico.
El valor puede ser el nombre de usuario (sin el carácter @) o el usuario’id numérico de usuario.

Solo puedes pasar un único nombre de usuario o idfrom:operador.

Ejemplo:from:XDevelopers OR from:api -from:X
para:AutónomoCoincide con cualquier Post que sea una respuesta a un usuario específico.
El valor puede ser el nombre de usuario (sin el carácter @) o el usuario’id numérico de usuario.

Solo puedes pasar un único nombre de usuario o id porpara:operador.

Ejemplo:to:XDevelopers OR to:api -to:x
url:AutónomoRealiza una coincidencia tokenizada en cualquier URL con formato válido de un Post.

Este operador puede hacer coincidir el contenido de ambosurloexpanded_urlfields. Por ejemplo, un Post que contiene”Deberías consultar X Developer Labs:https://t.co/c0A36SWil4”(con la URL corta que redirige ahttps://developer.x.com) coincidirá con las dos reglas siguientes:

from:XDevelopers url:"https://developer.x.com"
(porque coincidirá con el contenido deentities.urls.expanded_url)

from:XDevelopers url:"https://t.co"
(porque coincidirá con el contenido deentities.urls.url)

Los tokens y las frases que contengan signos de puntuación o caracteres especiales deben ir entre comillas dobles (por ejemplo,url:"/desarrolladores"). De manera similar, para hacer coincidir un protocolo específico, enciérralo entre comillas dobles (por ejemplo,url:"https://developer.x.com").

Solo puedes proporcionar una única URL porurl:operador.
retweets_of:AutónomoAlias disponible: retweets_of_user:
Coincide con Posts que son Retweets del usuario especificado. El valor puede ser el nombre de usuario (sin el carácter @) o el usuario’id numérico del usuario.

Solo puedes pasar un único nombre de usuario/id porretweets_of:operador.

Ejemplo:retweets_of:XDevelopers OR retweets_of:twitterapi
ConsultaAquímétodos para buscar id numéricos de cuentas de X.
context:IndependienteHace coincidir Posts 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, visite nuestra página sobreAnotaciones de publicaciones.

Solo puedes proporcionar un único dominio/entidad porcontext:operador.

context:domain_id.entity_id
context:domain_id.*
context:*.entity_id

Ejemplos:
context:10.799022225751871488
(domain_id.entity_iddevuelve Posts que coinciden con ese par específico de dominio y entidad)

context:47.*
(domain_id.*devuelve los Posts que coinciden con ese id de dominio, con cualquier par dominio–entidad)

context:*.799022225751871488
(*.entity_iddevuelve Posts que coincidan con ese id de entidad, con cualquier par dominio‑entidad)
entidad:AutónomoHace coincidir los Posts con un valor específico de cadena de entidad. Para obtener más información sobre este operador, visita nuestra página sobreanotaciones.

Solo puedes pasar una sola entidad porentity:operador.

entity:"declaración de cadena de entidad/lugar"

Ejemplos:entity:"Michael Jordan" OR entity:"Barcelona"
conversation_id:AutónomoCoincide con Posts que comparten un id de conversación común. Un id de conversación se establece con el id del Post que inició una conversación. A medida que se publican respuestas a un Post, incluso respuestas a respuestas, elconversation_idse añade a su carga útil JSON.

Solo puedes pasar un único id de conversación porconversation_id:operador.

Ejemplo:conversation_id:1334987486343299072 (from:XDevelopers OR from:api)
biografía:AutónomoAlias disponible: user_bio:
Coincide con una palabra clave o frase en el editor del Post’s biografía. Esto es una coincidencia tokenizada dentro del contenido de ladescripcióncampo dentro deObjeto de usuario.

Ejemplo:bio:developer OR bio:"data engineer" OR bio:academic
bio_name:AutónomoCoincide con una palabra clave dentro del editor del Post’nombre en la biografía del usuario. Esta es una coincidencia tokenizada dentro del contenido de un usuario’s”nombre”campo dentro deObjeto User.

Ejemplo:bio_name:phd OR bio_name:md
ubicacion_biografia:AutónomoAlias disponible: user_bio_location:
Coincide con Posts publicados 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.

Este lugar forma parte deObjeto de usuario, coincide con’ubicación’campo y es una cadena no normalizada, generada por el usuario y de formato libre. También es diferente de un Post’ubicación de s (consultaplace:).

Ejemplo:bio_location:"big apple" OR bio_location:nyc OR bio_location:manhattan
place:AutónomoBusca Posts etiquetados con la ubicación especificada o con el X place ID. Los nombres de lugares de varias palabras (“New York City”, “Palo Alto”) deben ir entre comillas.

Solo puedes pasar un único lugar porplace:operadora.

Nota: consulte elGET geo/searchextremo estándar v1.1 para obtener los X place IDs.

Nota: Este operador no coincidirá con Retweets, ya que los Retweets’s lugares están asociados al Post original. Tampoco coincidirá con lugares asociados al Post original de un Tweet citado.

Ejemplo:place:"nueva york" OR place:seattle OR place:fd70c22040963ac7
place_country:AutónomoCoincide con Posts cuyo código de país asociado a un lugar/ubicación etiquetado coincide con el código ISO alfa-2 indicado.

Puedes encontrar una lista de códigos ISO válidos enWikipedia.

Solo puedes proporcionar un único código ISO porplace_country:operador.

Nota: Este operador no coincidirá con Retweets, ya que el contenido del Retweet está adjunto a la publicación original.’s lugares están asociados a la Publicación original. Tampoco coincidirá con los lugares asociados a la Publicación original de un Tweet con cita.

Ejemplo:place_country:US OR place_country:MX OR place_country:CA
point_radius:AutónomoCoincide conplace.geo.coordinatesobjeto del Post, cuando esté presente, y, en X, frente a 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:[longitud latitud radio]

- Las unidades de radio compatibles son millas (mi) y kilómetros (km)
- El radio debe ser inferior a 25 mi
- La longitud está en el intervalo de ±180
- La latitud está en el intervalo de ±90
- Todas las coordenadas están en grados decimales
- Los argumentos de la regla van entre corchetes y se separan por espacios

Solo puedes proporcionar un único polígono geográfico porpoint_radius:operador.

Nota: Este operador no coincidirá con los Retweets, ya que el Retweet’los lugares están asociados al Post original. Tampoco coincidirá con los lugares asociados al Post original de un Quote Tweet.

Ejemplo:point_radius:[2.355128 48.861118 16km] OR point_radius:[-41.287336 174.761070 20mi]
bounding_box:AutónomoAlias disponible: geo_bounding_box:
Coincide con el objeto place.geo.coordinates del Post cuando está presente y, en X, con un polígono geográfico de un lugar, siempre que el polígono del lugar esté completamente contenido dentro de la región definida.

bounding_box:[longitud_oeste latitud_sur longitud_este latitud_norte]

-longitud_oeste latitud_surrepresentan la esquina suroeste del cuadro delimitador dondewest_longes la longitud de ese punto ysouth_lates la latitud.
-longitud_este latitud_norterepresentan la esquina noreste del cuadro de delimitación, dondelongitud_estees la longitud de ese punto ylat_nortees la latitud.
- El ancho y la altura del cuadro delimitador deben ser menores de 25 millas
- La longitud está en el rango de ±180
- La latitud está en el intervalo de ±90
- Todas las coordenadas están en grados decimales.
- Los argumentos de la regla están entre corchetes y separados por espacios.

Solo puedes proporcionar un único polígono geográfico porbounding_box:operador.

Nota: este operador no coincidirá con los Retweets, ya que el contenido del Retweet está adjunto a la publicación original’los lugares están asociados a la Publicación original. Tampoco coincidirá con los lugares asociados a la Publicación original de un Tweet con cita.

Ejemplo:bounding_box:[-105.301758 39.964069 -105.178505 40.09455]
is:retweetSe requiere una conjunciónCoincide con 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). Los Quote Tweets no se incluirán con este operador.

Ejemplo:data @XDevelopers -is:retweet
is:replySe requiere una conjunciónEntregar solo las 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 utiliza con el flujo filtrado, este operador coincide con las respuestas a una Publicación original, las respuestas en Publicaciones citadas y las respuestas en Retweets.

Ejemplo:from:XDevelopers is:reply
is:quoteSe requiere una conjunciónDevuelve todos los Quote Tweets, también conocidos como Posts con comentarios.

Ejemplo:"análisis de sentimientos" es:quote
is:verifiedSe requiere una conjunciónEntregar solo publicaciones cuyos autores estén verificados por X.

Ejemplo:#nowplaying is:verified
-is:nullcastSe requiere una conjunciónElimina los Posts creados exclusivamente para promoción en ads.twitter.com que tengan unsource:"Twitter para anunciantes (heredado)"osource:"Twitter para anunciantes".
Este operador debe negarse.

Para obtener más información sobre los Posts nullcast, consulte nuestra página sobreDisponibilidad de los Posts.

Ejemplo:"juegos para móviles" -is:nullcast
tiene:hashtagsSe requiere una conjunciónCoincide con los Posts que contienen al menos un hashtag.

Ejemplo:from:XDevelopers -has:hashtags
tiene:cashtagsSe requiere una conjunciónCoincide con Posts que contienen un símbolo de cashtag (con un carácter inicial ‘&#39;; por ejemplo, `tag).&#39;$&#39;carácter. Por ejemplo,$tag).<br /><br />Ejemplo:#stonks has:cashtags`
tiene:linksSe requiere una conjunciónEste operador coincide con los Posts que contienen enlaces y medios en el cuerpo del Post.

Ejemplo:from:XDevelopers anuncio has:links
tiene:mencionesSe requiere una conjunciónCoincide con los Posts que mencionan a otro usuario de X.

Ejemplo:#nowplaying has:mentions
has:mediaSe requiere una conjunciónAlias disponible: has:media_link
Coincide con Posts 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 Posts que incluyan enlaces a otros sitios de alojamiento de contenido multimedia.

Ejemplo:(gatitos OR cachorros) has:media
has:imagesSe requiere una conjunciónCoincide con los Posts que contienen una URL reconocida de una imagen.

Ejemplo:#meme has:images
has:video_linkSe requiere una conjunciónAlias disponible: has:videos
Coincide con Posts que contienen videos nativos de X, cargados directamente en X. Esto no coincidirá con videos creados con Periscope ni con Posts con enlaces a otros sitios de alojamiento de videos.

Ejemplo:#icebucketchallenge has:video_link
has:geoSe requiere una conjunciónCoincide con Posts que tienen datos de geolocalización específicos del Post 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 fields, o, en casos poco frecuentes, una coordenada geográfica de latitud y longitud.

Nota: Los operadores que hacen coincidencia por lugar (geolocalización del Post) solo incluirán coincidencias de publicaciones originales. Los Retweets no contienen datos de lugar.

Ejemplo:recommend #paris has:geo -bakery
sample:Se requiere una conjunciónDevuelve una muestra aleatoria, expresada en porcentaje, de Posts que cumplen una regla, en lugar del conjunto completo de Posts. El valor del porcentaje debe representarse con un número entero entre 1 y 100 (por ejemplo,sample:10devolverá una muestra aleatoria del 10 %).

Este operador primero reduce el alcance del flujo al porcentaje que especificaste y luego aplica la regla/filtro a ese subconjunto de muestra. En otras palabras, si estás usando, por ejemplo,sample:10, cada Post tendrá un 10% de probabilidad de aparecer en la muestra.

Este operador se aplica a toda la regla y exige que todos los OR estén agrupados’términos que se agruparán con OR.

Ejemplo:#sonandoahora @spotify sample:15
lang:Se requiere una conjunciónCoincide con Posts que X ha clasificado como de un idioma en particular (solo si el Post ha sido clasificado). Es importante tener en cuenta que actualmente cada Post solo se clasifica en un idioma, por lo que combinar varios idiomas con AND no arrojará resultados.

Solo puedes proporcionar un único identificador de idioma BCP 47 porlang:operador.

Nota: si no se puede determinar la clasificación de idioma, el resultado proporcionado es’and’(para undefined).

Ejemplo:recommend #paris lang:en

La siguiente lista muestra los idiomas actualmente admitidos y su identificador de idioma BCP 47 correspondiente:

IdiomaBCP 47
*-
Amáricoa. m.
árabear
armeniohy
vascoeu
Bengalíbn
Bosniobs
Búlgarobg
Birmanomy
Croatahr
Catalánca
Checocs
Danésda
Neerlandésnl
Ingléses
Estonioet
Finlandésfi
Francésfr
Georgianoka
Alemánde
Griegoel
Guyaratígu
Criollo haitianoht
Hebreohe
Hindihola
Hindi latinizadohi-Latn
Húngarohu
Islandésis
Indonesioin
Italianoello
Japonésja
Kannadakn
Jemerkm
Coreanoko
Laolo
Letónlv
Lituanolt
Malayalamml
Maldivo/adv
Marathimr
Nepalíne
Noruegono
Oriyao
Panyabípa
Pastúnps
Persafa
Polacopl
Portuguéspt
Rumanoro
Rusoru
Serbiosr
Chino simplificadozh-CN
Sindísd
cingalés
Eslovacoes
Eslovenosl
Kurdo soraníckb
Españoles
Suecosv
Tagalotl
Tamilta
Télugute
Tailandiath
Tibetanobo
Chino tradicionalzh-TW
Turcotr
UcranianoReino Unido
Urduur
Uigurug
Vietnamitavi
Galéscy
followers_count:Coincide con Posts cuyo autor tiene un número de seguidores dentro del rango especificado.
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 hacer coincidir cualquier número dentro del rango indicado.

Ejemplo:followers_count:1000..10000
tweets_count:Alias disponible: statuses_count:
Coincide con los Posts cuando el autor ha publicado una cantidad de Posts que se encuentra dentro del rango indicado.
Si se especifica un único número, coincidirá cualquier número igual o superior.

Ejemplo:tweets_count:1000

Además, puede especificarse un intervalo para coincidir con cualquier número dentro del intervalo indicado.

Ejemplo:tweets_count:1000..10000
following_count:Alias disponible: friends_count:
Coincide con Posts cuando el autor tiene un conteo 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 número igual o mayor.

Ejemplo:following_count:500

Además, se puede especificar un rango para que coincida con cualquier número dentro del rango indicado.

Ejemplo:following_count:1000..10000
listed_count:Alias disponible: user_in_lists_count:
Coincide con los Posts cuyo autor está incluido en el número especificado de Listas.
Si se especifica un único número, coincidirá cualquier número igual o superior.

Ejemplo:listed_count:10

Además, se puede especificar un intervalo para coincidir con cualquier número dentro del intervalo dado.

Ejemplo:listed_count:10..100
url_title:Alias disponible: within_url_title:
Realiza una coincidencia de palabras clave o frases en los metadatos del título HTML de la URL expandida.

Ejemplo:url_title:nieve
url_description:Alias disponible: within_url_description:
Realiza una coincidencia de palabras clave o frases en los metadatos de la descripción expandida de la página.

Ejemplo:url_description:clima
url_contains:Hace coincidir Posts con URL que contengan literalmente la frase o palabra clave indicada. Para buscar patrones que incluyan signos de puntuación (p. ej., google.com), encierre 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 Post generado por la aplicación de origen indicada. El valor debe ser el nombre de la aplicación o la URL de la aplicación’la URL s. No se puede usar por sí sola.

Ejemplo:source:"X para iPhone"

Nota: Como desarrollador de App en X, los Posts creados programáticamente por tu aplicación mostrarán como fuente el Nombre y la URL del sitio web de tu aplicación configurados en tu configuración de App.Configuración de la App.
in_reply_to_tweet_id:Alias disponible: in_reply_to_status_id:
Entregar solo respuestas explícitas al Post especificado.

Ejemplo:in_reply_to_tweet_id:1539382664746020864
retweets_of_tweet_id:Alias disponible: retweets_of_status_id:
Entregue únicamente Retweets explícitos (o nativos) del Post especificado. Tenga en cuenta que el id de estado utilizado debe ser el id de un Post original y no de un Retweet.

Ejemplo:retweets_of_tweet_id:1539382664746020864