keyword | Independiente | Core | Coincide con una palabra clave dentro del cuerpo de una Publicación. Se trata de una coincidencia tokenizada, lo que significa que tu cadena de palabra clave se comparará con el texto tokenizado del cuerpo de la Publicación. La tokenización segmenta las palabras según la puntuación, los símbolos y los caracteres separadores del plano básico de Unicode. Por ejemplo, una Publicación con el texto “I like coca-cola” se segmentaría en los siguientes tokens: I, like, coca, cola. Estos tokens se compararían luego con la cadena de palabra clave utilizada en tu consulta. Para hacer coincidir cadenas que contengan signos de puntuación (por ejemplo, coca-cola), símbolos o caracteres separadores, debes encerrar tu palabra clave entre comillas dobles. Ejemplo: pepsi OR cola OR "coca cola" |
emoji | Independiente | Core | Coincide con un emoji dentro del cuerpo de una Publicación. Similar a una palabra clave, los emojis se consideran una coincidencia tokenizada, lo que significa que tu emoji se comparará con el texto tokenizado del cuerpo de la Publicación. Ten en cuenta que, si un emoji tiene una variante, debes encerrarlo entre comillas dobles para incluirlo en una consulta. Ejemplo: (😃 OR 😡) 😬 |
"exact phrase match" | Independiente | Core | Busca la frase exacta en el cuerpo de una Publicación. Ejemplo: ("X API" OR #v2) -"recent counts" |
# | Independiente | Core | Coincide con cualquier Publicación que contenga un hashtag reconocido, siempre que el hashtag sea una entidad reconocida en una Publicación. Este operador realiza coincidencias exactas, NO coincidencias tokenizadas, lo que significa que la regla #thanku coincidirá con Publicaciones que tengan exactamente el hashtag #thanku, pero no con aquellas que tengan el hashtag #thankunext. Ejemplo: #thankunext #fanart OR @arianagrande |
@ | Independiente | Core | Coincide con cualquier Publicación que mencione el nombre de usuario indicado, siempre que el nombre de usuario sea una entidad reconocida (incluido el carácter @). Ejemplo: (@XDevelopers OR @API) -@X |
$ | Independiente | Advanced | Coincide con cualquier Publicación que contenga el “cashtag” especificado (donde el primer carácter del token es el carácter “”).Tenencuentaqueeloperadordecashtagsebasaenlaextraccioˊndeentidades“symbols”deXparaidentificarcashtags,enlugardeintentarextraerelcashtagdelcontenidodelapropiaPublicacioˊn.Ejemplo:‘twtr OR @XDevelopers -$fb` |
from: | Independiente | Core | Coincide con cualquier Publicación de un usuario específico. El valor puede ser el nombre de usuario (sin incluir el carácter @) o el id numérico del usuario. Solo puedes indicar un único nombre de usuario/id por operador from:. Ejemplo: from:XDevelopers OR from:API -from:X |
to: | Independiente | Core | Coincide con cualquier Publicación que sea una respuesta a un usuario específico. El valor puede ser el nombre de usuario (sin el carácter @) o el id numérico de usuario. Solo puedes proporcionar un único nombre de usuario/id por operador to:. Ejemplo: to:XDevelopers OR to:API -to:X |
url: | Independiente | Core | Realiza una coincidencia tokenizada en cualquier URL con formato válido de una Publicación. Este operador puede coincidir con el contenido de los campos url o expanded_url. Por ejemplo, una Publicación que contenga “You should check out X Developer Labs: https://t.co/c0A36SWil4” (donde la URL corta redirige a https://developer.x.com) coincidirá con ambas reglas siguientes: from:XDevelopers url:"https://developer.x.com" y from:XDevelopers url:"https://t.co". Los tokens y las frases que contengan signos de puntuación o caracteres especiales deben encerrarse entre comillas dobles. |
retweets_of: | Independiente | Core | Coincide con Publicaciones que son Retweets del usuario especificado. El valor puede ser el nombre de usuario (sin el carácter @) o el id numérico del usuario. Solo puedes incluir un único nombre de usuario/id por operador retweets_of:. Ejemplo: retweets_of:XDevelopers OR retweets_of:API |
context: | Independiente | Core | Coincide con Publicaciones que tienen un par específico domain id/entity id. Solo puedes pasar un único dominio/entidad por operador context:. Ejemplo: context:domain_id.entity_id. Puedes combinar varios dominios/entidades usando el operador OR: (context:47.113922 9372198469633 OR context:11.1088514520308342784) |
entity: | Independiente | Core | Coincide con Publicaciones que tengan un valor de cadena de entidad específico. Solo puedes pasar un único operador entity:. Ejemplo: entity:"string declaration of entity/place". Ten en cuenta que esto solo está disponible con la búsqueda reciente. |
conversation_id: | Independiente | Core | Coincide con las Publicaciones que comparten un mismo id de conversación. El id de conversación se establece con el id de la Publicación que inició la conversación. A medida que se publican respuestas a una Publicación, incluidas las respuestas a respuestas, el conversation_id se agrega a su carga útil JSON. Solo puedes pasar un único id de conversación por operador conversation_id:. Ejemplo: conversation_id:1334987486343299072 (from:XDevelopers OR from:API) |
list: | Independiente | Advanced | Coincide con Publicaciones de usuarios que son miembros de una Lista especificada. Por ejemplo, si @XDevelopers y @API fueran miembros de la Lista 123 e incluyeras list:123 en tu consulta, tu respuesta solo contendrá Publicaciones de esas cuentas. Puedes encontrar los ID de Lista usando el endpoint de consulta de Listas. Ejemplo: list:123 |
place: | Independiente | Advanced | Coincide con las Publicaciones etiquetadas con la ubicación especificada o con el id de lugar de X. Los nombres de lugares de varias palabras (“New York City”, “Palo Alto”) deben ir entre comillas. Solo puedes pasar un único lugar por operador place:. Nota: consulta el endpoint estándar GET geo/search de la v1.1 para saber cómo obtener ids de lugar de X. Ejemplo: place:"new york city" OR place:seattle OR place:fd70c22040963ac7 |
place_country: | Independiente | Advanced | Coincide con las Publicaciones en las que el código de país asociado a un lugar o ubicación etiquetados coincide con el código de caracteres ISO alfa-2 especificado. Puedes encontrar una lista de códigos ISO válidos en Wikipedia. Solo puedes usar un único código ISO por operador place_country:. Ejemplo: place_country:US OR place_country:MX OR place_country:CA |
point_radius: | Independiente | Advanced | Coincide con el objeto place.geo.coordinates de la Publicación cuando está presente y, en X, con un polígono geográfico de lugar, donde el polígono del lugar está completamente contenido dentro de la región definida. point_radius:[longitude latitude radius]. Las unidades de radio admitidas son millas (mi) y kilómetros (km). El radio debe ser menor que 25mi. 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 se incluyen entre corchetes y se separan por espacios. Ejemplo: point_radius:[2.355128 48.861118 16km] OR point_radius:[-41.287336 174.761070 20mi] |
bounding_box: | Independiente | Advanced | Coincide con el objeto place.geo.coordinates de la Publicación cuando está presente y, en X, con un polígono geográfico de lugar, donde el polígono de lugar está completamente contenido dentro de la región definida. bounding_box:[west_long south_lat east_long north_lat]. El ancho y la altura del bounding box deben ser inferiores a 25 mi. La longitud está en el rango de ±180. La latitud está en el rango de ±90. Todas las coordenadas están en grados decimales. Los argumentos de la regla están contenidos entre corchetes y separados por espacios. Ejemplo: bounding_box:[-105.301758 39.964069 -105.178505 40.09455] |
is:retweet | Obligatorio | Core | Coincide con Retweets que cumplan el resto de la regla especificada. Este operador solo busca Retweets verdaderos (por ejemplo, los generados mediante el botón Retweet). Los Quote Tweets no se incluirán con este operador. Ejemplo: data @XDevelopers -is:retweet |
is:reply | Obligatorio | Core | Devuelve solo respuestas explícitas que cumplan una regla. También se puede negar para excluir de la devolución las respuestas que cumplan una consulta. Nota: Este operador también está disponible en el endpoint de stream filtrado. Cuando se usa con el stream filtrado, este operador coincide con respuestas a una Publicación original, respuestas en Publicaciones citadas y respuestas en Retweets. Ejemplo: from:XDevelopers is:reply |
is:quote | Obligatorio | Core | Devuelve todos los Tweets citados, también conocidos como Publicaciones con comentarios. Ejemplo: "sentiment analysis" is:quote |
is:verified | Obligatorio | Core | Devuelve únicamente Publicaciones cuyos autores estén verificados por X. Ejemplo: #nowplaying is:verified |
-is :nullcast | Obligatorio | Advanced | Elimina Publicaciones creadas únicamente para promoción en ads.x.com que tengan "source":"Twitter for Advertisers (legacy)" o "source":"Twitter for Advertisers". Este operador debe negarse. Para obtener más información sobre Publicaciones nullcast, consulta nuestra página sobre la disponibilidad de Publicaciones. Ejemplo: "mobile games" -is:nullcast |
has:hashtags | Obligatorio | Core | Devuelve Publicaciones que contienen al menos un hashtag. Ejemplo: from:XDevelopers -has:hashtags |
has:cashtags | Obligatorio | Advanced | Coincide con Publicaciones que contienen un símbolo de cashtag (con un carácter ‘' inicial; por ejemplo, `tag). Ejemplo: #stonks has:cashtags` |
has:links | Obligatorio | Core | Este operador devuelve Publicaciones que contienen enlaces y contenido multimedia en el cuerpo de la Publicación. Ejemplo: from:XDevelopers announcement has:links |
has:mentions | Obligatorio | Core | Coincide con Publicaciones que mencionan a otro usuario de X. Ejemplo: #nowplaying has:mentions |
has:media | Obligatorio | Core | Coincide con Publicaciones que contienen un objeto multimedia, como una foto, un GIF o un video, según lo determine X. No se aplicará a contenido multimedia creado con Periscope ni a Publicaciones con enlaces a otros sitios de alojamiento de contenido multimedia. Ejemplo: (kittens OR puppies) has:media |
has:images | Obligatorio | Core | Coincide con Publicaciones que contienen una URL reconocida de una imagen. Ejemplo: #meme has:images |
has:videos | Obligatorio | Core | Devuelve Publicaciones que contienen vídeos nativos de X, cargados directamente en X. No incluirá vídeos creados con Periscope ni Publicaciones con enlaces a otros sitios de alojamiento de vídeo. Ejemplo: #icebucketchallenge has:videos |
has:geo | Obligatorio | Advanced | Coincide con Publicaciones que contienen datos de geolocalización específicos de la Publicación proporcionados por el usuario de X. Esto puede ser una ubicación en forma de un lugar de X, con el nombre para mostrar correspondiente, polígono geográfico y otros campos o, en casos poco frecuentes, unas coordenadas geográficas de latitud y longitud. Nota: Los operadores que coinciden en place (geo de la Publicación) solo incluirán coincidencias de Publicaciones originales. Los Retweets no contienen datos de lugar. Ejemplo: recommend #paris has:geo -bakery |
lang: | Obligatorio | Core | Coincide con Publicaciones que X ha clasificado como pertenecientes a un idioma concreto (únicamente si la Publicación ha sido clasificada). Es importante tener en cuenta que actualmente cada Publicación solo se clasifica en un idioma, por lo que combinar varios idiomas con AND no devolverá ningún resultado. Solo puedes indicar un único identificador de idioma BCP 47 por operador lang:. Nota: si no se puede determinar ningún idioma, el valor devuelto es und (indefinido). Ejemplo: recommend #paris lang:en |