Introducción a las reglas y consultas empresariales
OR en mayúsculas.
Cada regla puede tener hasta 2.048 caracteres de longitud, sin límites en el número de cláusulas positivas (elementos que quieres hacer coincidir o filtrar) y cláusulas negativas (elementos que quieres excluir y con los que no quieres hacer coincidir).
Creación de reglas y consultas
social
Aplicar AND a términos con espacio en blanco
Agregar otra palabra clave equivale a agregar otro requisito para encontrar coincidencias. Por ejemplo, esta regla solo coincidiría con actividades donde tanto “social” como “media” estén presentes en el texto, en cualquier orden: tener un espacio entre términos funciona como una lógica booleana AND. Si incluyes un AND explícito en tu regla, será rechazado por el endpoint de reglas.
social media
Aplicar OR a términos con OR en mayúsculas
En muchas situaciones, en realidad se necesita lógica booleana OR. Esto también se logra fácilmente. Ten en cuenta que el operador OR debe estar en mayúsculas y que un ‘or’ en minúsculas se tratará como una palabra clave normal.
social OR data
Negar términos
En otros escenarios quizá quieras excluir resultados con ciertas palabras clave (lógica booleana NOT). Por ejemplo, actividades con ‘happy’, pero excluyendo cualquier actividad con ‘birthday’ en el texto.
social -personality
Agrupación con paréntesis
Estos tipos de lógica se pueden combinar mediante agrupación con paréntesis y ampliarse a consultas mucho más complejas.
(social OR data) (academic OR research) -personality -information -university
Sin embargo, esto es solo el principio: aunque los ejemplos anteriores se basan simplemente en coincidencias tokenizadas de palabras clave, los productos enterprise también ofrecen operadores para realizar distintos tipos de coincidencia sobre el texto.
Coincidencia exacta
"social media research"
Coincidencia de subcadena
contains:info
Coincidencia por proximidad
"social media research"~3
Además, otros operadores te permiten filtrar en función de aspectos únicos de los datos sociales, más allá del texto.
El usuario que está publicando una Publicación
from:XDeveloeprs
Tweets geolocalizados en un radio de 10 millas de Pearl St. en Boulder, CO, Estados Unidos
point_radius:[-105.27346517 40.01924738 10.0mi]
Uniéndolo todo
Estos operadores se pueden combinar con filtros de texto utilizando los mismos tipos de lógica descritos anteriormente.
(social OR data) (academic OR research OR "social media research") point_radius:[-105.27346517 40.01924738 10.0mi] lang:en -personality -information -university
Sintaxis booleana
| Tipo de lógica | Sintaxis del operador | Descripción |
| AND | social data | Un espacio en blanco entre dos operadores da como resultado una lógica AND entre ellos. Coincide con actividades que contienen ambas palabras clave (“social”, “data”). No uses AND explícitamente en tu regla. Usa solo espacios en blanco. Un AND explícito se tratará como una palabra clave normal. |
| OR | social OR data | Para aplicar OR entre dos operadores, inserta un OR en mayúsculas, delimitado por espacios en blanco entre ellos. Coincide con actividades que contienen CUALQUIERA de las palabras clave (“social” OR “data”). Ten en cuenta que, si combinas la funcionalidad OR y AND en una sola regla, debes entender el orden de las operaciones descrito en nuestra sección “Order of operations”, y considerar agrupar operadores no negados usando paréntesis como se describe a continuación para asegurarte de que tu regla se comporte como esperas. Debes usar “OR” en mayúsculas en tu regla. La forma en minúsculas ‘or’ se tratará como una palabra clave normal. |
| NOT | social data -apple -android -phone | Inserta un carácter - inmediatamente delante del operador o grupo de operadores. La regla de ejemplo mostrada coincide con actividades que contienen la palabra clave “social”, pero excluye aquellas que contienen la palabra clave “data”. No se permiten OR negados cuando la regla solicitaría “todo en el firehose excepto la negación”. Por ejemplo, apple OR -ipad no es válido porque coincidiría con todas las actividades excepto aquellas que mencionan “ipad”. |
| Grouping | (social OR data) -XDeveloeprs -api | Los paréntesis alrededor de varios operadores crean un “grupo” funcional. Los grupos se pueden conectar a cláusulas de la misma manera que una cláusula individual mediante espacios en blanco (AND) u OR. Sin embargo, ten en cuenta que es una buena práctica no agrupar negaciones aplicando el signo de negación - a todo el grupo. En su lugar, debes negar cada operador individual, encadenándolos mediante espacios en blanco (AND). Por ejemplo, en lugar de usar -(iphone OR imac OR macbook), usa lo siguiente: -iphone -imac -macbook El agrupamiento es especialmente importante cuando una sola regla combina funcionalidad AND y OR, debido al orden de las operaciones utilizado para evaluar la regla. Consulta a continuación para obtener más detalles. |
has:hashtags indica “Quiero actividades que contengan hashtags”.
Los operadores negativos definen lo que quieres excluir de los resultados y se crean utilizando la lógica booleana NOT descrita anteriormente. Por ejemplo, -has:hashtags indica “Excluye cualquier actividad que contenga hashtags, incluso si por lo demás coincide con mi regla”.
Los productos de operadores Premium no tienen restricciones en el número de cláusulas positivas y negativas, sujeto a una longitud máxima de 2.048 caracteres.
Orden de operaciones
- Primero se combinan los operadores conectados por lógica AND
- Luego se aplican los operadores conectados con lógica OR
apple OR iphone ipadse evaluaría comoapple OR (iphone ipad)ipad iphone OR androidse evaluaría como(iphone ipad) OR android
(apple OR iphone) ipadiphone (ipad OR android)
Signos de puntuación, diacríticos y distinción entre mayúsculas y minúsculas
Diacr**í**tica o el hashtag #cumplea**ñ**os coincidirá con “Diacrítica” o “#cumpleaños” pero no con “Diacritica” o “#cumpleanos” sin la tilde en la í o la eñe.
Los caracteres con acentos o diacríticos se tratan igual que los caracteres normales y no se consideran límites de palabra. Por ejemplo, una regla de cumpleaños solo coincidiría con actividades que contengan la palabra cumpleaños y no coincidiría con actividades que contengan cumplea, cumplean u os.
Todos los operadores se evalúan sin distinguir entre mayúsculas y minúsculas. Por ejemplo, la regla Cat coincidirá con todo lo siguiente: “cat”, “CAT”, “Cat”.
Como se describe en nuestra página “Matching rules”, cada regla puede crearse con una etiqueta. Estas etiquetas no tienen ningún efecto sobre el filtrado, pero se pueden usar para crear agrupaciones lógicas de reglas dentro de tu App. Cada regla puede tener solo una etiqueta, con un máximo de 255 caracteres. Las etiquetas se incluyen con la regla en formato JSON en el momento de su creación mediante la API, como se describe en nuestra página “Matching rules”.
Poner reglas en formato JSON
{"value":"insert_rule_here"}
Reglas con comillas dobles
Si la regla contiene caracteres de comillas dobles (") asociados con coincidencias exactas u otros operadores, deben escaparse usando una barra invertida para distinguirlos de la estructura del formato JSON.
"social data" @XDevelopers
La regla en formato JSON sería:
{"value":"\"social data\" @XDevelopers"}
Reglas con literales de cadena con comillas dobles
Para incluir un carácter de comillas dobles como literal de cadena dentro de una coincidencia exacta, debe escaparse dos veces. Por ejemplo, para una regla que coincida con la frase exacta “Toys “R” Us”, incluyendo las comillas dobles alrededor de “R”, la representación en texto plano se vería de la siguiente manera:
"Toys \"R\" Us"
Al convertir esto a formato JSON, debes usar la siguiente estructura:
{"value":"\"Toys \\\"R\\\" Us\""}
Reglas con Tags
Para incluir una tag opcional con tu regla, como se describió arriba, simplemente incluye un campo tag adicional con el valor de la regla.
{"value":"\"social data\" @XDevelopers","tag":"RULE-TAG-01"}
Formato para solicitudes de API
Al agregar o eliminar reglas del stream a través de la API, varias reglas en formato JSON deben estar delimitadas por comas y envueltas en un array JSON rules, como se muestra a continuación:
{"rules":[{"value":"from:XDevelopers"},{"value":"\social data\" @XDevelopers","tag":"RULE-TAG-01"}]}
Operadores que coinciden con Tweets citados
KeywordsPhrasesProximity#hashtags@mentions$cashtagsurl:url_contains:has:linkshas:mentionshas:hashtagshas:mediahas:symbolsis:quoteis:reply
Operadores de Enterprise
| Operador | Descripción |
|---|---|
| Palabra clave | Hace coincidir una palabra clave presente en el cuerpo de texto o la URL de una Publicación. Las palabras clave deben comenzar con un dígito (0-9) o con cualquier carácter que no sea de puntuación. La coincidencia de palabras clave se tokeniza; es decir, la palabra clave se compara con el texto tokenizado del cuerpo de la Publicación. Para cadenas que contengan signos de puntuación (por ejemplo, “coca-cola”), usa una “coincidencia de frase exacta” entre comillas. Ejemplo: (social OR pizza OR wildfire) -planet |
| emoji | Coincide con un emoji dentro del cuerpo de una Publicación, mediante una coincidencia tokenizada basada en la puntuación, los símbolos/emojis y los caracteres separadores. Si un emoji tiene una variante, utiliza comillas para coincidencias exactas. Ejemplo: (🍕 OR 💜 OR 🐢) -🤖 |
| ”coincidencia exacta de frase” | Coincide con una frase exacta en el cuerpo de una Publicación. La puntuación se considera como espacio en blanco. Ejemplo: ("social media" OR "developer.x.com" OR "wildfire911" OR "coca-cola") -"planet earth" |
| # | Coincide con cualquier Publicación que tenga el hashtag especificado. Es una coincidencia exacta, lo que significa que #2016 coincidirá con Publicaciones que tengan #2016 pero no con #2016election.Ejemplo: (#social OR #pizza OR #2016election) -#planet |
| @ | Coincide con cualquier publicación que mencione el nombre de usuario especificado. Ejemplo: (@XDevelopers OR @api OR @twittereng) -@jack |
| ”keyword1 keyword2”~N | Operador de proximidad que encuentra 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 no pueden estar separadas por más de N-2 tokens. N no puede ser mayor que 6. Ejemplo: "social media"~5 OR "API"~3 |
| contains: | Coincidencia de subcadenas en Publicaciones con la subcadena especificada en el cuerpo, independientemente de la tokenización. Utiliza comillas dobles para subcadenas con espacios en blanco o signos de puntuación. Ejemplo: (contains:social OR contains:"wikipedia.com") -contains:"buy now" |
| from: | Coincide con cualquier Publicación de un usuario específico mediante el id numérico de cuenta de X o el nombre de usuario (sin @).Ejemplo: (from:2244994945 OR from:api OR from:twittereng) -from:jack |
| to: | Coincide con cualquier Publicación que responda a un usuario específico mediante el ID numérico de la cuenta de X o el nombre de usuario (sin @).Ejemplo: (to:2244994945 OR to:api OR to:twittereng) -to:jack |
| url: | Realiza una coincidencia tokenizada (palabra o frase clave) en las URL expandidas de una Publicación. Ejemplo: @XDevelopers url:"developer.x.com" |
| url_title: | Realiza una coincidencia de palabra o frase clave en los metadatos del título HTML de la URL expandida. Disponible solo con PowerTrack y Historical PowerTrack. |
| url_description: | Realiza una coincidencia de palabra clave o frase en los metadatos de la descripción de la página expandida. Disponible solo con PowerTrack y Historical PowerTrack. |
| url_contains: | Coincide con Publicaciones cuya URL contiene la frase o palabra clave especificada. Entrecomilla los términos de búsqueda que incluyan signos de puntuación. Ejemplo: (url_contains:"developer.x.com" OR url_contains:wildfire) -url_contains:reddit |
| bio: | Coincide con una palabra clave o frase dentro de la biografía del usuario de una Publicación. Se trata de una coincidencia tokenizada dentro del campo ‘description’ del User object. Ejemplo: (bio:engineer OR bio:"wordpress.com" OR bio:🚀) -bio:trollNota: Solo está disponible con PowerTrack y Historical PowerTrack. |
| bio_name: | Coincide con una palabra clave en el nombre de perfil del usuario de una Publicación. Se trata de una coincidencia tokenizada dentro del campo “name” de un usuario en el User object. Nota: Solo disponible con PowerTrack y Historical PowerTrack. |
| bio_location: | Coincide con Publicaciones en las que la ubicación del objeto User contiene la palabra clave o frase especificada. Este operador realiza una coincidencia tokenizada, similar a las reglas de palabras clave normales en el cuerpo del mensaje. Esta ubicación forma parte del objeto User, y es la ubicación ‘principal’ de la cuenta. Nota: Solo disponible con PowerTrack y Historical PowerTrack. |
| statuses_count: | Coincide con Publicaciones cuando el autor ha publicado una cantidad de estados dentro del rango dado. Si se especifica un solo número, coincidirá cualquier número igual o superior. Se puede especificar un rango para que coincida cualquier número dentro del mismo (por ejemplo, statuses_count:1000..10000).Ejemplo: to:api statuses_count:10Nota: Solo disponible con PowerTrack y Historical PowerTrack. |
| followers_count: | Coincide con Publicaciones cuando el autor tiene un número de seguidores dentro del rango indicado. Si se especifica un solo número, coincidirá cualquier número igual o superior. Se puede especificar un rango para hacer coincidir cualquier número dentro de dicho rango (por ejemplo, followers_count:1000..10000).Nota: Solo disponible con PowerTrack y Historical PowerTrack. |
| friends_count: | Coincide con Publicaciones cuando el autor tiene una cantidad de amigos (el número de usuarios a los que sigue) dentro del rango dado. Si se especifica un solo número, cualquier número igual o superior coincidirá. Se puede especificar un rango para que coincida con cualquier número dentro de ese rango (por ejemplo, friends_count:1000..10000).Nota: Solo disponible con PowerTrack y Historical PowerTrack. |
| listed_count: | Coincide con Publicaciones cuando el autor ha sido incluido en listas de X un cierto número de veces dentro del intervalo indicado. Si se especifica un solo número, coincidirá cualquier número igual o superior. Se puede especificar un intervalo para que coincida cualquier número dentro de ese intervalo (por ejemplo, listed_count:10..100).Nota: Solo disponible con PowerTrack y PowerTrack histórico. |
| $ | Coincide con cualquier Publicación que incluya la entidad «cashtag» especificada. Ejemplo: ($TWTR OR $TSLA OR $BRK.A) -$FNota: El operador de cashtag se basa en la extracción de la entidad symbols de X para identificar cashtags, en lugar de extraerlos directamente del cuerpo de la Publicación. |
| retweets_of: | Coincide con Publicaciones que son Retweets de un usuario especificado. Acepta tanto nombres de usuario como ids numéricos de cuentas de X (NO ids de estado de Publicación). Ejemplo: (retweets_of:2244994945 OR retweets_of:api OR retweets_of:twittereng) -retweets_of:jack |
| retweets_of_status_id: | Devuelve solo los Retweets explícitos de la Publicación especificada. Utiliza el id de una Publicación original y no el de un Retweet. Ejemplo: retweets_of_status_id:1293593516040269825Nota: Solo disponible con PowerTrack y Historical PowerTrack. |
| in_reply_to_status_id: | Devuelve solo respuestas explícitas a la Publicación especificada. Ejemplo: in_reply_to_status_id:1293593516040269825Nota: Solo disponible con PowerTrack y Historical PowerTrack. |
| sample: | Devuelve una muestra aleatoria de Publicaciones que cumplen una regla. El porcentaje de muestreo debe ser un entero entre 1 y 100. El operador reduce el alcance al X%, luego se aplica la regla/filtro a ese subconjunto muestreado. Ejemplo: #happybirthday sample:5"happy birthday"~5 sample:80Nota: Solo disponible con PowerTrack y Historical PowerTrack. |
| source: | Coincide con cualquier Publicación generada por la aplicación de origen especificada. El valor puede ser el nombre o la URL de la aplicación. Ejemplo: #happybirthday source:"X for iPhone""This is a test X from my TestingApp" source:MyTestAppNameNota: El operador source busca en el atributo de origen de la Publicación y no se puede utilizar por sí solo. |
| lang: | Coincide con Publicaciones clasificadas por X como pertenecientes a un idioma en particular. Actualmente, las Publicaciones se clasifican en un solo idioma, por lo que hacer coincidir varios idiomas no devuelve resultados. No se recomienda usarlo por sí solo. |
| Amárico: am | Alemán: de | Malayalam: ml | Eslovaco: sk |
| Árabe: ar | Griego: el | Maldivo: dv | Esloveno: sl |
| Armenio: hy | Guyaratí: gu | Maratí: mr | Kurdo sorani: ckb |
| Vasco: eu | Criollo haitiano: ht | Nepalí: ne | Español: es |
| Bengalí: bn | Hebreo: iw | Noruego: no | Sueco: sv |
| Bosnio: bs | Hindi: hi | Oriya: or | Tagalo: tl |
| Búlgaro: bg | Hindi latinizado: hi-Latn | Panyabí: pa | Tamil: ta |
| Birmano: my | Húngaro: hu | Pastún: ps | Telugu: te |
| Croata: hr | Islandés: is | Persa: fa | Tailandés: th |
| Catalán: ca | Indonesio: in | Polaco: pl | Tibetano: bo |
| Checo: cs | Italiano: it | Portugués: pt | Chino tradicional: zh-TW |
| Danés: da | Japonés: ja | Rumano: ro | Turco: tr |
| Neerlandés: nl | Canarés: kn | Ruso: ru | Ucraniano: uk |
| Inglés: en | Jemer: km | Serbio: sr | Urdu: ur |
| Estonio: et | Coreano: ko | Chino simplificado: zh-CN | Uigur: ug |
| Finés: fi | Lao: lo | Sindhi: sd | Vietnamita: vi |
| Francés: fr | Letón: lv | Cingalés: si | Galés: cy |
| Georgiano: ka | Lituano: lt |
| Operador | Descripción |
|---|---|
| place | Coincide con Publicaciones etiquetadas con la ubicación especificada o el ID de lugar de X. Los nombres de lugares con varias palabras deben ir entre comillas. Ejemplo: (place:London OR place:"Great Britain") -place:USAplace:fd70c22040963ac7Nota: Consulta el endpoint público de la API GET geo/search para saber cómo obtener los ID de lugar de X. Nota: No coincidirá con Retweets ni con Quote Tweets, ya que los lugares de los Retweets están asociados a la Publicación original. |
| place_country | Coincide con las Publicaciones en las que el código de país asociado a un lugar/ubicación etiquetado coincide con el código ISO alfa-2 de dos caracteres proporcionado. Ejemplo: place_country:GB OR place_country:AU OR place_country:CANota: No coincidirá con Retweets o Tweets citados, ya que los lugares de los Retweets se adjuntan a la Publicación original. Códigos ISO válidos: ISO 3166-1 alpha-2. |
| point_radius:[lon lat radius] | Coincide con la ubicación exacta (x, y) de la Publicación o con un polígono geográfico de “Place” dentro del radio definido. * Radio: < 25mi * Unidades admitidas: mi, km * Longitud: ±180 * Latitud: ±90 Las coordenadas están en grados decimales. Los argumentos van entre corchetes y separados por espacios. Ejemplo: point_radius:[-105.27346517 40.01924738 0.5mi]Ejemplo: point_radius:[2.355128 48.861118 16km]Nota: No coincidirá con Retweets ni Tweets citados. |
| bounding_box:[west_long south_lat east_long north_lat] | Coincide con la ubicación exacta o con un polígono geográfico de “Place” totalmente contenido en una caja delimitadora. Los argumentos van entre corchetes y separados por espacios. Coordenadas: grados decimales (±180 long, ±90 lat). El ancho y el alto deben ser < 25 mi. Ejemplo: bounding_box:[-105.301758 39.964069 -105.178505 40.09455]Nota: No se aplicará a Retweets ni a Tweets citados. |
| profile_country | Devuelve las Publicaciones cuyo código de país de geolocalización del perfil del autor corresponde a un código ISO-3166-1-alpha-2 de dos letras. |
| profile_region | Coincide con el valor del campo “region” del enriquecimiento de geolocalización del perfil del autor, con una coincidencia exacta de la cadena completa. Usa comillas dobles para subcadenas que contengan espacios o signos de puntuación. Ejemplo: profile_region:"New York" |
| profile_locality | Coincide con el campo «locality» del enriquecimiento geográfico del perfil del autor mediante una coincidencia exacta de la cadena completa. Usa comillas dobles para las subcadenas que contengan espacios en blanco o signos de puntuación. Ejemplo: profile_locality:"San Francisco" |
| profile_subregion | Coincide con el campo “subRegion” del enriquecimiento geográfico del perfil del autor, que incluye condados o áreas metropolitanas específicos. Coincidencia exacta de la cadena completa. Ejemplo: profile_subregion:"Santa Clara County" |
| has:geo | Coincide con Publicaciones que contienen datos de geolocalización específicos de la Publicación de X, incluidos lat-long de geo o datos de ubicación de Place con un nombre visible y un polígono geográfico.Nota: Con la Search API, debe combinarse con operadores que no sean is: o has:. |
| has:profile_geo | Coincide con Publicaciones que tengan cualquier metadato de Profile Geo, independientemente de su valor. Alias disponible: has:derived_user_geo.Nota: Con la Search API, debe combinarse con operadores que no sean is: o has:. |
| has:links | Coincide con Publicaciones que tienen un enlace o contenido multimedia referenciado en el objeto “text” del payload, incluidos contenido multimedia y Tweets citados. Nota: Con la Search API, debe combinarse con operadores que no sean is: ni has:. |
| is:retweet | Devuelve solo retweets explícitos. Se puede negar para excluir retweets y devolver solo contenido original. Este operador busca solo Retweets propiamente dichos y no Tweets citados. Nota: Con la Search API, debe combinarse con operadores que no sean is: o has:. |
| is:reply | Devuelve solo respuestas explícitas. Puede usarse en forma negada para excluir respuestas. PowerTrack encuentra respuestas a Publicaciones originales, respuestas en Publicaciones citadas y respuestas en Retweets. La Search API solo encuentra respuestas a Publicaciones originales. Ejemplo: @XDevelopers -is:reply |
| is:quote | Devuelve únicamente Tweets citados o Publicaciones que hacen referencia a otra Publicación. Se puede negar para excluir los Tweets citados. Ejemplo: @XDevelopers is:quote |
| is:verified | Devuelve solo Publicaciones de autores verificados. Puede negarse para excluir Publicaciones de autores verificados. Ejemplo: @XDevelopers is:verified |
| has:mentions | Coincide con Publicaciones que mencionan a otro usuario de X. Nota: Cuando se usa con Search API, debe combinarse con operadores que no sean is: ni has:. |
| has:hashtags | Coincide con Publicaciones que contienen un hashtag. Nota: Con Search API, debe combinarse con operadores que no sean is: ni has:. |
| has:media | Coincide con Publicaciones que contienen una URL de contenido multimedia clasificada por X (por ejemplo, pic.x.com). Alias disponible: has:media_link.Nota: Con Search API, debe combinarse con operadores que no sean is: ni has:. |
| has:images | Coincide con Publicaciones que contienen una URL de contenido multimedia (p. ej., pic.x.com). Nota: Con Search API, debe combinarse con operadores que no sean is: ni has:. |
| has:videos | Coincide con Publicaciones que contienen videos nativos de X subidos a X. Alias disponible: has:video_link.Este operador no devuelve coincidencias para videos de YouTube, Periscope u otras plataformas de alojamiento de video. Nota: Con Search API, debe combinarse con operadores que no sean is: o has:. |
| has:symbols | Coincide con Publicaciones que contienen un símbolo cashtag (p. ej., $TWTR). Nota: Con la Search API, se debe combinar con operadores que no sean is: ni has:. |
Operadores según producto
Reglas y filtrado: Enterprise
| Operador | Producto | Descripción | Coincide con el elemento del payload |
|---|---|---|---|
| «coincidencia de frase exacta» | PowerTrack Search | Coincide con una frase exacta dentro del cuerpo de una Publicación. Los componentes que puedan traducirse en operadores de búsqueda se tratarán como palabras. En otras palabras: * "#hashtag" coincidirá con hashtag pero no con #hashtag (usa el operador de hashtag sin comillas para hacer coincidir hashtags reales) * "$TWTR" coincidirá con la palabra TWTR pero no con el cashtag $TWTR (usa el operador de cashtag sin comillas para hacer coincidir cashtags reales)Nota: en 30 Day Search y Full Archive Search (Enterprise y Premium), la puntuación no se tokeniza, sino que se trata como espacio en blanco. | text |
| @ | PowerTrack Search | Coincide con cualquier Publicación que mencione el nombre de usuario indicado. El valor puede ser el nombre de usuario (sin incluir el carácter @) o el id numérico del usuario (obtenido, por ejemplo, mediante el endpoint GET users/lookup). | entities.user_mentions |
| # | PowerTrack Search | Coincide con cualquier Publicación que tenga el hashtag indicado. Este operador realiza una coincidencia exacta. Por ejemplo, la regla #1989 coincidirá con Publicaciones que contengan exactamente el hashtag #1989, pero no con aquellas que tengan el hashtag #TaylorSwift1989.Nota: este operador se basa en la extracción de entidades de X para hacer coincidir hashtags, en lugar de extraer el hashtag del propio cuerpo del texto. Para obtener más detalles sobre los atributos JSON de las entidades, consulta X Entities. | entities.hashtags |
| $ | PowerTrack Search | Coincide con cualquier Publicación que contenga el cashtag especificado (donde el primer carácter del token es $).**Nota: **este operador se basa en la extracción de entidades de X para identificar enlaces, en lugar de extraer el enlace directamente del cuerpo de la Publicación. Para obtener más detalles sobre los atributos JSON de las entidades, consulta X Entities. | entities.symbols |
| bio: | PowerTrack | Alias disponible: user_bio: Coincide con una palabra clave (usando coincidencia tokenizada) o una frase dentro de la biografía del usuario de una Publicación. Usa comillas dobles para hacer coincidir una frase. En otras palabras: * bio:software engineer hará coincidir Publicaciones con la palabra clave engineer de usuarios que tengan la palabra software en su biografía* bio:"software engineer" hará coincidir cualquier Publicación de usuarios que tengan la frase software engineer en su biografía | user``.description |
| bio_location: | PowerTrack | Alias disponible: user_bio_location: Coincide con Publicaciones donde la ubicación del User object contiene la palabra clave especificada (usando coincidencia tokenizada) o una frase. Esta ubicación es una cadena no normalizada, generada por el usuario y de texto libre, y es distinta de la ubicación de una Publicación (cuando está disponible). | user.location |
| bio_name: | PowerTrack | Coincide con Publicaciones en las que el nombre del objeto User contiene la palabra clave especificada (mediante coincidencia tokenizada) o la frase. | user.name |
| bounding_box: | PowerTrack Search | Alias disponible: geo_bounding_box: Coincide con la ubicación exacta (long, lat) de la Publicación (cuando está presente) y con un polígono geográfico (cuando el Place está completamente contenido dentro de la región definida). * west_long y south_lat representan la esquina suroeste del bounding box, donde west-long es la longitud de ese punto y south_lat es la latitud. * east_long y north_lat representan la esquina noreste del bounding box, donde east_long es la longitud de ese punto y north_lat es la latitud. * El ancho y la altura del bounding box deben ser menores de 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 van entre corchetes, separados por espacios. Nota: los operadores que hacen coincidencia en place (geo de la Publicación) solo incluirán coincidencias de Publicaciones originales. Los Retweets no contienen datos de place. | place (solo en Publicaciones originales) |
| contains: | PowerTrack | Coincidencia por subcadena para Publicaciones que tienen la subcadena proporcionada en el cuerpo, independientemente de la tokenización. En otras palabras, realiza una coincidencia de subcadena pura y no tiene en cuenta los límites de palabra. Usa comillas dobles para hacer coincidir subcadenas que contengan espacios en blanco o signos de puntuación. | text |
| <emoji> | PowerTrack Search | Coincide con un emoji dentro del cuerpo de una Publicación. Se trata de una coincidencia basada en tokens, por lo que tu emoji se comparará con el texto tokenizado del cuerpo de la Publicación. La tokenización se basa en signos de puntuación, símbolos/emojis y caracteres del plano básico de Unicode de tipo separador. Por ejemplo, una Publicación con el texto “I like 🍕” se dividiría en los siguientes tokens: I, like, 🍕. Estos tokens se compararían luego con el emoji utilizado en tu regla. Nota: si un emoji tiene una variante, debes usar comillas dobles al agregarlo a una regla. | text |
| followers_count: | PowerTrack | Coincide con Publicaciones cuando el autor tiene una cantidad de seguidores que se encuentra dentro del rango indicado. * Un único número (por ejemplo, followers_count:42) coincidirá con cualquier número mayor o igual que el valor especificado.* Un rango (por ejemplo, followers_count:42..1337) coincidirá con cualquier número dentro del rango indicado. | user.followers_count |
| friends_count: | PowerTrack | Alias disponible: following_count: Coincide con Publicaciones cuando el autor tiene una cantidad de amigos (el número de usuarios a los que sigue) que se encuentra dentro del rango especificado. * Un solo número (por ejemplo, followers_count:42) coincidirá con cualquier número igual o mayor que el valor especificado.* Un rango (por ejemplo, followers_count:42..1337) coincidirá con cualquier número dentro del rango especificado. | user.friends_count |
| from: | PowerTrack Search | Coincide con cualquier Publicación de un usuario específico. El valor puede ser el nombre de usuario (sin el carácter @) o el id numérico del usuario (que se puede obtener, por ejemplo, a través del endpoint GET users/lookup). | user.id, user.id_str (si se usa el id de usuario)user.screen_name (si se usa el nombre de usuario) |
| has:geo | PowerTrack Search | Coincide con Publicaciones que tienen datos de geolocalización específicos de la Publicación proporcionados por X. Esto puede ser una coordenada «geo» de latitud-longitud o una «ubicación» representada como un Place de X, con el nombre visible correspondiente, polígono geográfico y otros campos. No se puede usar como operador independiente. Nota: los operadores que hacen coincidencia sobre place (geo de la Publicación) solo incluirán coincidencias de Publicaciones originales. Los Retweets no contienen ningún dato de place. | place (solo Tweets originales) |
| has:hashtags | PowerTrack Search | Coincide con Publicaciones que contienen al menos un hashtag. No puede usarse como operador independiente. | entities.hashtags |
| has:images | PowerTrack Search | Coincide con Publicaciones que contienen al menos una URL de imagen clasificada. No se puede usar como operador independiente. | entities.media |
| has:lang | PowerTrack | Coincide con Publicaciones que han sido clasificadas por X como correspondientes a un idioma en particular. Si una Publicación no ha sido clasificada, el operador no coincidirá. Actualmente, cada Publicación solo se clasifica como perteneciente a un idioma, por lo que combinar varios idiomas con AND no arrojará resultados. No se puede usar como un operador independiente. | lang cuando el valor no es und |
| has:links | PowerTrack Search | Este operador devuelve las Publicaciones que contienen enlaces en el cuerpo de la Publicación. No se puede usar por sí solo como operador. Nota: este operador depende de la extracción de entidades de X para identificar enlaces, en lugar de extraer el enlace directamente del cuerpo. Para obtener más detalles sobre los atributos JSON de las entidades, consulta X Entities. | entities.urls |
| has:media | PowerTrack Search | Alias disponible: has:media_link Coincide con Publicaciones que contengan al menos una URL de contenido multimedia clasificado. No se puede usar como operador independiente. | entities.media |
| has:mentions | PowerTrack Search | Coincide con las Publicaciones que mencionan a otro usuario de X. No se puede usar como operador independiente. | entities.user_mentions |
| has:profile_geo | PowerTrack Search | Alias disponible: has:derived_user_geo Coincide con Publicaciones que tienen cualquier metadato de Profile Geo, sin importar el valor específico. No se puede usar como operador independiente. | user.location |
| has:symbols | PowerTrack Enterprise | Coincide con las Publicaciones que contienen un símbolo de cashtag (por ejemplo, $TWTR).No se puede usar como operador independiente. | entities.symbols |
| has:videos | PowerTrack Search | Alias disponible: has:video_link Coincide con Publicaciones que contienen al menos una URL de contenido multimedia clasificada. No se puede usar como operador independiente. | entities.media |
| in_reply_to_status_id: | PowerTrack | Alias disponible: in_reply_to_tweet_id: Entregar únicamente respuestas explícitas a la Publicación especificada. | id, id_str de la Publicación de destino |
| is:quote | PowerTrack | Entrega Tweets citados explícitos que coincidan con una regla. También puede negarse ( -is:quote) para excluir de la entrega los Tweets citados que coincidan con una regla.No se puede usar como operador independiente. | is_quote_status (si es true) |
| is:reply | PowerTrack Search | Entregar solo las respuestas que coincidan con una regla. También se puede negar ( -is:reply) para excluir la entrega de respuestas que coincidan con la regla especificada.Con PowerTrack, este operador se aplica a: * Respuestas a una Publicación original * Respuestas en Publicaciones citadas * Respuestas en Retweets Cuando se usa con la Search API, este operador se aplica a las respuestas a una Publicación original, pero excluye las respuestas en Tweets citados y las respuestas en Retweets. Puedes usar estos operadores junto con is:retweet y is:quote para entregar solo respuestas a Publicaciones originales.No se puede usar como operador independiente con la Search API. Nota: con Premium, este operador no está disponible en entornos de desarrollo Sandbox. | Elementos de respuesta, p. ej. in_reply_to_status_id |
| is:retweet | PowerTrack Search | Entregar solo Retweets explícitos que coincidan con una regla. También se puede negar ( -is:retweet) para excluir de la entrega los Retweets que coincidan con una regla, de modo que solo se entregue contenido original.Este operador busca únicamente Retweets verdaderos (es decir, Retweets publicados usando el botón de Retweet). Los Tweets citados y las Publicaciones modificadas que no usen la funcionalidad de Retweet de X no serán considerados por este operador. No se puede usar como operador independiente. | Elementos de Retweet, por ejemplo retweeted_status |
| is:verified | PowerTrack Search | Devuelve solo las Publicaciones cuyo autor esté verificado por X. También se puede negar para excluir las Publicaciones cuyo autor esté verificado. No se puede usar como operador independiente. | user.verified |
| keyword | PowerTrack Search | Coincide con una palabra clave en el cuerpo de una Publicación. Se trata de una coincidencia tokenizada, lo que significa que tu cadena de palabra clave se comparará con el texto tokenizado del cuerpo de la Publicación. La tokenización se basa en signos de puntuación, símbolos/emojis y caracteres separadores del plano básico de Unicode. Por ejemplo, una Publicación con el texto “I like coca-cola” se dividiría en los siguientes tokens: I, like, coca, cola. A continuación, estos tokens se comparan con la cadena de palabra clave utilizada en tu regla. Para hacer coincidir cadenas que contengan signos de puntuación (por ejemplo, coca-cola), símbolos o caracteres separadores, debes usar un operador de coincidencia exacta de frase. | text |
| lang: | PowerTrack Search | Coincide con las Publicaciones que han sido clasificadas por X como pertenecientes a un idioma en particular (solo si y solo si la Publicación ha sido clasificada). Cada Publicación se clasificará con un solo idioma, por lo que combinar varios idiomas con AND no producirá resultados. Nota: si no se puede realizar ninguna clasificación de idioma, el resultado proporcionado es und (por indefinido).Este operador solo coincidirá con idiomas admitidos. Proporcionar cualquier otro valor (incluido und) hará que se ignore el operador (es decir, las Publicaciones no se filtrarán mediante este operador). La siguiente lista representa los idiomas actualmente admitidos y su identificador de idioma BCP 47 correspondiente:am amháricohu húngaropt portuguésar árabeis islandésro rumanohy armenioin indonesioru rusobn bengalíit italianosr serbiobg búlgaroja japonéssd sindhimy birmanokn kannadasi cingalészh chinokm jemersk eslovacocs checoko coreanosl eslovenoda danéslo laockb kurdo soraninl neerlandéslv letónes españolen ingléslt lituanosv suecoet estonioml malayalamtl tagalofi finésdv maldivota tamilfr francésmr maratíte téluguka georgianone nepalíth tailandésde alemánno noruegobo tibetanoel griegoor oriyatr turcogu guyaratípa panyabíuk ucranianoht haitianops pastúnur urduiw hebreofa persaug uigurhi hindipl polacovi vietnamitacy galés | lang cuando su valor no es und |
| listed_count: | PowerTrack | Alias disponible: user_in_lists_count: Coincide con Publicaciones cuando el número de veces que el autor ha sido incluido en Listas en X se encuentra dentro del rango indicado. * Un solo número (p. ej., listed_count:42) coincidirá con cualquier número igual o mayor que el valor especificado.* Un rango (p. ej., listed_count:42..1337) coincidirá con cualquier número dentro del rango dado. | user.listed_count |
| place_country: | PowerTrack Search | Coincide con las Publicaciones en las que el código de país asociado a un place/location etiquetado coincide con el código ISO alfa-2 indicado. Nota: los operadores que hagan coincidencias sobre place (geo de la Publicación) solo incluirán coincidencias de Publicaciones originales. Los Retweets no contienen ningún dato de place. | place (solo Publicaciones originales) |
| place: | PowerTrack Search | Coincide con Publicaciones etiquetadas con la ubicación especificada o con el X place ID. Los nombres de lugares con varias palabras deben ir entre comillas (por ejemplo, place:"San Francisco")Nota: los operadores que hacen coincidencia en place (geo de la Publicación) solo incluirán coincidencias de Publicaciones originales. Los Retweets no contienen ningún dato de ubicación. | place (solo en Publicaciones originales) |
| point_radius: | PowerTrack Search | Nota: los operadores que coinciden con place (Post geo) solo incluirán coincidencias de Publicaciones originales. Los Retweets no incluyen ningún dato de lugar. | place (solo publicaciones originales) |
| profile_bounding_box:[west_long south_lat east_long north_lat] | PowerTrack | Coincide con la ubicación exacta del usuario (long, lat) en el enriquecimiento Profile Geo, donde el Place está completamente contenido dentro de la región definida. * west_long y 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 y 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 la altura del cuadro delimitador deben ser inferiores a 25 millas * 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 incluyen entre corchetes, delimitados por espacios. Nota: los operadores que coinciden con place (Post geo) solo incluirán coincidencias de Publicaciones originales. Los Retweets no contienen datos de place. | user.derived.locations.geo.coordinates |
| profile_country: | PowerTrack Search | Coincidencia exacta en el código de país del enriquecimiento Profile Geo. Utiliza un conjunto normalizado de códigos de país de dos letras, basado en la especificación ISO-3166-1-alpha-2. Para ser concisos, este operador se proporciona en lugar de un operador para el campo de país del objeto de dirección. Nota: los operadores que hacen coincidir place (geolocalización de la Publicación) solo incluirán coincidencias de Publicaciones originales. Los Retweets no contienen datos de place. | user.derived.locations.country_code |
| profile_locality: | PowerTrack Search | Coincidencia exacta en el campo Locality del Profile Geo enrichment. Se trata de una coincidencia exacta de toda la cadena. No es necesario escapar caracteres con una barra invertida. Por ejemplo, si se quiere hacer coincidir algo con una barra, use one/two.Use comillas dobles para hacer coincidir subcadenas que contengan espacios en blanco o signos de puntuación, por ejemplo, profile_locality:"Lower East Side". | user.derived.locations.locality |
| profile_point_radius:[lon lat radius] | PowerTrack | Coincide con la Ubicación exacta (x,y) del Profile Geo enrichment del usuario. * Las unidades admitidas para el radio son millas (mi) y kilómetros (km). * El radio debe ser menor que 25 mi. * La longitud está en el intervalo ±180 * La latitud está en el intervalo ±90 * Todas las coordenadas están en grados decimales. * Los argumentos de la regla van entre corchetes y se separan por espacios. Nota: los operadores que hagan coincidencia en place (geo de la Publicación) solo incluirán coincidencias de Publicaciones originales. Los Retweets no contienen datos de place. | user.derived.locations.geo |
| profile_region: | PowerTrack Search | Coincidencia exacta con el campo Region del Profile Geo enrichment. Esta es una coincidencia exacta de la cadena completa. No es necesario escapar caracteres con una barra invertida. Por ejemplo, si quiere hacer coincidir algo que contenga una barra, utilice one/two.Utilice comillas dobles para hacer coincidir subcadenas que contengan espacios en blanco o signos de puntuación, por ejemplo, profile_locality:"New York". | user.derived.locations.region |
| profile_subregion: | PowerTrack | Coincidencia exacta en el campo Subregion del Profile Geo enrichment. Se trata de una coincidencia exacta de la cadena completa. No es necesario escapar caracteres con una barra invertida. Por ejemplo, si se quiere hacer coincidir algo que incluye una barra inclinada, usa one/two.Usa comillas dobles para hacer coincidir subcadenas que contengan espacios en blanco o signos de puntuación, por ejemplo, profile_locality:"Kings County". | user.derived.locations.sub_region |
| ”keyword1 keyword2”~N | PowerTrack Search | Generalmente denominado operador de proximidad, hace coincidir una Publicación en la que las palabras clave no estén a más de N tokens de distancia entre sí. Si las palabras clave están en orden inverso, no pueden estar a más de N-2 tokens de distancia entre sí. Se puede incluir cualquier número de palabras clave entre comillas. N no puede ser mayor que 6. | text |
| retweets_of_status_id: | PowerTrack | Alias disponible: retweets_of_tweet_id: Devuelve solo Retweets explícitos de la Publicación original especificada. | retweeted_status.id, retweeted_status.id_str |
| retweets_of: | PowerTrack Search | Alias disponible: retweets_of_user: Coincide con cualquier Publicación que sea un Retweet del usuario indicado. El valor puede ser el nombre de usuario (sin el carácter @) o el id numérico del usuario (que puede obtenerse, por ejemplo, a través del endpoint GET users/lookup). | retweeted_status.id (si está presente) |
| sample: | PowerTrack | 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 representarse mediante un número entero entre 1 y 100. Este operador se aplica a toda la regla y requiere que todos los términos unidos por OR se agrupen. Nota: el operador sample primero reduce el alcance del firehose al X %, luego la regla/filtro se aplica a ese subconjunto muestreado. Si estás utilizando, por ejemplo, sample:10, cada Publicación tiene un 10 % de probabilidad de estar en la muestra. Nota: el muestreo es determinista y obtendrás la misma muestra de datos en tiempo real que si recuperaras los datos de forma histórica. | |
| source: | PowerTrack | Coincide con cualquier Publicación generada por la App de origen especificada. El valor debe ser el nombre o la URL de la App. No se puede usar como un operador independiente. | source |
| statuses_count: | PowerTrack | Alias disponible: tweets_count: Coincide con Publicaciones cuando el autor ha publicado un número de estados que se encuentra dentro del rango especificado. * Un solo número (p. ej., statuses_count:42) coincide con cualquier número igual o mayor que el valor especificado.* Un rango (p. ej., statuses_count:42..1337) coincide con cualquier número dentro del rango especificado. | user``.statuses_count |
| to: | PowerTrack Search | Coincide con cualquier Publicación que sea una respuesta a un usuario específico. El valor puede ser el nombre de usuario (excluyendo el carácter @) o el identificador numérico del usuario (que puede obtenerse, por ejemplo, mediante el endpoint GET users/lookup). | text |
| url: | PowerTrack Search | Realiza una coincidencia basada en tokens en las URL expandidas de una Publicación. Los tokens y las frases que contengan signos de puntuación o caracteres especiales deben escribirse entre comillas dobles (por ejemplo, url:"/developer").Aunque por lo general no se recomienda, el operador también puede hacer coincidir un protocolo específico, escribiéndolo entre comillas dobles (por ejemplo, url:"https://developer.x.com"). | entities.urls.expanded_url |
| url_contains: | PowerTrack | Realiza una coincidencia de palabras clave o frases en el (nuevo) enriquecimiento de metadatos de título de URL expandida. | entities.urls.expanded_url |
| url_description: | PowerTrack | Alias disponible: within_url_description: Realiza una coincidencia de palabra o frase clave en el (nuevo) enriquecimiento de metadatos de descripción ampliada de la página. | entities.urls.unwound.description |
| url_title: | PowerTrack | Alias disponible: within_url_title: Realiza una búsqueda por palabra clave o frase en el (nuevo) enriquecimiento de metadatos del título de la URL expandida. | entities.urls.title |