Introducción a las reglas y consultas empresariales
OR en mayúsculas.
Cada regla puede tener hasta 2.048 caracteres de longitud, sin límites en 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 del operador Empresarial coincidiría con actividades que contengan 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 añadir 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 lógica booleana AND. Si incluye un AND explícito en su regla, el endpoint de reglas lo rechazará.
social media
Aplicar OR a términos con OR en mayúsculas
En muchas situaciones se requiere lógica booleana OR, y esto también se logra fácilmente. Tenga 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
Negar términos
En otros escenarios puede que quiera 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
Agrupar 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 principio: aunque los ejemplos anteriores se basan simplemente en coincidencias tokenizadas de palabras clave, los productos Empresariales 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 le permiten filtrar aspectos únicos de los datos sociales, más allá del texto.
El usuario que está publicando un Post
from:XDeveloeprs
Tweets con etiqueta geográfica a menos de 10 millas de Pearl St. en Boulder, CO, United States
point_radius:[-105.27346517 40.01924738 10.0mi]
Uniendo todo
Estos pueden combinarse con filtros de texto utilizando los mismos tipos de lógica descritos anteriormente.
(social OR data) (academic OR research OR "social media research") point_radius:[-105.27346517 40.01924738 10.0mi] lang:en -personality -information -university
Sintaxis booleana
| Tipo de lógica | Sintaxis del operador | Descripción |
| AND | social data | Un espacio en blanco entre dos operadores implica 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. Un AND explícito se tratará como una palabra clave normal. |
| OR | social OR data | Para aplicar OR entre dos operadores, inserte OR en mayúsculas, separado por espacios entre ellos. Coincide con actividades que contengan 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 los operadores no negados usando paréntesis, como se describe a continuación, para asegurarse de que su regla se comporte como se espera. Debe usar “OR” en mayúsculas en su regla. La forma en minúsculas “or” 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álido porque coincidiría con todas las actividades excepto las que mencionan “ipad”. |
| Agrupación | (social OR data) -XDevelopers -api | Los paréntesis alrededor de varios operadores crean un “grupo” funcional. Los grupos pueden conectarse a cláusulas de la misma manera que una cláusula individual mediante espacios (AND) u OR. Sin embargo, es una buena práctica no agrupar negaciones aplicando el signo de negación - a todo el grupo. En su lugar, niegue cada operador individual, encadenándolos mediante espacios (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. Vea a continuación para más detalles. |
has:hashtags dice “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 dice “Excluya cualquier actividad que contenga hashtags, incluso si de otro modo coincide con mi regla”.
Los productos de operadores Premium no tienen restricciones sobre el número de cláusulas positivas y negativas, sujeto a una longitud máxima de 2.048 caracteres.
Orden de operaciones
- Primero se combinan los operadores conectados por lógica AND
- Luego se aplican los operadores conectados con lógica OR
apple OR iphone ipadse evaluará comoapple OR (iphone ipad)ipad iphone OR androidse evaluará como(iphone ipad) OR android
(apple OR iphone) ipadiphone (ipad OR android)
Puntuación, diacríticos y sensibilidad a mayúsculas y minúsculas
Diacr**í**tica o el hashtag #cumplea**ñ**os coincidirá con “Diacrítica” o “#cumpleaños”, pero no con “Diacritica” o “#cumpleanos” sin la tilde í 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 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 sensibilidad a mayúsculas y minúsculas. Por ejemplo, la regla Cat coincidirá con todos los siguientes: “cat”, “CAT”, “Cat”.
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 tu App. Cada regla puede tener una sola 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”.
Colocar reglas en formato JSON
{"value":"insert_rule_here"}
Reglas con comillas dobles
Si la regla contiene caracteres de comillas dobles (") asociados con coincidencias exactas u otros operadores, deben escaparse con una barra invertida para diferenciarlos de la estructura del formato JSON.
"social data" @XDevelopers
La regla con formato JSON sería:
{"value":"\"social data\" @XDevelopers"}
Reglas con literales de cadena que incluyen 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”, incluidas las comillas dobles alrededor de “R”, la representación en texto plano se vería así:
"Toys \"R\" Us"
Al trasladar 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 estar delimitadas por comas y colocadas 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 Tweets citados
KeywordsPhrasesProximity#hashtags@mentions$cashtagsurl:url_contains:has:linkshas:mentionshas:hashtagshas:mediahas:symbolsis:quoteis:reply
Operadores para Enterprise
| Operador | Descripción |
|---|---|
| palabra clave | Coincide con una palabra clave en el cuerpo del texto o la URL de un Post. Las palabras clave deben comenzar con un dígito (0-9) o con cualquier carácter no perteneciente a la puntuación. La coincidencia de palabras clave se realiza mediante tokenización, lo que significa que la palabra clave se compara con el texto tokenizado del cuerpo del Post. Para cadenas con signos de puntuación (p. ej.,“Coca‑Cola”), usa una comilla”coincidencia de frase exacta”. Ejemplo: (social OR pizza OR wildfire) -planet |
| emoji | Busca un emoji dentro del cuerpo de un Post, mediante coincidencia tokenizada basada en signos de puntuación, símbolos/emoji y caracteres separadores. Si un emoji tiene una variante, usa comillas para las coincidencias exactas. Ejemplo: (🍕 OR 💜 OR 🐢) -🤖 |
| ”coincidencia exacta de frase” | Coincide con una frase exacta en el 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") -"planeta Tierra" |
| # | Coincide con cualquier Post que incluya el hashtag especificado. Es una coincidencia exacta, lo que significa#2016coincidirá con publicaciones que#2016pero no#Elecciones2016.Ejemplo: (#social OR #pizza OR #2016election) -#planet |
| @ | Coincide con cualquier Post que mencione el nombre de usuario indicado. Ejemplo: (@XDevelopers OR @api OR @twittereng) -@jack |
| ”keyword1 keyword2”~N | Operador de proximidad que devuelve un Post en el que las palabras clave están a una distancia 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: "redes sociales"~5 OR "API"~3 |
| contiene: | Coincidencia de subcadena para Posts que contengan la subcadena especificada en el cuerpo, sin importar la tokenización. Utiliza comillas dobles para las subcadenas que incluyan espacios o signos de puntuación. Ejemplo: (contains:social OR contains:"wikipedia.com") -contains:"buy now" |
| de: | Coincide con 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 |
| para: | Coincide con cualquier Post que responda a un usuario específico mediante el id de cuenta numérico de X o el nombre de usuario (excluyendo@).Ejemplo: (to:2244994945 OR to:api OR to:twittereng) -to:jack |
| url: | Realiza una coincidencia por tokens (palabra clave/frase) en las URL expandidas de un Post. Ejemplo: @XDevelopers url:"developer.x.com" |
| url_title: | Realiza una coincidencia de palabra o frase en los metadatos del título HTML de la URL expandida. Disponible únicamente con PowerTrack y Historical PowerTrack. |
| url_Descripción: | Realiza una coincidencia de palabras clave o frases en los metadatos de la descripción de la página expandida. Disponible únicamente con PowerTrack y Historical PowerTrack. |
| url_contiene: | Hace coincidir Posts con URLs que contengan la frase o palabra clave especificada. Encierra entre comillas los términos de búsqueda con signos de puntuación. Ejemplo: (url_contains:"developer.x.com" OR url_contains:wildfire) -url_contains:reddit |
| biografía: | Coincide con una palabra clave o frase en la biografía del usuario de un Post. Es una coincidencia tokenizada dentro de la’descripción’campo dentro deObjeto de Usuario. Ejemplo: (bio:engineer OR bio:"wordpress.com" OR bio:🚀) -bio:troll*Nota:*Disponible únicamente con PowerTrack y Historical PowerTrack. |
| biografía_nombre: | Coincide con una palabra clave dentro del nombre del perfil del usuario de una Publicación. Es una coincidencia tokenizada dentro del campo “name” del usuario en elObjeto de usuario. *Nota:*Disponible únicamente con PowerTrack y Historical PowerTrack. |
| biografía_Ubicación: | Coincide con los Posts en los que el objeto User’la ubicación contiene la palabra clave o la frase especificada. Este operador realiza una coincidencia por tokens, similar a las reglas habituales de palabras clave aplicadas al cuerpo del mensaje. Este lugar forma parte de laObjeto de usuario, y es la cuenta’s’inicio’ubicación. *Nota:*Disponible únicamente con PowerTrack y Historical PowerTrack. |
| estatuses_recuento: | Coincide con Posts cuando el autor ha publicado una cantidad de publicaciones dentro del rango indicado. Si se especifica un único número, coincidirá cualquier número igual o superior. Puede especificarse un intervalo para hacer coincidir cualquier número dentro de él (p. ej., statuses_count:1000..10000).Ejemplo: to:api statuses_count:10*Nota:*Solo disponible con PowerTrack y Historical PowerTrack. |
| seguidores_conteo: | Coincide con Posts cuando el autor tiene un número de seguidores dentro del rango indicado. Si se especifica un único número, coincidirá con cualquier número igual o superior. Se puede especificar un rango para coincidir con cualquier número dentro de ese rango (p. ej., followers_count:1000..10000).*Nota:*Solo disponible con PowerTrack y Historical PowerTrack. |
| amigos_conteo: | Coincide con los Posts cuando el autor tiene un recuento de amigos (el número de usuarios a los que sigue) dentro del rango especificado. Si se especifica un solo número, coincidirá cualquier número igual o mayor. Se puede especificar un rango para coincidir con cualquier número dentro de ese rango (por ejemplo, friends_count:1000..10000).*Nota:*Disponible únicamente con PowerTrack y Historical PowerTrack. |
| incluido en una lista_conteo: | Coincide con Posts cuando el autor ha sido añadido a listas en X un cierto número de veces dentro del rango indicado. Si se especifica un único número, coincidirá cualquier número igual o superior. Se puede especificar un rango para coincidir con cualquier número del rango (p. ej., listed_count:10..100).*Nota:*Solo disponible con PowerTrack y Historical PowerTrack. |
| $ | Coincide con cualquier Post que contenga la entidad de «cashtag» especificada. Ejemplo: ($TWTR OR $TSLA OR $BRK.A) -$F*Nota:*El operador de cashtag se basa en X’la extracción de la entidad ‘symbols’ para hacer coincidir cashtags, en lugar de extraerlos del cuerpo del mensaje. |
| retuits_de: | Coincide con Posts que son retweets de un usuario especificado. Admite tanto nombres de usuario como id numéricas de cuentas de X (NO id de estado de Posts). Ejemplo: (retweets_of:2244994945 OR retweets_of:api OR retweets_of:twittereng) -retweets_of:jack |
| retuits_de_estado_id: | Entregue únicamente Retweets explícitos del Post especificado. Use el id de un Post original y no el de un Retweet. Ejemplo: retweets_of_status_id:1293593516040269825*Nota:*Solo disponible con PowerTrack y Historical PowerTrack. |
| en_responder_a_estado_id: | Entrega únicamente respuestas explícitas al Post especificado. Ejemplo: in_reply_to_status_id:1293593516040269825*Nota:*Disponible únicamente con PowerTrack y Historical PowerTrack. |
| ejemplo: | Devuelve una muestra aleatoria de Posts que cumplen una regla. El porcentaje de la muestra debe ser un entero entre 1 y 100. El operador reduce el alcance al X% y luego se aplica la regla o el filtro a ese subconjunto muestreado. Ejemplo: #felizcumpleaños sample:5"feliz cumpleaños"~5 sample:80*Nota:*Solo disponible con PowerTrack y Historical PowerTrack. |
| source: | Coincide con cualquier Post generado por la App de origen especificada. El valor puede ser el nombre de la App o la URL de la App. Ejemplo: #FelizCumpleaños source:"X for iPhone""Esta es una X de prueba desde mi App de pruebas" source:MyTestAppName*Nota:*El operador source busca en el atributo source del Post y no puede usarse por sí solo. |
| idioma: | Coincide con los Posts que X clasifica como pertenecientes a un idioma específico. Actualmente, los Posts se clasifican en un único idioma, por lo que intentar hacer coincidir varios idiomas no arroja resultados.No se recomienda usarlo por sí solo. |
| Amárico: am | Alemán: de | Malabar: 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 |
| Operador | Descripción |
|---|---|
| ubicación | Coincide con los Posts etiquetados con la ubicación especificada o con el X place ID. Los nombres de lugares de varias palabras deben ir entre comillas. Ejemplo: (place:London OR place:"Great Britain") -place:USAplace:fd70c22040963ac7**Nota:**Consulte elGET geo/searchendpoint público de la API para obtener los id de lugares de X. **Nota:**No coincidirá con los Retweets ni con los Quote Tweets, ya que los lugares de los Retweets están asociados al Post original. |
| lugar_país | Coincide con los Posts cuyo código de país asociado al lugar o ubicación etiquetado coincide con el código ISO alfa-2 proporcionado. Ejemplo: place_country:GB OR place_country:AU OR place_country:CA**Nota:**No coincidirá con Retweets ni con Tweets citados, ya que los lugares del Retweet están asociados al Post original. Códigos ISO válidos:ISO 3166-1 alfa-2. |
| punto_radius:[lon lat radius] | Coincide con la ubicación exacta (x,y) del Post o con un polígono geográfico de “Place” dentro del radio definido. - Radio:<25 mi - Unidades admitidas: mi, km - Longitud: ±180 - Latitud: ±90 Las coordenadas están en grados decimales. Los argumentos van entre corchetes y se separan 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 con Tweets citados. |
| acotación_box:[west_sur largo_lat este_norte largo_lat] | Coincide con Ubicación exacta o con un polígono geográfico de “Place” completamente contenido en un cuadro delimitador. Los argumentos van entre corchetes y se separan por espacios. Coordenadas: grados decimales (±180 long., ±90 lat.). El ancho y la altura deben ser<25 mi Ejemplo: bounding_box:[-105.301758 39.964069 -105.178505 40.09455]**Nota:**No coincidirá con Retweets ni con Tweets citados. |
| perfil_país | Coincide con Posts cuyo código de país geográfico del perfil del autor coincide con un código de dos letras ISO‑3166‑1‑alpha‑2 especificado. |
| perfil_región | Coincide con el campo “region” del enriquecimiento geográfico del perfil del autor; es una coincidencia exacta de la cadena completa. Usa comillas dobles para cadenas que contengan espacios en blanco o signos de puntuación. Ejemplo: profile_region:"Nueva York" |
| perfil_localidad | Coincidencias en el campo “locality” del enriquecimiento geográfico del perfil del autor, con 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" |
| perfil_subregión | Coincide con el campo “subRegion” del enriquecimiento geográfico del perfil del autor, incluidos condados o áreas metropolitanas específicos. Una coincidencia exacta de la cadena completa. Ejemplo: profile_subregion:"Condado de Santa Clara" |
| has:geo | Hace coincidir Posts con datos de ubicación específicos del Post de X, incluidos los datos “geo” (lat‑long) o los datos de ubicación “Place” con un nombre visible y un polígono geográfico. **Nota:**Con la Search API, debe combinarse con operadores que no sean es:otiene:operadores. |
| has:profile_geo | Hace coincidir Posts que tengan cualquier metadato de Profile Geo, sin importar su valor. Alias disponible: has:derived_user_geo.**Nota:**Con la API de búsqueda, debe combinarse con operadores que no sean is:otiene:operadores. |
| has:links | Coincide con Posts que incluyan un enlace o contenido multimedia referenciado en el”texto”objeto del payload, incluidos el contenido multimedia y los Quote Tweets. **Nota:**Con la Search API, debe combinarse con operadores que no sean is: o has:``is:otiene:operadores. |
| is:retweet | Entrega únicamente retweets explícitos. Puede negarse para excluir los retweets y entregar solo contenido original. Este operador busca solo Retweets auténticos y no Tweets citados. **Nota:**Con la Search API, debe combinarse con operadores que no sean is: o has:``is:otiene:operadores. |
| es:respuesta | Devuelve solo respuestas explícitas. Puede negarse para excluir las respuestas. PowerTrack hace coincidir las respuestas a Publicaciones originales, las respuestas en Publicaciones citadas y las respuestas en Retweets. La Search API solo devuelve coincidencias de respuestas a Publicaciones originales. Ejemplo: @XDevelopers -is:reply |
| is:quote | Devuelve solo Tweets citados o Posts que hacen referencia a otro Post. Puede negarse para excluir los Tweets citados. 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 | Coincide con Posts que mencionan a otro usuario de X. **Nota:**Con la Search API, debe combinarse con operadores no is:otiene:operadores. |
| has:hashtags | Coincide con Posts que contienen un hashtag. **Nota:**Con la Search API, debe combinarse con operadores que no sean is:otiene:operadores. |
| has:media | Coincide con Posts que contienen una URL de medios clasificada por X (p. ej., pic.x.com). Alias disponible: has:enlace_de_medio.**Nota:**Con la Search API, debe combinarse con operadores que no sean is:otiene:operadores. |
| has:images | Coincide con Posts que contienen una URL de contenido multimedia (p. ej., pic.x.com). **Nota:**Con la Search API, debe combinarse con operadores que no sean es:otiene:operadores. |
| has:videos | Coincide con Posts que contienen videos nativos de X cargados en X. Alias disponible: has:video_link.Este operador no coincide con videos de YouTube, Periscope ni de otros sitios de alojamiento de videos. **Nota:**Con la Search API, debe combinarse con operadores que no sean is:otiene:operadores. |
| has:symbols | Coincide con los Posts que contienen un símbolo de cashtag (p. ej., $TWTR). **Nota:**Con Search API, debe combinarse con operadores que no sean is: ni has:``is:otiene:operadores. |
Operadores por producto
Reglas y filtrado: Empresarial
| Operador | Producto | Descripción | Coincidencias en el elemento del payload |
|---|---|---|---|
| ”coincidencia exacta de frase” | PowerTrack Buscar | Coincide con una frase exacta en el cuerpo de un Post. Los componentes que puedan convertirse en operadores de búsqueda se tratarán como palabras. En otras palabras: - "#hashtag"hará coincidirhashtagpero no#hashtag(usa eloperador de etiquetasin comillas para que coincida con hashtags reales)- "$TWTR"coincidirá con la palabraTWTRpero no el cashtag$TWTR(usa eloperador de cashtagsin comillas para hacer coincidir cashtags reales)**Nota:**En 30 Day Search y Full Archive Search (Empresarial y Premium), la puntuación no se tokeniza y, en su lugar, se trata como espacio en blanco. | texto |
| @ | PowerTrack Buscar | Coincide con cualquier Post que mencione el nombre de 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 de laGET users/lookupextremo). | entities.user_mentions |
| # | PowerTrack Buscar | Coincide con cualquier Post que contenga el hashtag indicado. Este operador realiza una coincidencia exacta. Por ejemplo, esto significa que la regla #1989coincidirá con los Posts que contengan el hashtag exacto#1989, pero no los que llevan el hashtag#TaylorSwift1989.**Nota:**este operador se basa en X’usa la extracción de entidades para hacer coincidir hashtags, en lugar de extraer el hashtag del cuerpo en sí. Para obtener más información sobre los atributos JSON de las entidades, consultaEntidades de X. | entities.hashtags |
| $ | PowerTrack Buscar | Coincide con cualquier Post que contenga el cashtag especificado (donde el carácter inicial del token sea$).Nota: este operador depende de X’usa la extracción de entidades para hacer coincidir enlaces, en lugar de extraer el enlace del propio cuerpo. Para obtener más detalles sobre los atributos JSON de las entidades, consultaEntidades de X. | entities.symbols |
| biografía: | PowerTrack | Alias disponible: usuario_biografía: Coincide con una palabra clave (mediante coincidencia tokenizada) o con una frase dentro de la biografía del usuario de un Post. Use comillas dobles para hacer coincidir una frase. En otras palabras: - bio:ingeniero de softwarecoincidirá con Posts que contengan la palabra claveingenierode usuarios que contengan la palabrasoftwareen su bio- bio:"ingeniero de software"coincidirá con cualquier Post de usuarios que incluya la fraseingeniería de softwareen su perfil | user``.description |
| bio_ubicación: | PowerTrack | Alias disponible: usuario_biografía_Ubicación: Coincide con los Posts dondeObjeto de Usuario’la ubicación contiene la palabra clave especificada (mediante coincidencia tokenizada) o la frase. Esta ubicación es una cadena no normalizada, generada por el usuario y de formato libre, y es diferente de una Post’la ubicación de una publicación (cuando esté disponible). | user.location |
| bio_nombre: | PowerTrack | Coincide con los Posts donde elObjeto de Usuario’el nombre contiene la palabra clave especificada (usando coincidencia por tokens) o la frase. | user.name |
| acotación_cuadro: | PowerTrack Buscar | Alias disponible: geo_acotación_cuadro: Coincide con la ubicación exacta (long., lat.) del Post (cuando esté presente) y con un polígono geográfico (cuando el Place esté completamente contenido dentro de la región definida). - oeste_longitud sur_lat representa la esquina suroeste del cuadro delimitador, donde west-long es la longitud de ese punto y south_lat es la latitud. - este_largo y norte_lat representa la esquina noreste del cuadro delimitador, donde este_long es la longitud de ese punto y north_lat es la latitud. - El ancho y la altura del cuadro delimitador deben ser menores que 25 mi - La longitud está en el intervalo de ±180 - La latitud está en el intervalo de ±90 - Todas las coordenadas están en grados decimales. - Los argumentos de la regla están entre corchetes, separados por espacios. **Nota:**Los operadores que coincidan en place (Post geo) solo incluirán coincidencias de Posts originales. Los Retweets no contienen ningún dato de lugar. | place(solo Posts originales) |
| contiene: | PowerTrack | Coincidencia de subcadenas para Posts que contienen la subcadena indicada en el cuerpo, sin importar la tokenización. En otras palabras, realiza una coincidencia estricta de subcadena y no tiene en cuenta los límites de palabra. Usa comillas dobles para coincidir subcadenas que contengan espacios en blanco o signos de puntuación. | texto |
| <emoji> | PowerTrack Buscar | Coincide con un emoji en el cuerpo de un Post. Esta es una coincidencia tokenizada, por lo que tu emoji se comparará con el texto tokenizado del cuerpo del Post. La tokenización se basa en caracteres de puntuación, símbolos/emoji y separadores del plano básico de Unicode. Por ejemplo, un Post con el texto “I like 🍕” se dividiría en los siguientes tokens: I, like, 🍕. Luego, estos tokens se compararían con el emoji usado en tu regla. **Nota:**si un emoji tiene una variante, debes usar comillas dobles para añadirlo a una regla. | texto |
| seguidores_conteo: | PowerTrack | Coincide con los Posts cuyo autor tiene un número de seguidores dentro del rango especificado. - Un único número (p. ej. followers_count:42) coincidirá con cualquier número igual o superior al valor especificado.- Un intervalo (p. ej. followers_count:42..1337) coincidirá con cualquier número dentro del rango indicado. | user.followers_count |
| amigos_conteo: | PowerTrack | Alias disponible: siguiendo_conteo: Coincide con Posts cuando el autor tiene una cantidad de amigos (el número de usuarios a los que sigue) que se encuentra dentro del rango indicado. - Un solo número (p. ej., followers_count:42) coincidirá con cualquier número igual o superior al valor especificado.- Un rango (p. ej., followers_count:42..1337) coincidirá con cualquier número dentro del rango especificado. | user.friends_count |
| de: | PowerTrack Buscar | 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 o (obtenido, por ejemplo, a través delGET users/lookupextremo). | user.id,user.id_str(si se usa el id de usuario)user.screen_name(si se usa el usuario) |
| has:geo | PowerTrack Buscar | Coincide con Posts que contienen datos de geolocalización específicos del Post proporcionados por X. Puede ser una coordenada de latitud-longitud en “geo” o una “ubicación” en forma de un XLugares, con el nombre para mostrar correspondiente, el polígono geográfico y otros fields. No se puede usar como operador autónomo. **Nota:**Los operadores que hacen coincidencias en place (Post geo) solo incluirán resultados de publicaciones originales. Los Retweets no contienen ningún dato de place. | place(Tweets originales únicamente) |
| has:hashtags | PowerTrack Buscar | Hace coincidir Posts que contienen al menos un hashtag. No puede usarse como operador autónomo. | entities.hashtags |
| has:images | PowerTrack Buscar | Coincide con los Posts que contienen al menos una URL de imagen clasificada. No se puede usar como operador autónomo. | entities.media |
| has:lang | PowerTrack | Coincide con Posts que X ha clasificado como pertenecientes a un idioma específico. Si un Post no ha sido clasificado, el operador no coincidirá. Actualmente, cada Post solo se clasifica en un idioma, por lo que combinar varios idiomas con AND no arrojará resultados. No se puede usar como operador autónomo. | langcuando el valor no seaund |
| has:links | PowerTrack Buscar | Este operador devuelve Posts que contienen enlaces en el cuerpo del Post. No se puede usar como operador independiente. **Nota:**este operador depende de X’s extracción de entidades para hacer coincidir los enlaces, en lugar de extraer el enlace del cuerpo. Para obtener más detalles sobre los atributos JSON de las entidades, consultaEntidades de X. | entities.urls |
| has:media | PowerTrack Buscar | Alias disponible: Alias disponible: has:media_link Coincide con publicaciones que contienen al menos una URL de medio categorizada. No se puede usar como operador independiente._vínculo Coincide con Posts que contienen al menos una URL de contenido multimedia clasificada. No se puede usar como operador autónomo. | entities.media |
| has:mentions | PowerTrack Buscar | Coincide con Posts que mencionan a otro usuario de X. No se puede usar como operador independiente. | entities.user_mentions |
| has:profile_geo | PowerTrack Buscar | Alias disponible: has:derivado_usuario_geo Coincide con los Posts que tenganGeo de perfilmetadatos, independientemente del valor concreto. No se puede usar como operador autónomo. | user.location |
| has:symbols | PowerTrack Empresarial | Coincide con Posts que contienen un símbolo de cashtag (p. ej.$TWTR).No se puede usar como operador autónomo. | entities.symbols |
| has:videos | PowerTrack Buscar | Alias disponible: has:video_vínculo Coincide con los Posts que contienen al menos una URL de contenido multimedia clasificada. No puede usarse como operador autónomo. | entities.media |
| en_responder_a_estado_id: | PowerTrack | Alias disponible: en_respuesta_a_Tweet_id: Devuelve solo las respuestas explícitas al Post especificado. | id,id_strdel Post objetivo |
| es:cita | PowerTrack | Entregar Quote Tweets explícitos que coincidan con una regla. También puede negarse ( -is:quote) para excluir de la entrega los Quote Tweets que coincidan con una regla.No puede usarse como operador autónomo. | is_quote_status(sitrue) |
| is:respuesta | PowerTrack Buscar | Devuelve solo las respuestas que cumplan una regla. También puede negarse ( -is:reply) para excluir el envío de respuestas que coincidan con la regla especificada.Con PowerTrack, este operador hace coincidencia con: - Respuestas a una publicación original - Respuestas en Posts con cita - Respuestas en Retweets Cuando se usa con la Search API, este operador coincide con las respuestas a un Post original, pero excluye las respuestas en Tweets citados y en Retweets. Puedes usar estos operadores en conjunto con is:retweetyis:quotepara entregar únicamente respuestas a Publicaciones originales.No se puede usar como operador autónomo con la Search API. Nota: con Premium, este operador no está disponible en los entornos de desarrollo de Sandbox. | Elementos de respuesta, p. ej.:in_reply_to_status_id |
| is:retweet | PowerTrack Buscar | Entregar únicamente los Retweets explícitos que coincidan con una regla. También puede negarse ( -is:retweet) para excluir de la entrega los Retweets que coincidan con una regla y entregar solo contenido original.Este operador solo busca Retweets auténticos (es decir, Retweets publicados con el botón Retweet). Los Tweets citados y las Publicaciones modificadas que no usan X’La funcionalidad de Retweet de X no será asociada por este operador. No se puede usar como operador autónomo. | Elementos de Retweet, p. ej.:retweeted_status |
| is:verified | PowerTrack Buscar | Entregar solo Posts cuyo autor esté verificado por X. También se puede negar para excluir Posts cuyo autor esté verificado. No se puede usar como operador independiente. | user.verified |
| palabra clave | PowerTrack Buscar | Coincide con una palabra clave en el cuerpo de un Post. Esta es una coincidencia tokenizada, lo que significa que tu cadena de palabras clave se comparará con el texto tokenizado del cuerpo del Post. La tokenización se basa en signos de puntuación, símbolos/emoji y caracteres separadores del plano básico de Unicode. Por ejemplo, un Post con el texto “I like coca-cola” se dividiría en los siguientes tokens: Yo,Me gusta,coca,queue. Estos tokens se compararían con la cadena de palabras clave usada en tu regla. Para hacer coincidir cadenas que contengan signos de puntuación (p. ej., coca-cola), símbolos o caracteres separadores, debes usar uncoincidencia de frase exactaoperador. | texto |
| lang: | PowerTrack Buscar | Coincide con Posts que X ha clasificado como de un idioma específico (solo si la publicación ha sido clasificada). Cada Post se clasificará con un único idioma, por lo que combinar varios idiomas con AND no devolverá resultados. Nota: si no se puede determinar el idioma, el resultado proporcionado es und(para undefined).Este operador solo coincidirá con los idiomas admitidos. Proporcionar cualquier otro valor (incluido and) hará que se ignore el operador (es decir, las publicaciones no se filtrarán mediante este operador). La siguiente lista muestra los idiomas actualmente compatibles y su correspondiente identificador de idioma BCP 47:amAmháricohuHúngaroptPortuguésarÁrabeesIslandésroRumanohyArmenioinIndonesioruRusobnBengalíitItalianosrSerbiobgBúlgarojaJaponéssdSindhimiBirmanoknKanaréssiCingalészhChinokmJemerskEslovacocsChecokoCoreanoslEslovenodaDanésloLaockbKurdo soranínlHolandéslvLetónesEspañolenInglésltLituanosvSuecoetEstoniomlMalayalamtlTagalo (tagalo)fiFinlandésdvMaldivo/ataTamilfrFrancéssrMaratíteTélugukaGeorgioneNepalíjuTailandiadeAlemánnoNoruegoboTibetanoelGriegooOdiatrTurcoguGuyaratípaPanyabíukUcranianohtHaitípsPastúnurUrduheHebreofaPersaugUigurholaHindiplPolacoviVietnamita«cy»Galés | langcuando el valor no seay |
| listado_conteo: | PowerTrack | Alias disponible: usuario_en_Listas_conteo: Coincide con Posts cuando la cantidad de veces que el autor ha sido añadido a listas en X cae dentro del rango indicado. - Un único número (p. ej. listed_count:42) coincidirá con cualquier número igual o superior al valor especificado.- Un intervalo (p. ej. listed_count:42..1337) coincidirá con cualquier número dentro del rango especificado. | user.listed_count |
| lugar_país: | PowerTrack Buscar | Coincide con Posts en los que el código de país asociado a una etiquetalugar/ubicacióncoincide con el proporcionadocódigo de país ISO alfa-2. **Nota:**Los operadores que hagan coincidencias en place (geo del Post) solo incluirán coincidencias de Posts originales. Los retweets no contienen ningún dato de place. | place(solo Posts originales) |
| ubicación: | PowerTrack Buscar | Coincide con los Posts etiquetados con la ubicación especificada oID de lugar de X. Los nombres de lugares de varias palabras deben ir entre comillas (p. ej.place:"San Francisco")**Nota:**Los operadores que coinciden en place (geo de Post) solo incluirán coincidencias de publicaciones originales. Los retweets no contienen ningún dato de place. | place(solo Posts originales) |
| punto_radio: | PowerTrack Buscar | **Nota:**Los operadores que coinciden en place (Post geo) solo incluirán resultados de publicaciones originales. Los retweets no contienen datos de lugar. | place(solo publicaciones originales) |
| perfil_acotación_box:[west_sur largo_lat este_norte largo_lat] | PowerTrack | Coincidencias contra el usuario’ubicación exacta (long., lat.) en laEnriquecimiento de geolocalización del perfildonde el Place está totalmente contenido dentro de la región definida. - oeste_sur largo_lat representa la esquina suroeste del cuadro delimitador, donde west-long es la longitud de ese punto y south_lat es la latitud. - este (este)_long y north_lat representa 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 intervalo de ±180 - La latitud está en el intervalo de ±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 coinciden en place (geolocalización de Post) solo incluirán coincidencias de publicaciones originales. Los retweets no contienen datos de lugar. | user.derived.locations.geo.coordinates |
| perfil_país: | PowerTrack Buscar | Coincidencia exacta con el código de país delEnriquecimiento geográfico del perfil. Utiliza un conjunto normalizado de códigos de país de dos letras, basado enEspecificación ISO 3166-1 alfa-2. Para ser concisos, este operador se ofrece en lugar del operador correspondiente al campo country del objeto address. **Nota:**Los operadores que hagan coincidencia en place (Post geo) solo devolverán coincidencias de publicaciones originales. Los retweets no contienen ningún dato de place. | user.derived.locations.country_code |
| perfil_localidad: | PowerTrack Buscar | Coincidencia exacta en el campo Localidad de laEnriquecimiento geográfico del perfil. Esto es una coincidencia exacta de la cadena completa. No es necesario escapar caracteres con una barra invertida. Por ejemplo, si desea hacer coincidir algo con una barra, use one/two.Usa comillas dobles para coincidir con subcadenas que contengan espacios o signos de puntuación, p. ej. profile_locality:"Lower East Side". | user.derived.locations.locality |
| perfil_punto_radio:[lon lat radio] | PowerTrack | Coincide con la ubicación exacta (x,y) del usuario’sEnriquecimiento geográfico del perfil. - Se admiten millas (mi) y kilómetros (km) como unidades de radio. - El radio debe ser inferior a 25 mi. - La longitud está en el intervalo 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 y se separan con espacios. **Nota:**Los operadores que hacen coincidencia en place (Post geo) solo devolverán coincidencias de publicaciones originales. Los Retweets no contienen datos de lugar. | user.derived.locations.geo |
| perfil_región: | PowerTrack Buscar | Coincidencia exacta en el campo Región de laEnriquecimiento geográfico del perfil. Es una coincidencia exacta de la cadena completa. No es necesario escapar caracteres con una barra invertida. Por ejemplo, si quieres hacer coincidir algo que lleve una barra, usa uno/dos.Usa comillas dobles para hacer coincidir subcadenas que contengan espacios en blanco o signos de puntuación, p. ej. profile_locality:"Nueva York". | user.derived.locations.region |
| perfil_subregión: | PowerTrack | Coincidencia exacta en el campo Subregion de laEnriquecimiento geográfico del perfil. Esta es una coincidencia exacta de la cadena completa. No es necesario escapar caracteres con una barra invertida. Por ejemplo, si desea hacer coincidir algo que incluya una barra, use uno/dos.Usa comillas dobles para hacer coincidir subcadenas que incluyan espacios o signos de puntuación, p. ej. profile_locality:"Kings County". | user.derived.locations.sub_region |
| ”palabra clave 1 palabra clave 2”~N | PowerTrack Buscar | Comúnmente denominado operador de proximidad, esto coincide con un Post en el que las palabras clave están a no 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 entre sí. Puede tener cualquier cantidad de palabras clave entre comillas. N no puede ser mayor que 6. | text |
| retuits_de_estado_id: | PowerTrack | Alias disponible: retuits_de_Tweet_id: Entregar únicamente los Retweets explícitos del Post original especificado. | retweeted_status.id,retweeted_status.id_str |
| retweets_de: | PowerTrack Buscar | Alias disponible: retweets_de_usuario: Coincide con cualquier Post que sea un Retweet del usuario especificado. El valor puede ser el nombre de usuario (excluyendo el @carácter), el id numérico del usuario o (obtenido, por ejemplo, a través delGET users/lookupextremo). | retweeted_status.id(si está presente) |
| ejemplo: | PowerTrack | Devuelve una muestra porcentual aleatoria de Posts que cumplen una regla, en lugar del conjunto completo de Posts. El valor del porcentaje debe representarse como un número entero entre 1 y 100. Este operador se aplica a toda la regla y requiere que todos los OR’términos d que se van a agrupar. **Nota:**el operador sample primero reduce el alcance del firehose al X%, luego se aplica la regla/filtro a ese subconjunto muestreado. Si está utilizando, por ejemplo, sample:10, cada Post tiene un 10% de probabilidad de aparecer en la muestra.**Nota:**El muestreo es determinista y obtendrás la misma muestra de data en tiempo real que si extrajeras la data de manera histórica. | |
| source: | PowerTrack | Coincide con cualquier Post generado por la App de origen indicada. El valor debe ser el nombre de la App o la URL de la App. No se puede usar como operador autónomo. | source |
| Estados_recuento: | PowerTrack | Alias disponible: Tweets_recuento: Coincide con los Posts cuando el autor ha publicado una cantidad de estados dentro del rango especificado. - Un único número (p. ej. statuses_count:42) coincidirá con cualquier número igual o superior al valor especificado.- Un intervalo (p. ej. statuses_count:42..1337) coincidirá con cualquier número dentro del rango indicado. | user``.statuses_count |
| para: | PowerTrack Buscar | Coincide con cualquier Post que sea una respuesta a 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 delGET users/lookupendpoint). | texto |
| url: | PowerTrack Buscar | Realiza una coincidencia tokenizada en las URL expandidas de un Post. Los tokens y las frases que contengan signos de puntuación o caracteres especiales deben encerrarse entre comillas dobles (p. ej.url:"/developer").Aunque por lo general no se recomienda, el operador también puede hacer coincidir un protocolo específico, entre comillas dobles (p. ej. url:"https://developer.x.com"). | entities.urls.expanded_url |
| url_contiene: | PowerTrack | Realiza una coincidencia de palabra clave o frase en el (nuevo)enriquecimiento de metadatos del título de la URL expandida. | entities.urls.expanded_url |
| url_descripción: | PowerTrack | Alias disponible: dentro de_url_descripción: Realiza una coincidencia de palabra/frase clave en el (nuevo)enriquecimiento de metadatos de la descripción de página ampliada. | entities.urls.unwound.description |
| url_título: | PowerTrack | Alias disponible: dentro de_url_title: Realiza una coincidencia de palabra o frase en el (nuevo)enriquecimiento de metadatos del título de la URL expandida. | entities.urls.title |