Reglas y filtros: Enterprise

​

Introducción a las reglas y consultas de Enterprise

Los productos que utilizan operadores de Enterprise 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 puede ser una palabra clave, una frase exacta o uno de los muchos operadores de Enterprise. Antes de comenzar a crear reglas con operadores de Enterprise, asegúrate de revisar la sintaxis descrita a continuación, consultar la lista de operadores disponibles y comprender las restricciones al crear reglas. También debes comprender los matices de cómo se evalúan lógicamente las reglas, en la sección “Orden de operaciones”.

Se pueden combinar múltiples 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 OR en mayúsculas.

Cada regla puede tener hasta 2,048 caracteres de longitud, sin límites en la cantidad de cláusulas positivas (elementos que deseas hacer coincidir o filtrar) y cláusulas negativas (elementos que deseas excluir y no 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 de Enterprise coincidiría con actividades que contengan el término “social” en el cuerpo del texto.

social

Combinación de términos con espacio en blanco (AND)

Agregar otra palabra clave equivale a agregar otro requisito para encontrar coincidencias. Por ejemplo, esta regla solo coincidiría con actividades en las que tanto “social” como “media” estén presentes en el texto, en cualquier orden; dejar un espacio entre términos funciona como una lógica booleana AND. Si incluyes un AND explícito en tu regla, el endpoint de reglas lo rechazará.

social media

Combinación de términos con OR en mayúsculas (OR)

No obstante, en muchas situaciones se requiere lógica booleana OR. Esto también se logra fácilmente. Ten en cuenta que el operador OR debe estar en mayúsculas; un ‘or’ en minúsculas se tratará como una palabra clave normal.

social OR data

Negación de términos

Otros escenarios pueden requerir excluir resultados con ciertas palabras clave (lógica booleana NOT). Por ejemplo, actividades con ‘happy’, pero excluyendo cualquiera con ‘birthday’ en el texto.

social -personality

Agrupación con paréntesis

Estos tipos de lógica pueden combinarse mediante agrupación con paréntesis y ampliarse a consultas mucho más complejas.

(social OR data) (academic OR research) -personality -information -university

Esto es solo el comienzo: si bien los ejemplos anteriores se basan simplemente en coincidencias tokenizadas de palabras clave, los productos Enterprise también ofrecen operadores para realizar diferentes tipos de coincidencia en 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 aspectos únicos de los datos sociales, más allá del texto. 

El usuario que está publicando un Post

from:XDevelopers

Tweets con etiqueta geográfica dentro de 10 millas de Pearl St. en Boulder, CO, United States

point_radius:[-105.27346517 40.01924738 10.0mi]

Combinándolo todo

Estos se pueden combinar con filtros de texto usando los mismos tipos de lógica descritos arriba.

(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. Consulte la tabla a continuación para obtener detalles adicionales sobre la sintaxis y los requisitos de cada una.

Tipo de lógica	Sintaxis del operador	Descripción
AND	social data	El espacio en blanco entre dos operadores produce lógica AND entre ellos. Coincide con actividades que contienen ambas palabras clave (“social”, “data”). No use AND explícitamente en su regla. Use 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, inserte un OR en mayúsculas, separado por espacios en blanco entre ellos. Coincide con actividades que contienen CUALQUIERA de las palabras clave (“social” OR “data”). Tenga en cuenta que si combina la funcionalidad OR y AND en una sola regla, debe comprender el orden de 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 garantizar que su regla se comporte como se espera. Debe usar “OR” en mayúsculas en su regla. “or” en minúsculas se tratará como una palabra clave normal.
NOT	social data -apple -android -phone	Inserte un carácter - inmediatamente delante del operador o del 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álida porque coincidiría con todas las actividades excepto aquellas que mencionan “ipad”.
Agrupación	(social OR data) -XDevelopers -api	Los paréntesis alrededor de múltiples operadores crean un “grupo” funcional. Los grupos pueden conectarse a cláusulas de la misma manera que una cláusula individual mediante espacios en blanco (AND) u OR. Sin embargo, tenga en cuenta que es una práctica recomendada no agrupar negaciones aplicando la negación - a todo el grupo. En su lugar, debe negar cada operador individual, encadenándolos mediante espacios en blanco (AND).  Por ejemplo, en lugar de usar -(iphone OR imac OR macbook), use lo siguiente: -iphone -imac -macbook La agrupación es especialmente importante cuando una sola regla combina la funcionalidad AND y OR, debido al orden de operaciones utilizado para evaluar la regla. Consulte a continuación para más detalles.

Tenga en cuenta: los operadores pueden ser positivos o negativos.

Los operadores positivos definen lo que desea incluir en los resultados. Por ejemplo, el operador has:hashtags indica: “Quiero actividades que contengan hashtags”.

Los operadores negativos definen lo que desea excluir de los resultados y se crean usando la lógica booleana NOT descrita anteriormente. Por ejemplo, -has:hashtags indica: “Excluir 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 sola regla, el siguiente orden de operaciones determina cómo se evalúa tu regla.

1. Primero se combinan los operadores conectados con 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 incertidumbre y garantizar 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)

​

Puntuación, diacríticos y distinción entre mayúsculas y minúsculas

Si especifica una regla de palabra clave o hashtag con acentos o diacríticos para operadores de Enterprise, coincidirá con el texto del Post respetando los diacríticos (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 distinción entre mayúsculas y minúsculas. Por ejemplo, la regla Cat coincidirá con todos los siguientes: “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 afectan el filtrado, pero pueden usarse para crear agrupaciones lógicas de reglas dentro de su App. Cada regla puede tener una sola etiqueta, de hasta 255 caracteres. Las etiquetas se incluyen con la regla en formato JSON en el momento de su creación a través de la API, como se describe en nuestra página “Matching rules”.

​

Colocar reglas en formato JSON

Para agregar o eliminar una regla de un stream mediante la API, las reglas deben usar el formato JSON. En esencia, 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 coincidencia exacta 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 entre 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 así:

"Toys \"R\" Us"

Al convertir esto a formato JSON, debes usar la siguiente estructura:

{"value":"\"Toys \\\"R\\\" Us\""}

Reglas con etiquetas

Para incluir una etiqueta opcional con tu regla, como se describió arriba, simplemente incluye un campo adicional tag 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 mediante la API, varias reglas en formato JSON deben separarse por comas y colocarse dentro de un arreglo JSON “rules”, como se muestra a continuación:

{"rules":[{"value":"from:XDevelopers"},{"value":"\"social data\" @XDevelopers","tag":"RULE-TAG-01"}]}

​

Operadores que coinciden con los Quote Tweets

Al usar la PowerTrack API y la Historical PowerTrack API, los siguientes operadores harán coincidencia tanto con el contenido del Post original citado como con el nuevo Quote Tweet.

Sin embargo, si usas la Search API, estos operadores solo harán coincidencia con el contenido del Quote Tweet y no coincidirán con ningún contenido del Post original citado.

• 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 estos está disponible con las API 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. 

Operador	Descripción
keyword	Busca una palabra clave dentro del cuerpo del texto o URL de un Post. Las palabras clave deben comenzar con un dígito (0-9) o cualquier carácter que no sea de puntuación. La búsqueda de palabras clave está tokenizada, lo que significa que la palabra clave se compara con el texto tokenizado del cuerpo del Post. Para cadenas con puntuación (p. ej., “coca-cola”), utilice una “coincidencia de frase exacta” entre comillas. Ejemplo: (social OR pizza OR wildfire) -planet
emoji	Busca un emoji dentro del cuerpo de un Post, utilizando coincidencia tokenizada basada en puntuación, símbolo/emoji y caracteres separadores. Si un emoji tiene una variante, utilice comillas para coincidencias exactas. Ejemplo: (🍕 OR 💜 OR 🐢) -🤖
”exact phrase match”	Busca una frase exacta dentro del cuerpo de un Post. La puntuación se trata como espacio en blanco. Ejemplo: ("social media" OR "developer.x.com" OR "wildfire911" OR "coca-cola") -"planet earth"
#	Busca cualquier Post que tenga el hashtag especificado. Esta es una coincidencia exacta, lo que significa que #2016 encontrará posts que tengan #2016 pero no #2016election. Ejemplo: (#social OR #pizza OR #2016election) -#planet
@	Busca cualquier Post que mencione el nombre de usuario especificado. Ejemplo: (@XDevelopers OR @api OR @twittereng) -@jack
”keyword1 keyword2”~N	Operador de proximidad que busca un Post donde las palabras clave están dentro de N tokens una de la otra. 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:	Búsqueda de subcadena para Posts con la subcadena especificada en el cuerpo, independientemente de la tokenización. Utilice comillas dobles para subcadenas con espacios en blanco o puntuación. Ejemplo: (contains:social OR contains:"wikipedia.com") -contains:"buy now"
from:	Busca cualquier Post de un usuario específico por ID de cuenta numérico de X o nombre de usuario (excluyendo @). Ejemplo: (from:2244994945 OR from:api OR from:twittereng) -from:jack
to:	Busca cualquier Post que responda a un usuario específico por ID de cuenta numérico de X o nombre de usuario (excluyendo @). Ejemplo: (to:2244994945 OR to:api OR to:twittereng) -to:jack
url:	Realiza una búsqueda tokenizada (palabra clave/frase) en URLs expandidas de un post. Ejemplo: @XDevelopers url:"developer.x.com"
url_title:	Realiza una búsqueda de palabra clave/frase en los metadatos del título HTML de la URL expandida. Disponible solo con PowerTrack y Historical PowerTrack.
url_description:	Realiza una búsqueda de palabra clave/frase en los metadatos de descripción de la página expandida. Disponible solo con PowerTrack y Historical PowerTrack.
url_contains:	Busca Posts que tengan URLs que contengan la frase o palabra clave especificada. Encierre los términos de búsqueda con puntuación entre comillas. Ejemplo: (url_contains:"developer.x.com" OR url_contains:wildfire) -url_contains:reddit
bio:	Busca una palabra clave o frase dentro de la biografía del usuario de un Post. Esta es una búsqueda tokenizada dentro del campo ‘description’ del objeto de usuario. Ejemplo: (bio:engineer OR bio:"wordpress.com" OR bio:🚀) -bio:troll Nota: Solo disponible con PowerTrack y Historical PowerTrack.
bio_name:	Busca una palabra clave dentro del nombre de la biografía del usuario de un Post. Esta es una búsqueda tokenizada dentro del campo “name” de un usuario en el objeto de usuario. Nota: Solo disponible con PowerTrack y Historical PowerTrack.
bio_location:	Busca Posts donde la ubicación del objeto de usuario contiene la palabra clave o frase especificada. Este operador realiza una búsqueda tokenizada, similar a las reglas normales de palabras clave en el cuerpo del mensaje. Esta ubicación es parte del objeto de usuario, y es la ubicación ‘principal’ de la cuenta. Nota: Solo disponible con PowerTrack y Historical PowerTrack.
statuses_count:	Busca Posts cuando el autor ha publicado un número de statuses dentro del rango especificado. Si se especifica un solo número, cualquier número igual o mayor será válido. Se puede especificar un rango para buscar cualquier número en el rango (p. ej., statuses_count:1000..10000). Ejemplo: to:api statuses_count:10 Nota: Solo disponible con PowerTrack y Historical PowerTrack.
followers_count:	Busca Posts cuando el autor tiene un número de seguidores dentro del rango especificado. Si se especifica un solo número, cualquier número igual o mayor será válido. Se puede especificar un rango para buscar cualquier número en el rango (p. ej., followers_count:1000..10000). Nota: Solo disponible con PowerTrack y Historical PowerTrack.
friends_count:	Busca Posts cuando el autor tiene un número de amigos (el número de usuarios que sigue) dentro del rango especificado. Si se especifica un solo número, cualquier número igual o mayor será válido. Se puede especificar un rango para buscar cualquier número en el rango (p. ej., friends_count:1000..10000). Nota: Solo disponible con PowerTrack y Historical PowerTrack.
listed_count:	Busca Posts cuando el autor ha sido incluido en listas dentro de X un cierto número de veces dentro del rango especificado. Si se especifica un solo número, cualquier número igual o mayor será válido. Se puede especificar un rango para buscar cualquier número en el rango (p. ej., listed_count:10..100). Nota: Solo disponible con PowerTrack y Historical PowerTrack.
$	Busca cualquier Post que contenga la entidad ‘cashtag’ especificada. Ejemplo: ($TWTR OR $TSLA OR $BRK.A) -$F Nota: El operador cashtag se basa en la extracción de entidades ‘symbols’ de X para encontrar cashtags, en lugar de extraerlo del cuerpo mismo.
retweets_of:	Busca Posts que son Retweets de un usuario especificado. Acepta tanto nombres de usuario como IDs de cuenta numéricos de X (NO IDs de estado de Post). Ejemplo: (retweets_of:2244994945 OR retweets_of:api OR retweets_of:twittereng) -retweets_of:jack
retweets_of_status_id:	Devuelve solo Retweets explícitos del Post especificado. Utilice el ID de un Post original y no 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 al Post especificado. Ejemplo: in_reply_to_status_id:1293593516040269825 Nota: Solo disponible con PowerTrack y Historical PowerTrack.
sample:	Devuelve una muestra aleatoria de Posts que coinciden con una regla. El porcentaje de muestra debe ser un entero entre 1 y 100. El operador reduce el alcance a X%, luego la regla/filtro se aplica a ese subconjunto muestreado. Ejemplo: #happybirthday sample:5 "happy birthday"~5 sample:80 Nota: Solo disponible con PowerTrack y Historical PowerTrack.
source:	Busca cualquier Post generado por la aplicación fuente especificada. El valor puede ser el nombre de la aplicación 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 fuente del Post y no puede utilizarse solo.
lang:	Busca Posts clasificados por X como pertenecientes a un idioma particular. Los Posts actualmente se clasifican como un solo idioma, por lo que buscar múltiples idiomas no produce resultados. No se recomienda utilizar solo.

La lista a continuación representa los idiomas actualmente admitidos y su correspondiente identificador de idioma BCP 47:

Amhárico: am	Alemán: de	Malayalam: ml	Eslovaco: sk
Árabe: ar	Griego: el	Maldivo: dv	Esloveno: sl
Armenio: hy	Guyaratí: gu	Maratí: mr	Kurdo soraní: 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

Ejemplo:

(@XDevelopers OR to:XDevelopers) lang:es

Nota: El operador de idioma coincide con el idioma específico del Post determinado por X y establecido como el atributo lang del Post. Consulte AQUÍ para más información sobre los atributos JSON de X Entities. Si no se puede determinar la clasificación de idioma de un Post, el atributo lang del Post se establecerá como ‘und’ (indefinido).

Operador	Descripción
place	Busca Posts etiquetados con la ubicación especificada o el ID de lugar de X. Los nombres de lugares de varias palabras deben estar entre comillas. Ejemplo: (place:London OR place:"Great Britain") -place:USA place:fd70c22040963ac7 Nota: Consulta el endpoint de API pública GET geo/search para obtener información sobre cómo obtener IDs de lugar de X. Nota: No encontrará coincidencias en Retweets o Quote Tweets, ya que los lugares de Retweet están asociados al Post original.
place_country	Busca Posts donde el código de país asociado con un lugar/ubicación etiquetado coincide con el código de carácter alfa-2 ISO proporcionado. Ejemplo: place_country:GB OR place_country:AU OR place_country:CA Nota: No encontrará coincidencias en Retweets o Quote Tweets, ya que los lugares de Retweet están asociados al Post original. Códigos ISO válidos: ISO 3166-1 alpha-2.
point_radius:[lon lat radius]	Busca la Ubicación Exacta (x,y) del Post o un polígono geográfico de “Lugar” dentro del radio definido. _ Radio: < 25mi _ Unidades admitidas: mi, km _ Longitud: ±180 _ Latitud: ±90 Las coordenadas están en grados decimales. Los argumentos están entre corchetes, separados por espacios. Ejemplo: point_radius:[-105.27346517 40.01924738 0.5mi] Ejemplo: point_radius:[2.355128 48.861118 16km] Nota: No encontrará coincidencias en Retweets o Quote Tweets.
bounding_box:[west_long south_lat east_long north_lat]	Busca Ubicación Exacta o un polígono geográfico de “Lugar” completamente contenido en un cuadro delimitador. Los argumentos están entre corchetes, separados por espacios. Coordenadas: grados decimales (±180 long, ±90 lat). El ancho y la altura deben ser < 25mi. Ejemplo: bounding_box:[-105.301758 39.964069 -105.178505 40.09455] Nota: No encontrará coincidencias en Retweets o Quote Tweets.
profile_country	Busca Posts donde el código de país geográfico del perfil del autor coincide con un código de dos letras ISO-3166-1-alpha-2 proporcionado.
profile_region	Busca en el campo “region” del enriquecimiento geográfico del perfil del autor, una coincidencia exacta de cadena completa. Usa comillas dobles para subcadenas que contengan espacios en blanco o puntuación. Ejemplo: profile_region:"New York"
profile_locality	Busca en el campo “locality” del enriquecimiento geográfico del perfil del autor, una coincidencia exacta de cadena completa. Usa comillas dobles para subcadenas que contengan espacios en blanco o puntuación. Ejemplo: profile_locality:"San Francisco"
profile_subregion	Busca en el campo “subRegion” del enriquecimiento geográfico del perfil del autor, incluyendo condados específicos o áreas metropolitanas. Una coincidencia exacta de cadena completa. Ejemplo: profile_subregion:"Santa Clara County"
has:geo	Busca Posts que tienen datos de ubicación geográfica específicos del Post de X, incluyendo datos de ubicación “geo” lat-long o “Place” con un nombre para mostrar y polígono geográfico. Nota: Con Search API, debe combinarse con operadores que no sean is: o has:.
has:profile_geo	Busca Posts que tienen cualquier metadata de Geo de Perfil, independientemente del valor. Alias disponible: has:derived_user_geo. Nota: Con Search API, debe combinarse con operadores que no sean is: o has:.
has:links	Busca Posts que tienen un enlace o medios referenciados en el objeto “text” del payload, incluyendo medios y Quote Tweets. Nota: Con Search API, debe combinarse con operadores que no sean is: o has:.
is:retweet	Devuelve solo retweets explícitos. Puede negarse para excluir retweets y devolver solo contenido original. Este operador busca solo Retweets verdaderos y no Quoted Tweets. Nota: Con Search API, debe combinarse con operadores que no sean is: o has:.
is:reply	Devuelve solo respuestas explícitas. Puede negarse para excluir respuestas. PowerTrack encuentra respuestas a Posts originales, respuestas en Posts citados y respuestas en Retweets. Search API encuentra solo respuestas a Posts originales. Ejemplo: @XDevelopers -is:reply
is:quote	Devuelve solo Quote Tweets o Posts que referencian otro Post. Puede negarse para excluir Quote Tweets. Ejemplo: @XDevelopers is:quote
is:verified	Devuelve solo Posts de autores “verificados”. Puede negarse para excluir Posts de autores verificados. Ejemplo: @XDevelopers is:verified
has:mentions	Busca Posts que mencionan a otro usuario de X. Nota: Con Search API, debe combinarse con operadores que no sean is: o has:.
has:hashtags	Busca Posts que contienen un hashtag. Nota: Con Search API, debe combinarse con operadores que no sean is: o has:.
has:media	Busca Posts que contienen una URL de medios clasificada por X (ej., pic.x.com). Alias disponible: has:media_link. Nota: Con Search API, debe combinarse con operadores que no sean is: o has:.
has:images	Busca Posts que contienen una URL de medios (ej., pic.x.com). Nota: Con Search API, debe combinarse con operadores que no sean is: o has:.
has:videos	Busca Posts que contienen videos nativos de X subidos a X. Alias disponible: has:video_link. Este operador no encuentra videos de YouTube, Periscope u otros sitios de alojamiento de videos. Nota: Con Search API, debe combinarse con operadores que no sean is: o has:.
has:symbols	Busca Posts que contienen un símbolo cashtag (ej., $TWTR). Nota: Con Search API, debe combinarse con operadores que no sean is: o has:.

​

Operadores por producto

​

Reglas y filtrado: Enterprise

Todos los operadores de Enterprise están disponibles en las API de PowerTrack y Historical PowerTrack. Sin embargo, solo un subconjunto de operadores está disponible en las API de búsqueda de Enterprise, como se indica en esta página.

Las etiquetas azul oscuro señalan qué operadores están disponibles en distintos productos de Enterprise:

PowerTrack Search

Operador	Producto	Descripción	Coincide con el elemento de carga útil
”coincidencia exacta de frase”	PowerTrack Search	Coincide con una frase exacta dentro del cuerpo de un Post. Los componentes que pueden convertirse en operadores de búsqueda serán tratados como palabras. En otras palabras: _ "#hashtag" coincidirá con hashtag pero no con #hashtag (usa el operador hashtag sin comillas para coincidir con hashtags reales) _ "$TWTR" coincidirá con la palabra TWTR pero no con el cashtag $TWTR (usa el operador cashtag sin comillas para coincidir con cashtags reales) Nota: en 30 Day Search y Full Archive Search (Enterprise y Premium), la puntuación no se tokeniza y en su lugar se trata como espacio en blanco.	text
@	PowerTrack Search	Coincide con cualquier Post que mencione el nombre de usuario dado. El valor puede ser el nombre de usuario (excluyendo el carácter @) o el ID numérico del usuario (obtenido por ejemplo a través del endpoint GET users/lookup).	entities.user_mentions
#	PowerTrack Search	Coincide con cualquier Post con el hashtag dado. Este operador realiza una coincidencia exacta. Por ejemplo, la regla #1989 coincidirá con Posts que contengan el hashtag exacto #1989, pero no con aquellos que tengan el hashtag #TaylorSwift1989. Nota: este operador se basa en la extracción de entidades de X para coincidir con hashtags, en lugar de extraer el hashtag del cuerpo mismo. Para más detalles sobre los atributos JSON de las entidades, consulta X Entities.	entities.hashtags
$	PowerTrack Search	Coincide con cualquier Post que contenga el cashtag especificado (donde el carácter inicial del token es $). Nota: este operador se basa en la extracción de entidades de X para coincidir con enlaces, en lugar de extraer el enlace del cuerpo mismo. Para 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 un Post. Usa comillas dobles para coincidir con una frase. En otras palabras: _ bio:software engineer coincidirá con Posts con la palabra clave engineer de usuarios con la palabra software en su biografía _ bio:"software engineer" coincidirá con cualquier Post publicado por usuarios con la frase software engineer en su biografía	user``.description
bio_location:	PowerTrack	Alias disponible: user_bio_location: Coincide con Posts donde la ubicación del objeto de usuario contiene la palabra clave especificada (usando coincidencia tokenizada) o frase. Esta ubicación es una cadena no normalizada, generada por el usuario y de forma libre, y es diferente de la ubicación de un Post (cuando está disponible).	user.location
bio_name:	PowerTrack	Coincide con Posts donde el nombre del objeto de usuario contiene la palabra clave especificada (usando coincidencia tokenizada) o frase.	user.name
bounding_box:	PowerTrack Search	Alias disponible: geo_bounding_box: Coincide con la ubicación exacta (longitud, latitud) del Post (cuando está presente), y con un polígono geográfico (donde el Lugar está completamente contenido dentro de la región definida). _ west_long 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 alto del cuadro delimitador debe ser menor 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 están contenidos dentro de corchetes, delimitados por espacios. Nota: los operadores que coinciden con lugar (geo del Post) solo incluirán coincidencias de Posts originales. Los Retweets no contienen datos de lugar.	place (solo Posts originales)
contains:	PowerTrack	Coincidencia de subcadena para Posts que tienen la subcadena dada en el cuerpo, independientemente de la tokenización. En otras palabras, esto hace una coincidencia de subcadena pura y no considera los límites de palabras. Usa comillas dobles para coincidir con subcadenas que contengan espacios en blanco o puntuación.	text
<emoji>	PowerTrack Search	Coincide con un emoji dentro del cuerpo de un Post. Esta es una coincidencia tokenizada, por lo que tu emoji será comparado con el texto tokenizado del cuerpo del Post. La tokenización se basa en puntuación, símbolo/emoji, y caracteres del plano básico Unicode separadores. Por ejemplo, un Post con el texto “I like 🍕” se dividiría en los siguientes tokens: I, like, 🍕. Estos tokens serían entonces comparados con el emoji usado en tu regla. Nota: si un emoji tiene una variante, debes usar comillas dobles para agregarlo a una regla.	text
followers_count:	PowerTrack	Coincide con Posts cuando el autor tiene un número de seguidores dentro del rango dado. _ Un solo número (ej. followers_count:42) coincidirá con cualquier número igual o mayor al valor especificado. _ Un rango (ej. followers_count:42..1337) coincidirá con cualquier número en el rango dado.	user.followers_count
friends_count:	PowerTrack	Alias disponible: following_count: Coincide con Posts cuando el autor tiene un número de amigos (el número de usuarios que sigue) que se encuentra dentro del rango dado. _ Un solo número (ej. followers_count:42) coincidirá con cualquier número igual o mayor al valor especificado. _ Un rango (ej. followers_count:42..1337) coincidirá con cualquier número en el rango dado.	user.friends_count
from:	PowerTrack Search	Coincide con cualquier Post de un usuario específico. El valor puede ser el nombre de usuario (excluyendo el carácter @) o el ID numérico del usuario (obtenido por ejemplo a través del endpoint GET users/lookup).	user.id, user.id_str (si usa ID de usuario) user.screen_name (si usa nombre de usuario)
has:geo	PowerTrack Search	Coincide con Posts que tienen datos de geolocalización específicos del Post proporcionados por X. Esto puede ser coordenadas “geo” lat-long, o una “ubicación” en forma de un Place de X, con el nombre de visualización correspondiente, polígono geográfico y otros campos. No puede usarse como operador independiente. Nota: los operadores que coinciden con lugar (geo del Post) solo incluirán coincidencias de Posts originales. Los Retweets no contienen datos de lugar.	place (solo Tweets originales)
has:hashtags	PowerTrack Search	Coincide con Posts que contienen al menos un hashtag. No se puede usar como operador independiente.	entities.hashtags
has:images	PowerTrack Search	Coincide con Posts que contienen al menos una URL de imagen clasificada. No se puede usar como operador independiente.	entities.media
has:lang	PowerTrack	Coincide con Posts que han sido clasificados por X como pertenecientes a un idioma específico. Si un Post no ha sido clasificado, el operador no coincidirá. Cada Post actualmente solo se clasifica como perteneciente a un idioma, por lo que usar AND con múltiples idiomas no producirá resultados. No se puede usar como operador independiente.	lang cuando el valor no es und
has:links	PowerTrack Search	Este operador coincide con Posts que contienen enlaces en el cuerpo del Post. No se puede usar como operador independiente. Nota: este operador se basa en la extracción de entidades de X para coincidir con enlaces, en lugar de extraer el enlace del cuerpo mismo. Para más detalles sobre los atributos JSON de las entidades, consulte X Entities.	entities.urls
has:media	PowerTrack Search	Alias disponible: has:media_link Coincide con Posts que contienen al menos una URL de medios clasificada. No se puede usar como operador independiente.	entities.media
has:mentions	PowerTrack Search	Coincide con Posts 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 Posts que tienen cualquier metadatos de Profile Geo, independientemente del valor real. No se puede usar como operador independiente.	user.location
has:symbols	PowerTrack Enterprise	Coincide con Posts que contienen un símbolo cashtag (p. ej., $TWTR). No se puede usar como operador independiente.	entities.symbols
has:videos	PowerTrack Search	Alias disponible: has:video_link Coincide con Posts que contienen al menos una URL de medios clasificada. No se puede usar como operador independiente.	entities.media
in_reply_to_status_id:	PowerTrack	Alias disponible: in_reply_to_tweet_id: Entrega solo respuestas explícitas al Post especificado.	id, id_str del Post objetivo
is:quote	PowerTrack	Entrega Quote Tweets explícitos que coinciden con una regla. También se puede negar (-is:quote) para excluir Quote Tweets que coinciden con una regla de la entrega. No se puede usar como operador independiente.	is_quote_status (si es true)
is:reply	PowerTrack Search	Entrega solo respuestas que coinciden con una regla. También se puede negar (-is:reply) para excluir la entrega de respuestas que coinciden con la regla especificada. Con PowerTrack, este operador coincide con: _ Respuestas a un Post original _ Respuestas en Posts citados * Respuestas en Retweets Cuando se usa con la API de Search, este operador coincide con respuestas a un Post original, pero excluye respuestas en Tweets citados y respuestas en Retweets. Puede usar este operador junto con is:retweet e is:quote para entregar solo respuestas a Posts originales. No se puede usar como operador independiente con la API de Search. 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	Entrega solo Retweets explícitos que coinciden con una regla. También se puede negar (-is:retweet) para excluir Retweets que coinciden con una regla de la entrega y solo se entrega contenido original. Este operador busca solo Retweets verdaderos (es decir, Retweets publicados usando el botón Retweet). Los Tweets citados y Posts modificados que no usan la funcionalidad de Retweet de X no serán coincididos por este operador. No se puede usar como operador independiente.	Elementos de Retweet, p. ej., retweeted_status
is:verified	PowerTrack Search	Entrega solo Posts donde el autor está verificado por X. También se puede negar para excluir Posts donde el autor está verificado. No se puede usar como operador independiente.	user.verified
keyword	PowerTrack Search	Coincide con una palabra clave dentro del cuerpo de un Post. Esta es una coincidencia tokenizada, lo que significa que su cadena de palabra clave se comparará con el texto tokenizado del cuerpo del Post. La tokenización se basa en puntuación, símbolos/emoji y caracteres separadores del plano básico Unicode. Por ejemplo, un Post con el texto “I like coca-cola” se dividiría en los siguientes tokens: I, like, coca, cola. Estos tokens se compararían luego con la cadena de palabra clave utilizada en su regla. Para coincidir con cadenas que contienen puntuación (p. ej., coca-cola), símbolos o caracteres separadores, debe usar un operador de coincidencia de frase exacta.	text
lang:	PowerTrack Search	Coincide con Posts que han sido clasificados por X como pertenecientes a un idioma en particular (si, y solo si, el post ha sido clasificado). Cada Post será clasificado con un solo idioma, por lo que usar AND con múltiples idiomas no producirá resultados. **Nota: **si no se puede realizar una clasificación de idioma, el resultado proporcionado es und (para indefinido). Este operador solo coincidirá con idiomas compatibles. Proporcionar cualquier otro valor (incluyendo und) resultará en que el operador sea ignorado (en otras palabras, los Posts no serán filtrados por este operador). La lista a continuación representa los idiomas actualmente compatibles y su identificador de idioma BCP 47 correspondiente: am Amá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 Canarés si Cingalés zh Chino km Jemer sk Eslovaco cs Checo ko Coreano sl Esloveno da Danés lo Lao ckb Kurdo Sorani nl Holandés lv Letón es Español en Inglés lt Lituano sv Sueco et Estonio ml Malayalam tl Tagalo fi Finlandés dv Maldivo ta Tamil fr Francés mr Marathi te Telugu ka Georgiano ne Nepalí th Tailandés de Alemán no Noruego bo Tibetano el Griego or Oriya tr Turco gu Gujarati 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 el valor no es und
listed_count:	PowerTrack	Alias disponible: user_in_lists_count: Coincide con Posts cuando el autor ha sido incluido en listas de X un número de veces que se encuentra dentro del rango dado. _ Un solo número (ej. listed_count:42) coincidirá con cualquier número igual o mayor al valor especificado. _ Un rango (ej. listed_count:42..1337) coincidirá con cualquier número en el rango dado.	user.listed_count
place_country:	PowerTrack Search	Coincide con Posts donde el código de país asociado con un lugar/ubicación etiquetado coincide con el código de carácter alfa-2 ISO dado. Nota: los operadores que coinciden con lugar (geo del Post) solo incluirán coincidencias de Posts originales. Los Retweets no contienen datos de lugar.	place (solo Posts originales)
place:	PowerTrack Search	Coincide con Posts etiquetados con ubicación especificada o ID de lugar de X. Los nombres de lugares de múltiples palabras deben estar entre comillas (ej. place:"San Francisco") Nota: los operadores que coinciden con lugar (geo del Post) solo incluirán coincidencias de Posts originales. Los Retweets no contienen datos de lugar.	place (solo Posts originales)
point_radius:	PowerTrack Search	Nota: los operadores que coinciden con lugar (geo del Post) solo incluirán coincidencias de Posts originales. Los Retweets no contienen datos de lugar.	place (solo Posts 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 de Geo del Perfil donde el Lugar está completamente contenido dentro de la región definida. _ west_long 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 alto del cuadro delimitador debe ser menor a 25mi _ 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 regla están contenidos dentro de corchetes, delimitados por espacios. Nota: los operadores que coinciden con lugar (geo del Post) solo incluirán coincidencias de Posts originales. Los Retweets no contienen datos de lugar.	user.derived.locations.geo.coordinates
profile_country:	PowerTrack Search	Coincidencia exacta en el código de país del enriquecimiento de Geo del Perfil. 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 conciso, este operador se proporciona en lugar de un operador para el campo de país del objeto de dirección. Nota: los operadores que coinciden con lugar (geo del Post) solo incluirán coincidencias de Posts originales. Los Retweets no contienen datos de lugar.	user.derived.locations.country_code
profile_locality:	PowerTrack Search	Coincidencia exacta en el campo de Localidad del enriquecimiento de Geo del Perfil. Esta es una coincidencia exacta de cadena completa. No es necesario escapar caracteres con una barra invertida. Por ejemplo, si se coincide con algo que tiene una barra, use one/two. Use comillas dobles para coincidir con subcadenas que contengan espacios en blanco o puntuación, ej. 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 enriquecimiento de Geo del Perfil del usuario. _ Las unidades de radio compatibles son millas (mi) y kilómetros (km). _ El radio debe ser menor a 25mi. _ 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 regla están contenidos dentro de corchetes, delimitados por espacios. Nota: los operadores que coinciden con lugar (geo del Post) solo incluirán coincidencias de Posts originales. Los Retweets no contienen datos de lugar.	user.derived.locations.geo
profile_region:	PowerTrack Search	Coincidencia exacta en el campo Region del enriquecimiento Profile Geo. Esta es una coincidencia exacta de cadena completa. No es necesario escapar caracteres con una barra invertida. Por ejemplo, si busca algo que contenga una barra, use one/two. Use comillas dobles para coincidir con subcadenas que contengan espacios en blanco o puntuación, p. ej. profile_locality:"New York".	user.derived.locations.region
profile_subregion:	PowerTrack	Coincidencia exacta en el campo Subregion del enriquecimiento Profile Geo. Esta es una coincidencia exacta de cadena completa. No es necesario escapar caracteres con una barra invertida. Por ejemplo, si busca algo que contenga una barra, use one/two. Use comillas dobles para coincidir con subcadenas que contengan espacios en blanco o puntuación, p. ej. profile_locality:"Kings County".	user.derived.locations.sub_region
”keyword1 keyword2”~N	PowerTrack Search	Comúnmente conocido como operador de proximidad, esto coincide con un Post donde las palabras clave no están a más de N tokens una de la otra. Si las palabras clave están en orden inverso, no pueden estar a más de N-2 tokens una de la otra. Puede tener 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: Entrega solo Retweets explícitos del Post original especificado.	retweeted_status.id, retweeted_status.id_str
retweets_of:	PowerTrack Search	Alias disponible: retweets_of_user: Coincide con cualquier Post que sean Retweets del usuario especificado. El valor puede ser el nombre de usuario (excluyendo el carácter @) o el ID numérico del usuario (obtenido por ejemplo a través del endpoint GET users/lookup).	retweeted_status.id (si está presente)
sample:	PowerTrack	Devuelve una muestra de porcentaje aleatorio de Posts que coinciden con una regla en lugar del conjunto completo de Posts. El valor de porcentaje debe estar representado por un entero entre 1 y 100. Este operador se aplica a toda la regla y requiere que todos los términos con OR estén agrupados. Nota: el operador sample primero reduce el alcance del firehose a X%, luego la regla/filtro se aplica a ese subconjunto muestreado. Si está usando, por ejemplo, sample:10, cada Post tiene un 10% de probabilidad de estar en la muestra. Nota: el muestreo es determinístico, y obtendrá la misma muestra de datos en tiempo real que obtendría si extrajera los datos históricamente.
source:	PowerTrack	Coincide con cualquier Post generado por la aplicación fuente especificada. El valor debe ser el nombre de la aplicación o la URL de la aplicación. No se puede usar como operador independiente.	source
statuses_count:	PowerTrack	Alias disponible: tweets_count: Coincide con Posts cuando el autor ha publicado un número de statuses que se encuentra dentro del rango especificado. _ Un solo número (p. ej. statuses_count:42) coincidirá con cualquier número igual o mayor al valor especificado. _ Un rango (p. ej. statuses_count:42..1337) coincidirá con cualquier número en el rango especificado.	user``.statuses_count
to:	PowerTrack Search	Coincide con cualquier Post que sea en respuesta a un usuario particular. El valor puede ser el nombre de usuario (excluyendo el carácter @) o el ID numérico del usuario (obtenido por ejemplo a través del endpoint GET users/lookup).	text
url:	PowerTrack Search	Realiza una coincidencia tokenizada en las URLs expandidas de un Post. Los tokens y frases que contengan puntuación o caracteres especiales deben estar entre comillas dobles (p. ej. url:"/developer"). Aunque generalmente no se recomienda, el operador también puede coincidir con un protocolo específico, encerrado entre comillas dobles (p. ej. url:"https://developer.x.com").	entities.urls.expanded_url
url_contains:	PowerTrack	Realiza una coincidencia de palabra clave/frase 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 clave/frase en el (nuevo) enriquecimiento de metadatos de descripción de página expandida.	entities.urls.unwound.description
url_title:	PowerTrack	Alias disponible: within_url_title: Realiza una coincidencia de palabra clave/frase en el (nuevo) enriquecimiento de metadatos de título de URL expandida.	entities.urls.title