Saltar al contenido principal

Introducción a las reglas y consultas empresariales

Los productos que utilizan operadores empresariales te entregan datos sociales según las reglas de filtrado que configures. Las reglas constan 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 empresariales. Antes de comenzar a crear reglas con operadores empresariales, asegúrate de revisar la sintaxis descrita a continuación, consultar la lista de operadores disponibles y comprender las restricciones para 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 varias cláusulas con la 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 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

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 más detalles sobre la sintaxis y los requisitos de cada una.
Tipo de lógicaSintaxis del operadorDescripción
ANDsocial dataUn espacio en blanco entre dos operadores 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.
ORsocial OR dataPara 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.
NOTsocial 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 -apiLos 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.
Tenga en cuenta que los operadores pueden ser positivos o negativos. Los operadores positivos definen lo que desea incluir en los resultados. Por ejemplo, el operador 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

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

Puntuación, diacríticos y sensibilidad a mayúsculas y minúsculas

Si especifica una regla de palabra clave o hashtag con acentos o diacríticos para operadores empresariales, 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 í 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”.

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

Para agregar o eliminar una regla de un stream mediante la API, las reglas deben utilizar el formato JSON. En esencia, esto implica colocar cada regla en la siguiente estructura: {"value":"insert_rule_here"} Reglas con comillas dobles Si la regla contiene caracteres de comillas dobles (") asociados con coincidencias exactas u otros operadores, deben escaparse 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

Al usar la PowerTrack API y la Historical PowerTrack API, los operadores a continuación coincidirán con el contenido tanto del Post original que fue citado como del nuevo Tweet citado. Sin embargo, si utiliza la Search API, estos operadores solo coincidirán con el contenido del Tweet citado 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 para 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. Consulta esta tabla para ver la lista de operadores disponibles por producto. 
OperadorDescripción
palabra claveCoincide 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
emojiBusca 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”~NOperador 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.
La lista a continuación representa los idiomas actualmente admitidos y su correspondiente identificador de idioma BCP 47:
Amárico: amAlemán: deMalabar: mlEslovaco: sk
Árabe: arGriego: elMaldivo: dvEsloveno: sl
Armenio: hyGuyaratí: guMaratí: mrKurdo soraní: ckb
Vasco: euCriollo haitiano: htNepalí: neEspañol: es
Bengalí: bnHebreo: iwNoruego: noSueco: sv
Bosnio: bsHindi: hiOriya: orTagalo: tl
Búlgaro: bgHindi latinizado: hi-LatnPanyabí: paTamil: ta
Birmano: myHúngaro: huPastún: psTelugu: te
Croata: hrIslandés: isPersa: faTailandés: th
Catalán: caIndonesio: inPolaco: plTibetano: bo
Checo: csItaliano: itPortugués: ptChino tradicional: zh-TW
Danés: daJaponés: jaRumano: roTurco: tr
Neerlandés: nlCanarés: knRuso: ruUcraniano: uk
Inglés: enJemer: kmSerbio: srUrdu: ur
Estonio: etCoreano: koChino simplificado: zh-CNUigur: ug
Finés: fiLao: loSindhi: sdVietnamita: vi
Francés: frLetón: lvCingalés: siGalés: cy
Georgiano: kaLituano: lt
Ejemplo: (@XDevelopers OR to:XDevelopers) lang:es Nota: El operador de idioma coincide con el idioma específico del Post determinado por X y establecido como el atributo lang del Post. Consulte AQUÍ para obtener más información sobre los atributos JSON de X Entities. Si no se puede determinar el idioma de un Post, el lang del Post se establecerá como “und” (indefinido).
OperadorDescripción
ubicaciónCoincide 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:USA
place: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ísCoincide 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ísCoincide 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ónCoincide 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_localidadCoincidencias 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ónCoincide 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:geoHace 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 seanes:otiene:operadores.
has:profile_geoHace 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 seanis:otiene:operadores.
has:linksCoincide 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:retweetEntrega ú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:respuestaDevuelve 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:quoteDevuelve solo Tweets citados o Posts que hacen referencia a otro Post.
Puede negarse para excluir los Tweets citados.
Ejemplo: @XDevelopers is:quote
is:verifiedDevuelve solo Posts de autores «verificados». Puede negarse para excluir Posts de autores verificados.
Ejemplo: @XDevelopers is:verified
has:mentionsCoincide con Posts que mencionan a otro usuario de X.
**Nota:**Con la Search API, debe combinarse con operadores nois:otiene:operadores.
has:hashtagsCoincide con Posts que contienen un hashtag.
**Nota:**Con la Search API, debe combinarse con operadores que no seanis:otiene:operadores.
has:mediaCoincide 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 seanis:otiene:operadores.
has:imagesCoincide 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 seanes:otiene:operadores.
has:videosCoincide 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 seanis:otiene:operadores.
has:symbolsCoincide 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

Todos los operadores empresariales están disponibles con las API de PowerTrack y Historical PowerTrack. Sin embargo, solo un subconjunto de operadores está disponible para las API de Búsqueda empresariales, como se indica en esta página. Las etiquetas azul oscuro indican qué operadores están disponibles en distintos productos empresariales: Búsqueda de PowerTrack
OperadorProductoDescripciónCoincidencias 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:PowerTrackAlias 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:PowerTrackAlias 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:PowerTrackCoincide 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:PowerTrackCoincidencia 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:PowerTrackCoincide 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:PowerTrackAlias 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:geoPowerTrack

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

Buscar
Hace coincidir Posts que contienen al menos un hashtag.

No puede usarse como operador autónomo.
entities.hashtags
has:imagesPowerTrack

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:langPowerTrackCoincide 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:linksPowerTrack

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

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

Buscar
Coincide con Posts que mencionan a otro usuario de X.

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

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

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

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:PowerTrackAlias disponible: en_respuesta_a_Tweet_id:

Devuelve solo las respuestas explícitas al Post especificado.
id,id_strdel Post objetivo
es:citaPowerTrackEntregar 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:respuestaPowerTrack

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

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

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 clavePowerTrack

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 esund(para undefined).

Este operador solo coincidirá con los idiomas admitidos. Proporcionar cualquier otro valor (incluidoand) 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árico

huHúngaro

ptPortugués

arÁrabe

esIslandés

roRumano

hyArmenio

inIndonesio

ruRuso

bnBengalí

itItaliano

srSerbio

bgBúlgaro

jaJaponés

sdSindhi

miBirmano

knKanarés

siCingalés

zhChino

kmJemer

skEslovaco

csCheco

koCoreano

slEsloveno

daDanés

loLao

ckbKurdo soraní

nlHolandés

lvLetón

esEspañol

enInglés

ltLituano

svSueco

etEstonio

mlMalayalam

tlTagalo (tagalo)

fiFinlandés

dvMaldivo/a

taTamil

frFrancés

srMaratí

teTélugu

kaGeorgio

neNepalí

juTailandia

deAlemán

noNoruego

boTibetano

elGriego

oOdia

trTurco

guGuyaratí

paPanyabí

ukUcraniano

htHaití

psPastún

urUrdu

heHebreo

faPersa

ugUigur

holaHindi

plPolaco

viVietnamita

«cy»Galés
langcuando el valor no seay
listado_conteo:PowerTrackAlias 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]PowerTrackCoincidencias 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, useone/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]PowerTrackCoincide 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, usauno/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:PowerTrackCoincidencia 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, useuno/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”~NPowerTrack

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