keyword | Autónomo | Core | Coincide con una palabra clave dentro del cuerpo de un Post. Se trata de una coincidencia tokenizada, lo que significa que tu cadena de palabra clave se comparará con el texto tokenizado del cuerpo del Post. La tokenización divide las palabras según la puntuación, los símbolos y los 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: I, like, coca, cola. Estos tokens se compararán con la cadena de palabra clave utilizada en tu consulta. Para hacer coincidir cadenas que contienen 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 | Autónomo | Principal | Coincide con un emoji dentro del cuerpo de un Post. Al igual que una palabra clave, los emojis se comparan como tokens, lo que significa que tu emoji se hará coincidir con el texto tokenizado del cuerpo del Post. Ten en cuenta que, si un emoji tiene una variante, debes colocarlo entre comillas dobles para añadirlo a una consulta. Ejemplo:(😃 O 😡) 😬 |
"coincidencia de frase exacta" | Autónomo | Núcleo | Coincide con la frase exacta dentro del cuerpo de un Post. Ejemplo:("X API" OR #v2) -"conteos recientes" |
# | Autónomo | Núcleo | Coincide con cualquier Post que contenga un hashtag reconocido, siempre que el hashtag sea una entidad reconocida en un Post. Este operador realiza una coincidencia exacta, NO una coincidencia tokenizada, lo que significa que la regla#graciascoincidirá con publicaciones que tengan exactamente el hashtag #thanku, pero no con las que tengan el hashtag #thankunext. Ejemplo:#thankunext #fanart OR @arianagrande |
@ | Autónomo | Núcleo | Coincide con cualquier Post que mencione el nombre de usuario indicado, si dicho nombre de usuario es una entidad reconocida (incluido el carácter @). Ejemplo:(@XDevelopers OR @API) -@X |
$ | Autónomo | Avanzadas | Coincide con cualquier Post que contenga el “cashtag” especificado (donde el primer carácter del token es “undefinedtwtr OR @XDevelopers -$fb` |
from: | Autónomo | Núcleo | Coincide con cualquier Post de un usuario específico. El valor puede ser el nombre de usuario (sin el carácter @) o el id numérico del usuario. Solo puedes pasar un único nombre de usuario/id porde:operador. Ejemplo:from:XDevelopers OR from:API -from:X |
para: | Autónomo | Núcleo | Coincide con cualquier Post que sea una respuesta a un usuario en particular. El valor puede ser el nombre de usuario (sin el carácter @) o el id numérico del usuario. Solo puede pasar un único nombre de usuario/id porpara:operador. Ejemplo:to:XDevelopers OR to:API -to:X |
url: | Autónomo | Núcleo | Realiza una coincidencia tokenizada en cualquier URL con formato válido de un Post. Este operador puede hacer coincidencias con el contenido de ambosurloexpanded_urlfields. Por ejemplo, un Post que contiene”Deberías consultar X Developer Labs:https://t.co/c0A36SWil4”(con la URL corta que redirige ahttps://developer.x.com) coincidirá con ambas las siguientes reglas:from:XDevelopers url:"https://developer.x.com"yfrom:XDevelopers url:"https://t.co". Los tokens y las frases que contengan signos de puntuación o caracteres especiales deben ir entre comillas dobles. |
retweets_of: | Autónomo | Principal | Coincide con Posts 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 pasar un único nombre de usuario/id porretweets_of:operador. Ejemplo:retweets_of:XDevelopers OR retweets_of:API |
contexto: | Autónomo | Núcleo | Hace coincidir Posts con un par específico de id de dominio/id de entidad. Solo puede pasar un único dominio/entidad porcontexto:operador. Ejemplo:context:domain_id.entity_id. Puedes combinar varios dominios/entidades usando el operador OR:(context:47.113922 9372198469633 OR context:11.1088514520308342784) |
entidad: | Autónomo | Núcleo | Hace coincidir Posts con un valor de cadena de entidad específico. Solo puede pasar uno únicoentity:operador. Ejemplo:entity:"declaración de cadena de entidad/lugar". Tenga en cuenta que esto solo está disponible con la búsqueda reciente. |
conversation_id: | Autónomo | Principal | Coincide con Posts que comparten un mismo id de conversación. Un id de conversación se define como el Post ID del Post que inició la conversación. A medida que se publican respuestas a un Post, incluso respuestas a respuestas, elconversation_idse agrega a su carga útil JSON. Solo puede pasar un único id de conversación porconversation_id:operador. Ejemplo:conversation_id:1334987486343299072 (from:XDevelopers OR from:API) |
list: | Autónomo | Avanzado | Coincide con Posts publicados por usuarios que sean miembros de una lista especificada. Por ejemplo, si @XDevelopers y @API fueran miembros de la Lista 123, y usted incluyeralist:123en tu consulta, la respuesta solo incluirá Posts publicados por esas cuentas. Puedes encontrar los ids de listas usando el endpoint de consulta de listas. Ejemplo:list:123 |
place: | Autónomo | Avanzadas | Coincide con Posts etiquetados con la ubicación especificada o el X place ID. Los nombres de lugares con varias palabras (“New York City”, “Palo Alto”) deben ir entre comillas. Solo puede pasar un único lugar porplace:operador. Nota: Consulta el endpoint estándar v1.1 GET geo/search para saber cómo obtener los X place IDs. Ejemplo:place:"new york city" OR place:seattle OR place:fd70c22040963ac7 |
place_country: | Autónomo | Avanzadas | Coincide con Posts cuyo código de país asociado a un lugar o ubicación etiquetado coincide con el código ISO alfa-2 indicado. Puedes encontrar una lista de códigos ISO válidos en Wikipedia. Solo puedes pasar un único código ISO porplace_country:operador. Ejemplo:place_country:US OR place_country:MX OR place_country:CA |
point_radius: | Autónomo | Avanzado | Coincide conplace.geo.coordinatesobjeto del Post cuando esté presente y, en X, frente a un polígono geográfico de Place, donde el polígono de Place esté completamente contenido dentro de la región definida.point_radius:[longitud latitud radio]. Las unidades de radio admitidas son millas (mi) y kilómetros (km). El radio debe ser inferior a 25 mi. La longitud está en el intervalo ±180. La latitud está en el intervalo ±90. Todas las coordenadas están en grados decimales. Los argumentos de la regla van entre corchetes, separados por espacios. Ejemplo:point_radius:[2.355128 48.861118 16km] OR point_radius:[-41.287336 174.761070 20mi] |
bounding_box: | Autónomo | Avanzado | Coincide con el objeto place.geo.coordinates del Post cuando está presente y, en X, con un polígono geográfico de lugar, siempre que el polígono del 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 cuadro delimitador 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 van entre corchetes y se separan por espacios. Ejemplo:bounding_box:[-105.301758 39.964069 -105.178505 40.09455] |
is:retweet | Se requiere una conjunción | Núcleo | Coincide con Retweets que cumplen el resto de la regla especificada. Este operador solo busca Retweets verdaderos (por ejemplo, los generados con el botón Retweet). Este operador no coincidirá con Quote Tweets. Ejemplo:data @XDevelopers -is:retweet |
is:reply | Se requiere una conjunción | Núcleo | Entrega solo respuestas explícitas que cumplan una regla. También puede negarse para excluir de la entrega las respuestas que cumplan una consulta. Nota: Este operador también está disponible con el endpoint de flujo filtrado. Cuando se usa con el flujo 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 | Se requiere una conjunción | Núcleo | Devuelve todos los Quote Tweets, también conocidos como Posts con comentarios. Ejemplo:"análisis de sentimientos" is:quote |
is:verified | Se requiere una conjunción | Core | Entregar solo Posts cuyos autores estén verificados por X. Ejemplo:#ahoraescuchando is:verified |
-is :nullcast | Se requiere una conjunción | Avanzado | Elimina las publicaciones creadas únicamente para promoción en ads.x.com que tengan un"source":"Twitter para anunciantes (heredado)"o"source":"Twitter para anunciantes". Este operador debe negarse. Para obtener más información sobre los Posts Nullcasted, consulta nuestra página sobre la disponibilidad de Posts. Ejemplo:"juegos móviles" -is:nullcast |
has:hashtags | Se requiere una conjunción | Núcleo | Coincide con los Posts que contienen al menos un hashtag. Ejemplo:from:XDevelopers -has:hashtags |
has:cashtags | Se requiere una conjunción | Avanzado | Coincide con Posts que contienen un símbolo de cashtag (con un carácter ‘’inicial).Porejemplo,‘tag). Ejemplo:#stonks has:cashtags` |
has:links | Se requiere una conjunción | Núcleo | Este operador devuelve Posts que contienen enlaces y contenido multimedia en el cuerpo del Post. Ejemplo:from:XDevelopers announcement has:links |
has:mentions | Se requiere una conjunción | Núcleo | Coincide con los Posts que mencionan a otro usuario de X. Ejemplo:#nowplaying has:mentions |
tiene:media | Se requiere una conjunción | Núcleo | Coincide con Posts que contienen un objeto multimedia, como una foto, un GIF o un video, según lo determine X. No coincidirá con medios creados con Periscope ni con Posts con enlaces a otros sitios de alojamiento de medios. Ejemplo:(gatitos OR cachorros) has:media |
has:images | Se requiere una conjunción | Núcleo | Coincide con los Posts que contienen una URL reconocida de una imagen. Ejemplo:#meme has:images |
has:videos | Se requiere una conjunción | Núcleo | Coincide con Posts que contienen videos nativos de X, subidos directamente a X. No coincidirá con videos creados con Periscope ni con Posts que tengan enlaces a otros sitios de alojamiento de videos. Ejemplo:#icebucketchallenge has:videos |
has:geo | Se requiere una conjunción | Avanzado | Coincide con Posts que tienen datos de geolocalización específicos del Post proporcionados por el usuario de X. Esto puede ser una ubicación en forma de un lugar de X, con el nombre visible correspondiente, polígono geográfico y otros fields, o, en casos poco frecuentes, una coordenada geográfica lat‑long. Nota: Los operadores que coinciden por lugar (geo del Post) solo incluirán coincidencias de publicaciones originales. Los Retweets no contienen datos de lugar. Ejemplo:recommend #paris has:geo -bakery |
idioma: | Se requiere una conjunción | Núcleo | Coincide con Posts que X ha clasificado como pertenecientes a un idioma específico (solo si el Post ha sido clasificado). Es importante tener en cuenta que actualmente cada Post se clasifica únicamente en un idioma, por lo que combinar varios idiomas con AND no arrojará resultados. Solo puedes pasar un único identificador de idioma BCP 47 porlang:operador. Nota: si no es posible clasificar el idioma, el resultado devuelto es «und» (indefinido). Ejemplo:recommend #paris lang:en |
