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 operadorOperadores 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 keywordIndependiente Coincide con una palabra clave en el cuerpo de la publicación (coincidencia tokenizada) pepsi OR cola OR "coca cola"emojiIndependiente 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"~NIndependiente 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:apito:Independiente Coincide con publicaciones que responden a un usuario específico to:XDevelopers OR to:apiretweets_of:Independiente Coincide con Retweets de un usuario específico retweets_of:XDevelopersfrom_affiliate_of:Independiente Coincide con publicaciones de afiliados de un usuario específico from_affiliate_of:XDevelopersto_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:snowurl_description:— Coincidencia de palabra clave en los metadatos de la descripción de la página expandida url_description:weatherurl_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:mdbio_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:seattleplace_country:Independiente Coincide con publicaciones que tienen un código de país place_country:US OR place_country:MXpoint_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:retweetRequiere conjunción Coincide con Retweets data @XDevelopers -is:retweetis:replyRequiere conjunción Coincide con respuestas from:XDevelopers is:replyis:quoteRequiere conjunción Coincide con Quote Tweets "sentiment analysis" is:quoteis:verifiedRequiere conjunción Coincide con publicaciones de autores verificados #nowplaying is:verified-is:nullcastRequiere conjunción Excluye publicaciones promocionales (debe ir negado) "mobile games" -is:nullcast
Operadores de tipo de contenido Operador Tipo Resumen Ejemplo has:hashtagsRequiere conjunción Coincide con publicaciones que contienen hashtags from:XDevelopers -has:hashtagshas:cashtagsRequiere conjunción Coincide con publicaciones que contienen cashtags #stonks has:cashtagshas:linksRequiere conjunción Coincide con publicaciones que contienen enlaces from:XDevelopers has:linkshas:mentionsRequiere conjunción Coincide con publicaciones que contienen menciones #nowplaying has:mentionshas:mediaRequiere conjunción Coincide con publicaciones que contienen medios (foto, GIF, video) (kittens OR puppies) has:mediahas:imagesRequiere conjunción Coincide con publicaciones que contienen imágenes #meme has:imageshas:video_linkRequiere conjunción Coincide con publicaciones con videos nativos de X #icebucketchallenge has:video_linkhas:geoRequiere 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:15lang: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:1000followers_count:— Coincide con publicaciones de usuarios cuyo número de seguidores esté en el rango indicado followers_count:1000..10000tweets_count:— Coincide con publicaciones de usuarios cuyo número de publicaciones esté en el rango indicado tweets_count:1000..10000following_count:— Coincide con publicaciones de usuarios cuyo número de seguidos esté en el rango indicado following_count:1000..10000listed_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:1539382664746020864retweets_of_tweet_id:— Coincide con Retweets de una publicación específica retweets_of_tweet_id:1539382664746020864source:— Coincide con publicaciones provenientes de una aplicación de origen específica source:"X for iPhone"
Operadores lógicos Operador Resumen Ejemplo OROR lógico entre expresiones cat OR dogEspacio (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 Embedding Los 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.XXRequiere 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:linksembedding:"natural disaster relief" embedding_threshold:0.45 has:mediaembedding:"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 amGriego elPortugués ptÁrabe arGuyaratí guRumano roArmenio hyHebreo iwRuso ruEuskera euHindi hiSerbio srBengalí bnHúngaro huChino simplificado zh-CNBúlgaro bgIndonesio inEslovaco skCatalán caItaliano itEsloveno slCroata hrJaponés jaEspañol esCheco csCanarés knSueco svDanés daCoreano koTamil taNeerlandés nlLetón lvTelugu teInglés enLituano ltTailandés thEstonio etMalayalam mlChino tradicional zh-TWFinés fiMaratí mrTurco trFrancés frNoruego noUcraniano ukAlemán dePersa faUrdu urGeorgiano kaPolaco plVietnamita 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
