Operadores de Filtered Stream

Esta página proporciona una lista completa de los operadores disponibles al crear reglas para Filtered Stream.

Descripción general

Los operadores se utilizan para coincidir con atributos específicos de las publicaciones. Hay dos tipos:

Operadores independientes — Pueden usarse solos o junto con cualquier otro operador
Operadores que requieren conjunción — Deben usarse con al menos un operador independiente

La mayoría de los operadores están disponibles tanto en Pay-per-use como en Enterprise. Algunos operadores avanzados (como el de embedding semántico) requieren Enterprise con acceso a un nivel adicional.

Operadores de palabras clave y frases

Operador	Tipo	Resumen	Ejemplo
`keyword`	Independiente	Coincide con una palabra clave en el cuerpo de la publicación (coincidencia tokenizada)	`pepsi OR cola OR "coca cola"`
`emoji`	Independiente	Coincide con un emoji en el cuerpo de la publicación	`(😃 OR 😡) 😬`
`"exact phrase"`	Independiente	Coincide con la frase exacta en el cuerpo de la publicación	`("X API" OR #v2) -"filtered stream"`
`"keyword1 keyword2"~N`	Independiente	Coincidencia por proximidad — palabras clave dentro de N tokens entre sí (máximo N=6)	`"social media"~5`

Operadores de entidades

Operador	Tipo	Resumen	Ejemplo
`#`	Independiente	Coincide con publicaciones que contienen un hashtag (coincidencia exacta)	`#thankunext #fanart`
`@`	Independiente	Coincide con publicaciones que mencionan un nombre de usuario	`(@XDevelopers OR @api) -@x`
`$`	Independiente	Coincide con publicaciones que contienen un cashtag	`$twtr OR @XDevelopers -$fb`

Operadores de usuario

Operador	Tipo	Resumen	Ejemplo
`from:`	Independiente	Coincide con publicaciones de un usuario específico	`from:XDevelopers OR from:api`
`to:`	Independiente	Coincide con publicaciones que responden a un usuario específico	`to:XDevelopers OR to:api`
`retweets_of:`	Independiente	Coincide con Retweets de un usuario específico	`retweets_of:XDevelopers`
`from_affiliate_of:`	Independiente	Coincide con publicaciones de afiliados de un usuario específico	`from_affiliate_of:XDevelopers`
`to_affiliate_of:`	Independiente	Coincide con publicaciones que responden a afiliados de un usuario específico	`to_affiliate_of:XDevelopers`

Operadores de URL

Operador	Tipo	Resumen	Ejemplo
`url:`	Independiente	Coincidencia tokenizada en la URL (coincide con los campos `url` o `expanded_url`)	`url:"https://developer.x.com"`
`url_title:`	—	Coincidencia de palabra clave en los metadatos del título HTML de la URL expandida	`url_title:snow`
`url_description:`	—	Coincidencia de palabra clave en los metadatos de la descripción de la página expandida	`url_description:weather`
`url_contains:`	—	Coincidencia literal con el contenido de la URL	`url_contains:photos`

Operadores de contexto y entidades

Operador	Tipo	Resumen	Ejemplo
`context:`	Independiente	Coincide con publicaciones con un par específico de dominio/entidad	`context:10.799022225751871488` o `context:47.*`
`entity:`	Independiente	Coincide con publicaciones con un valor de cadena de entidad específico	`entity:"Michael Jordan"`
`conversation_id:`	Independiente	Coincide con publicaciones en un hilo de conversación	`conversation_id:1334987486343299072`

Operadores de perfil de usuario

Operador	Tipo	Resumen	Ejemplo
`bio:`	Independiente	Coincide con una palabra clave en la biografía del autor de la publicación	`bio:developer OR bio:"data engineer"`
`bio_name:`	Independiente	Coincide con una palabra clave en el nombre del autor de la publicación	`bio_name:phd OR bio_name:md`
`bio_location:`	Independiente	Coincide con una palabra clave en la ubicación del autor de la publicación	`bio_location:"big apple" OR bio_location:nyc`

Operadores de ubicación

Operador	Tipo	Resumen	Ejemplo
`place:`	Independiente	Coincide con publicaciones etiquetadas con una ubicación	`place:"new york city" OR place:seattle`
`place_country:`	Independiente	Coincide con publicaciones que tienen un código de país	`place_country:US OR place_country:MX`
`point_radius:`	Independiente	Coincide con publicaciones dentro de un radio alrededor de un punto	`point_radius:[2.355128 48.861118 16km]`
`bounding_box:`	Independiente	Coincide con publicaciones dentro de un cuadro delimitador	`bounding_box:[-105.301758 39.964069 -105.178505 40.09455]`

Operadores de tipo de publicación

Operador	Tipo	Resumen	Ejemplo
`is:retweet`	Requiere conjunción	Coincide con Retweets	`data @XDevelopers -is:retweet`
`is:reply`	Requiere conjunción	Coincide con respuestas	`from:XDevelopers is:reply`
`is:quote`	Requiere conjunción	Coincide con Quote Tweets	`"sentiment analysis" is:quote`
`is:verified`	Requiere conjunción	Coincide con publicaciones de autores verificados	`#nowplaying is:verified`
`-is:nullcast`	Requiere conjunción	Excluye publicaciones promocionales (debe ir negado)	`"mobile games" -is:nullcast`

Operadores de tipo de contenido

Operador	Tipo	Resumen	Ejemplo
`has:hashtags`	Requiere conjunción	Coincide con publicaciones que contienen hashtags	`from:XDevelopers -has:hashtags`
`has:cashtags`	Requiere conjunción	Coincide con publicaciones que contienen cashtags	`#stonks has:cashtags`
`has:links`	Requiere conjunción	Coincide con publicaciones que contienen enlaces	`from:XDevelopers has:links`
`has:mentions`	Requiere conjunción	Coincide con publicaciones que contienen menciones	`#nowplaying has:mentions`
`has:media`	Requiere conjunción	Coincide con publicaciones que contienen medios (foto, GIF, video)	`(kittens OR puppies) has:media`
`has:images`	Requiere conjunción	Coincide con publicaciones que contienen imágenes	`#meme has:images`
`has:video_link`	Requiere conjunción	Coincide con publicaciones con videos nativos de X	`#icebucketchallenge has:video_link`
`has:geo`	Requiere conjunción	Coincide con publicaciones que contienen datos de geolocalización	`recommend #paris has:geo`

Operadores de muestreo e idioma

Operador	Tipo	Resumen	Ejemplo
`sample:`	Requiere conjunción	Devuelve una muestra aleatoria por porcentaje (1-100)	`#nowplaying @spotify sample:15`
`lang:`	Requiere conjunción	Coincide con publicaciones clasificadas en un idioma específico	`recommend #paris lang:en`

Operadores de métricas de usuario

Operador	Tipo	Resumen	Ejemplo
`min_followers:`	—	Coincide con publicaciones de usuarios con al menos el número especificado de seguidores	`min_followers:1000`
`followers_count:`	—	Coincide con publicaciones de usuarios cuyo número de seguidores esté en el rango indicado	`followers_count:1000..10000`
`tweets_count:`	—	Coincide con publicaciones de usuarios cuyo número de publicaciones esté en el rango indicado	`tweets_count:1000..10000`
`following_count:`	—	Coincide con publicaciones de usuarios cuyo número de seguidos esté en el rango indicado	`following_count:1000..10000`
`listed_count:`	—	Coincide con publicaciones de usuarios incluidos en el número especificado de Listas	`listed_count:10..100`

Operadores de referencia de publicación

Operador	Tipo	Resumen	Ejemplo
`in_reply_to_tweet_id:`	—	Coincide con respuestas a una publicación específica	`in_reply_to_tweet_id:1539382664746020864`
`retweets_of_tweet_id:`	—	Coincide con Retweets de una publicación específica	`retweets_of_tweet_id:1539382664746020864`
`source:`	—	Coincide con publicaciones provenientes de una aplicación de origen específica	`source:"X for iPhone"`

Operadores lógicos

Operador	Resumen	Ejemplo
`OR`	OR lógico entre expresiones	`cat OR dog`
Espacio (AND)	AND lógico entre expresiones	`cat dog` (ambos requeridos)
`()`	Agrupación para expresiones complejas	`(cat OR dog) -is:retweet`
`-`	Negación/exclusión	`cat -grumpy`

Operadores de embedding

Solo Enterprise — Se requiere el nivel EmbeddingLos operadores embedding: y embedding_threshold: solo están disponibles en cuentas Enterprise aprovisionadas con acceso al nivel Embedding para Filtered Stream. En niveles no compatibles, la creación de reglas se rechazará con un error de “operador no disponible”. Comunícate con tu representante de cuenta para habilitarlo.

Estos operadores utilizan un modelo de embedding neuronal para coincidir con publicaciones por similitud semántica con una consulta, en lugar de requerir coincidencias exactas de palabras clave.

Operador	Tipo	Resumen	Ejemplo
`embedding:"query"`	Independiente	Coincide con publicaciones semánticamente similares a la consulta. Las consultas con varias palabras deben ir entre comillas.	`embedding:"climate change policy"`
`embedding_threshold:X.XX`	Requiere conjunción	Similitud coseno mínima para una coincidencia (0.0–1.0). El valor predeterminado es `0.3`. Usa valores entre 0.3 y 0.6.	`embedding:"cryptocurrency regulation" embedding_threshold:0.45`

Requisitos y notas clave

embedding_threshold: no puede ser el único operador en una regla. Combínalo con embedding: (u otro operador independiente).
No niegues embedding: (por ejemplo, -embedding:"..." no es compatible).
Las consultas en lenguaje natural más largas y descriptivas producen mejores resultados que las palabras clave cortas.
El procesamiento de las consultas de embedding es asíncrono — las reglas recién creadas pueden tardar unos segundos antes de comenzar a coincidir.
Cuando una publicación coincide mediante una regla de embedding, las entradas matching_rules del payload entregado contendrán embedding_similarity y embedding_threshold (consulta Asociar publicaciones a reglas).

Reglas de ejemplo:

embedding:"electric vehicle announcements" lang:en -is:retweet has:links
embedding:"natural disaster relief" embedding_threshold:0.45 has:media
embedding:"renewable energy" embedding_threshold:0.4 OR embedding:"solar power investment"

Idiomas admitidos

El operador lang: admite estos códigos de idioma BCP 47:

Idioma	Código	Idioma	Código	Idioma	Código
Amárico	`am`	Griego	`el`	Portugués	`pt`
Árabe	`ar`	Guyaratí	`gu`	Rumano	`ro`
Armenio	`hy`	Hebreo	`iw`	Ruso	`ru`
Euskera	`eu`	Hindi	`hi`	Serbio	`sr`
Bengalí	`bn`	Húngaro	`hu`	Chino simplificado	`zh-CN`
Búlgaro	`bg`	Indonesio	`in`	Eslovaco	`sk`
Catalán	`ca`	Italiano	`it`	Esloveno	`sl`
Croata	`hr`	Japonés	`ja`	Español	`es`
Checo	`cs`	Canarés	`kn`	Sueco	`sv`
Danés	`da`	Coreano	`ko`	Tamil	`ta`
Neerlandés	`nl`	Letón	`lv`	Telugu	`te`
Inglés	`en`	Lituano	`lt`	Tailandés	`th`
Estonio	`et`	Malayalam	`ml`	Chino tradicional	`zh-TW`
Finés	`fi`	Maratí	`mr`	Turco	`tr`
Francés	`fr`	Noruego	`no`	Ucraniano	`uk`
Alemán	`de`	Persa	`fa`	Urdu	`ur`
Georgiano	`ka`	Polaco	`pl`	Vietnamita	`vi`

Próximos pasos

Crear una regla

Aprende la sintaxis de las reglas y sus mejores prácticas

Introducción a Filtered Stream

Comienza con Filtered Stream

Gestionar desconexiones

Maneja desconexiones de streaming

Getting Started

Products

Fundamentals

Partners & Customers

Resources

Operadores de Filtered Stream

Descripción general

Operadores de palabras clave y frases

Operadores de entidades

Operadores de usuario

Operadores de URL

Operadores de contexto y entidades

Operadores de perfil de usuario

Operadores de ubicación

Operadores de tipo de publicación

Operadores de tipo de contenido

Operadores de muestreo e idioma

Operadores de métricas de usuario

Operadores de referencia de publicación

Operadores lógicos

Operadores de embedding

Requisitos y notas clave

Idiomas admitidos

Próximos pasos

Crear una regla

Introducción a Filtered Stream

Gestionar desconexiones

​Descripción general

​Operadores de palabras clave y frases

​Operadores de entidades

​Operadores de usuario

​Operadores de URL

​Operadores de contexto y entidades

​Operadores de perfil de usuario

​Operadores de ubicación

​Operadores de tipo de publicación

​Operadores de tipo de contenido

​Operadores de muestreo e idioma

​Operadores de métricas de usuario

​Operadores de referencia de publicación

​Operadores lógicos

​Operadores de embedding

​Requisitos y notas clave

​Idiomas admitidos

​Próximos pasos

Crear una regla

Introducción a Filtered Stream

Gestionar desconexiones

Descripción general

Operadores de palabras clave y frases

Operadores de entidades

Operadores de usuario

Operadores de URL

Operadores de contexto y entidades

Operadores de perfil de usuario

Operadores de ubicación

Operadores de tipo de publicación

Operadores de tipo de contenido

Operadores de muestreo e idioma

Operadores de métricas de usuario

Operadores de referencia de publicación

Operadores lógicos

Operadores de embedding

Requisitos y notas clave

Idiomas admitidos

Próximos pasos