Saltar al contenido principal

Introducción a las reglas y consultas empresariales

Los productos que utilizan operadores empresariales te proporcionan datos sociales basados en las reglas de filtrado que configures. Las reglas se componen de una o más “cláusulas”, donde una cláusula es una palabra clave, una frase exacta o uno de los muchos operadores empresariales. Antes de comenzar a crear reglas con operadores empresariales, asegúrate de revisar la sintaxis descrita a continuación, consultar la lista de operadores disponibles y comprender las restricciones a la hora de crear reglas. También debes asegurarte de comprender los matices de cómo se evalúan las reglas desde el punto de vista lógico, en la sección “Orden de operaciones”. Se pueden combinar varias cláusulas con lógica “and” y “or”. Ten en cuenta: La lógica “and” se especifica con un espacio entre cláusulas, mientras que la lógica “or” se especifica con un 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

Coincidencia de palabras clave Las coincidencias de palabras clave son similares a las consultas en una interfaz de búsqueda. Por ejemplo, la siguiente regla de operador enterprise coincidiría con actividades que tengan el término “social” en el cuerpo del texto. 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

Los ejemplos de la sección anterior utilizaron varios tipos de lógica booleana y agrupación. Consulta la tabla a continuación para obtener más detalles sobre la sintaxis y los requisitos de cada una.
Tipo de lógicaSintaxis del operadorDescripción
ANDsocial dataUn 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.
ORsocial OR dataPara 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.
NOTsocial 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 -apiLos 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.
Ten en cuenta que los operadores pueden ser positivos o negativos. Los operadores positivos definen lo que quieres incluir en los resultados. Por ejemplo, el operador 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

Al combinar la funcionalidad AND y OR en una misma regla, el siguiente orden de operaciones determinará cómo se interpreta tu regla.
  1. Primero se combinan los operadores conectados por lógica AND
  2. Luego se aplican los operadores conectados con lógica OR
Ejemplo:
  • apple OR iphone ipad se evaluaría como apple OR (iphone ipad)
  • ipad iphone OR android se evaluaría como (iphone ipad) OR android
Para eliminar la incertidumbre y asegurarte de que tus reglas se evalúen como está previsto, agrupa los términos con paréntesis cuando corresponda. Por ejemplo:
  • (apple OR iphone) ipad
  • iphone (ipad OR android)

Signos de puntuación, diacríticos y distinción entre mayúsculas y minúsculas

Si especificas una regla de palabra clave o hashtag con acentos o diacríticos para operadores empresariales, esta hará coincidir el texto de las Publicaciones respetando los diacríticos (en hashtags o palabras clave). Una regla con la palabra clave 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”.

Etiquetas de reglas de PowerTrack

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

Para agregar o eliminar una regla de un stream a través de la API, las reglas deben utilizar el formato JSON. Básicamente, esto requiere colocar cada regla en la siguiente estructura: {"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

Cuando uses la PowerTrack API y la Historical PowerTrack API, los siguientes operadores coincidirán con contenido tanto de la Publicación original que fue citada como del nuevo Tweet citado. Sin embargo, si estás usando la Search API, estos operadores solo coincidirán con el contenido del Tweet citado y no con ningún contenido de la Publicación original que fue citada.
  • Keywords
  • Phrases
  • Proximity
  • #hashtags
  • @mentions
  • $cashtags
  • url:
  • url_contains:
  • has:links
  • has:mentions
  • has:hashtags
  • has:media
  • has:symbols
  • is:quote
  • is:reply

Operadores de Enterprise

A continuación se muestran los operadores disponibles con PowerTrack y Historical PowerTrack. Un subconjunto de ellos está disponible con las APIs de búsqueda de 30 días y de archivo completo (Full Archive). Consulta esta tabla para ver una lista de operadores disponibles por producto. 
OperadorDescripción
Palabra claveHace 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
emojiCoincide 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”~NOperador 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:troll
Nota: 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:10
Nota: 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) -$F
Nota: 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:1293593516040269825
Nota: 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:1293593516040269825
Nota: 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:80
Nota: 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:MyTestAppName
Nota: 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.
La siguiente lista muestra los idiomas actualmente admitidos y su correspondiente identificador de idioma BCP 47:
Amárico: amAlemán: deMalayalam: mlEslovaco: sk
Árabe: arGriego: elMaldivo: dvEsloveno: sl
Armenio: hyGuyaratí: guMaratí: mrKurdo sorani: ckb
Vasco: euCriollo haitiano: htNepalí: neEspañol: es
Bengalí: bnHebreo: iwNoruego: noSueco: sv
Bosnio: bsHindi: hiOriya: orTagalo: tl
Búlgaro: bgHindi latinizado: hi-LatnPanyabí: paTamil: ta
Birmano: myHúngaro: huPastún: psTelugu: te
Croata: hrIslandés: isPersa: faTailandés: th
Catalán: caIndonesio: inPolaco: plTibetano: bo
Checo: csItaliano: itPortugués: ptChino tradicional: zh-TW
Danés: daJaponés: jaRumano: roTurco: tr
Neerlandés: nlCanarés: knRuso: ruUcraniano: uk
Inglés: enJemer: kmSerbio: srUrdu: ur
Estonio: etCoreano: koChino simplificado: zh-CNUigur: ug
Finés: fiLao: loSindhi: sdVietnamita: vi
Francés: frLetón: lvCingalés: siGalés: cy
Georgiano: kaLituano: lt
Ejemplo: (@XDevelopers OR to:XDevelopers) lang:es Nota: El operador de idioma se aplica al idioma específico de la Publicación determinado por X y establecido en el atributo lang de la Publicación. Consulte aquí para obtener más información sobre los atributos JSON de X Entities. Si no se puede realizar una clasificación de idioma para una Publicación, el valor lang de la Publicación se establecerá como ‘und’ (por indefinido).
OperadorDescripción
placeCoincide 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:USA
place:fd70c22040963ac7
Nota: 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_countryCoincide 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:CA
Nota: 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_countryDevuelve 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_regionCoincide 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_localityCoincide 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_subregionCoincide 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:geoCoincide 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_geoCoincide 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:linksCoincide 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:retweetDevuelve 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:replyDevuelve 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:quoteDevuelve ú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:verifiedDevuelve solo Publicaciones de autores verificados. Puede negarse para excluir Publicaciones de autores verificados.
Ejemplo: @XDevelopers is:verified
has:mentionsCoincide 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:hashtagsCoincide con Publicaciones que contienen un hashtag.
Nota: Con Search API, debe combinarse con operadores que no sean is: ni has:.
has:mediaCoincide 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:imagesCoincide 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:videosCoincide 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:symbolsCoincide 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

Todos los operadores de Enterprise están disponibles con las API de PowerTrack e Historical PowerTrack. Sin embargo, solo un subconjunto de operadores está disponible en las API de Enterprise Search, como se indica en esta página. Las etiquetas de color azul oscuro indican qué operadores están disponibles para distintos productos de Enterprise: PowerTrack Search
OperadorProductoDescripciónCoincide 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:PowerTrackAlias 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:PowerTrackAlias 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:PowerTrackCoincide 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:PowerTrackCoincidencia 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:PowerTrackCoincide 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:PowerTrackAlias 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.iduser.id_str (si se usa el id de usuario)

user.screen_name (si se usa el nombre de usuario)
has:geoPowerTrack

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:hashtagsPowerTrack

Search
Coincide con Publicaciones que contienen al menos un hashtag.

No puede usarse como operador independiente.
entities.hashtags
has:imagesPowerTrack

Search
Coincide con Publicaciones que contienen al menos una URL de imagen clasificada.

No se puede usar como operador independiente.
entities.media
has:langPowerTrackCoincide 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:linksPowerTrack

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:mediaPowerTrack

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:mentionsPowerTrack

Search
Coincide con las Publicaciones que mencionan a otro usuario de X.

No se puede usar como operador independiente.
entities.user_mentions
has:profile_geoPowerTrack

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:symbolsPowerTrack

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:videosPowerTrack

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:PowerTrackAlias 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:quotePowerTrackEntrega 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:replyPowerTrack

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:retweetPowerTrack

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:verifiedPowerTrack

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
keywordPowerTrack

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árico

hu húngaro

pt portugués

ar árabe

is islandés

ro rumano

hy armenio

in indonesio

ru ruso

bn bengalí

it italiano

sr serbio

bg búlgaro

ja japonés

sd sindhi

my birmano

kn kannada

si cingalés

zh chino

km jemer

sk eslovaco

cs checo

ko coreano

sl esloveno

da danés

lo lao

ckb kurdo sorani

nl neerlandés

lv letón

es español

en inglés

lt lituano

sv sueco

et estonio

ml malayalam

tl tagalo

fi finés

dv maldivo

ta tamil

fr francés

mr maratí

te télugu

ka georgiano

ne nepalí

th tailandés

de alemán

no noruego

bo tibetano

el griego

or oriya

tr turco

gu guyaratí

pa panyabí

uk ucraniano

ht haitiano

ps pastún

ur urdu

iw hebreo

fa persa

ug uigur

hi hindi

pl polaco

vi vietnamita

cy galés
lang cuando su valor no es und
listed_count:PowerTrackAlias 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]PowerTrackCoincide 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]PowerTrackCoincide 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:PowerTrackCoincidencia 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”~NPowerTrack

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:PowerTrackAlias 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:PowerTrackDevuelve 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:PowerTrackCoincide 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:PowerTrackAlias 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:PowerTrackRealiza 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:PowerTrackAlias 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:PowerTrackAlias 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