Operadores de búsqueda

Los operadores de X son palabras clave y símbolos que filtran publicaciones por autor, fecha, interacción, tipo de contenido, idioma, ubicación y otros atributos. La mayoría funcionan en query de Búsqueda de publicaciones y en x.com. Los marcados como exclusivos de la interfaz dependen de una sesión iniciada (tus cuentas seguidas, ubicación o red) y no funcionan mediante la API.

Nota: consulta recetas listas para copiar, ejemplos de Python y JavaScript con paginación y una comparación con los operadores de la API oficial de X v2 en la guía completa de operadores del blog.

Sintaxis básica

Los espacios entre términos equivalen a AND implícito.
OR debe escribirse en mayúsculas.
Un guion inicial (-) excluye un término, frase u operador.
Utiliza paréntesis para agrupar expresiones.
Encierra las frases exactas entre comillas dobles.

Puedes combinar aproximadamente 22–23 operadores por consulta. AND tiene prioridad sobre OR: cat OR black dog equivale a cat OR (black dog). Utiliza paréntesis para evitar ambigüedades.

Constructor visual gratuito

Sorsa Search Builder permite crear consultas sin escribir los operadores a mano. Es gratuito, no requiere iniciar sesión y ofrece filtros visuales y una vista previa de la consulta antes de incorporarla al código.

1. Palabras clave y lógica booleana

Operador	Descripción	Ejemplo
`keyword keyword`	Publicaciones con ambos términos (AND implícito).	`nasa esa`
`keyword OR keyword`	Publicaciones con cualquiera de los términos. `OR` debe escribirse en mayúsculas.	`bitcoin OR ethereum`
`"exact phrase"`	Frase exacta; también evita la corrección automática.	`"state of the art"`
`-keyword`	Excluye el término, la frase o el operador.	`crypto -scam`
`( )`	Agrupa términos para expresiones booleanas complejas.	`(AI OR "machine learning") lang:en`
`"word * word"`	Comodín dentro de una frase entre comillas: `*` sustituye una palabra.	`"this is the * time"`
`+word`	Fuerza la coincidencia exacta y evita la corrección automática y la reducción a raíces.	`+radiooooo`
`#hashtag`	Coincide con un hashtag concreto.	`#tgif`
`$cashtag`	Coincide con un símbolo bursátil o de criptomoneda.	`$TSLA`

Los plurales coinciden con sus singulares y viceversa. Los operadores buscan en el texto, el nombre público del autor, su nombre de usuario y las URL expandidas de la publicación.

2. Filtros de usuarios y cuentas

Operador	Descripción	Ejemplo
`from:username`	Publicaciones de una cuenta concreta, sin @.	`from:elonmusk`
`to:username`	Respuestas dirigidas a una cuenta concreta.	`to:openai`
`@username`	Publicaciones que mencionan una cuenta en cualquier parte del texto.	`@sorsa_app`
`list:ID`	Publicaciones de miembros de una lista pública de X. Usa el ID numérico de su URL.	`list:715919216927322112`
`filter:verified`	Solo cuentas con verificación antigua: marca azul anterior a 2023.	`AI filter:verified`
`filter:blue_verified`	Solo suscriptores de X Premium (Blue de pago).	`crypto filter:blue_verified`
`filter:follows`	Solo cuentas que sigues. Disponible únicamente en la web; no admite negación.	`filter:follows`
`filter:social`	Tu red ampliada por el algoritmo. Funciona en Top, no en Latest.	`filter:social`

3. Filtros de interacción

Operador	Descripción	Ejemplo
`min_faves:N`	Número mínimo de Me gusta.	`AI min_faves:100`
`min_retweets:N`	Número mínimo de retuits.	`crypto min_retweets:50`
`min_replies:N`	Número mínimo de respuestas.	`"product launch" min_replies:20`
`-min_faves:N`	Máximo de Me gusta mediante la forma negada.	`bitcoin -min_faves:1000`
`-min_retweets:N`	Máximo de retuits.	`news -min_retweets:500`
`-min_replies:N`	Máximo de respuestas.	`tech -min_replies:100`
`filter:has_engagement`	Al menos una interacción. Se puede negar para buscar publicaciones sin interacciones.	`from:username filter:has_engagement`

Los recuentos son aproximados para valores elevados, a partir de 1.000.

4. Multimedia y tipo de contenido

Filtros multimedia

Operador	Descripción
`filter:media`	Todos los tipos multimedia: imágenes, vídeos y GIF.
`filter:images`	Todas las imágenes, incluidos enlaces de terceros.
`filter:twimg`	Solo imágenes nativas de X: enlaces `pic.twitter.com`.
`filter:videos`	Todos los vídeos: nativos de X, YouTube insertado y otros.
`filter:native_video`	Solo vídeos de X: cargas nativas y contenido antiguo de Vine y Periscope.
`filter:consumer_video`	Solo vídeo nativo de usuarios; excluye pro/Amplify.
`filter:pro_video`	Solo vídeo profesional de X (Amplify).
`filter:spaces`	Contenido de audio de X Spaces.
`filter:links`	Cualquier URL, incluidas las multimedia. Añade `-filter:media` para limitarte a otros enlaces.
`card_name:animated_gif`	Coincide específicamente con GIF.

Tipos de publicación

Operador	Descripción
`filter:replies`	Solo respuestas a otra publicación.
`-filter:replies`	Excluye respuestas y muestra publicaciones originales de nivel superior.
`filter:nativeretweets`	Solo retuits nativos, creados con el botón de retuitear.
`include:nativeretweets`	Incluye retuits nativos, excluidos de forma predeterminada.
`filter:retweets`	Retuits antiguos con RT y publicaciones con cita.
`-filter:retweets`	Excluye los retuits por completo.
`filter:quote`	Solo publicaciones con cita.
`quoted_tweet_id:ID`	Citas de una publicación por su ID.
`quoted_user_id:ID`	Citas de un usuario por su ID.
`conversation_id:ID`	Todas las publicaciones de un hilo: respuestas directas y anidadas.

Filtros de contenido especial

Operador	Descripción
`card_name:poll2choice_text_only`	Encuestas de texto con 2 opciones.
`card_name:poll3choice_text_only`	Encuestas de texto con 3 opciones.
`card_name:poll4choice_text_only`	Encuestas de texto con 4 opciones.
`card_name:poll2choice_image`	Encuestas con imagen y 2 opciones.
`filter:news`	Enlaces a dominios de noticias reconocidos.
`filter:safe`	Excluye contenido NSFW o potencialmente sensible; no es una garantía.
`filter:hashtags`	Solo publicaciones con al menos un hashtag.
`filter:mentions`	Solo publicaciones con alguna mención con @.

5. Fechas, horas e IDs Snowflake

Operador	Formato	Descripción
`since:YYYY-MM-DD`	`since:2026-01-01`	Publicaciones desde esta fecha, incluida.
`until:YYYY-MM-DD`	`until:2026-03-01`	Publicaciones anteriores a esta fecha, excluida.
`since:YYYY-MM-DD_HH:MM:SS_UTC`	`since:2026-03-05_12:00:00_UTC`	Marca temporal precisa con zona horaria.
`since_time:UNIX`	`since_time:1142974200`	Posteriores a una marca temporal Unix en segundos.
`until_time:UNIX`	`until_time:1142974215`	Anteriores a una marca temporal Unix.
`within_time:Xd`	`within_time:2d`	De los últimos X días. También admite `h`, `m` y `s`.
`since_id:ID`	`since_id:1234567890`	Posteriores a un ID Snowflake, excluido.
`max_id:ID`	`max_id:1234567890`	Con un ID Snowflake igual o anterior al indicado, incluido.

Conversión de IDs Snowflake. Cada ID de publicación codifica su fecha de creación:

millisecond_epoch = (tweet_id >> 22) + 1288834974657

Consulta Datos históricos para recuperar conjuntos del pasado.

6. Filtros geográficos

Operador	Descripción	Ejemplo
`near:"city"`	Geolocalizadas cerca de un lugar indicado. Admite frases.	`near:"San Francisco"`
`near:me`	Cerca de tu ubicación actual; solo en la interfaz de X.	`near:me`
`within:Xkm`	Radio para `near:`. Acepta `km` o `mi`.	`earthquake near:Tokyo within:50km`
`geocode:lat,long,radius`	Ubicación precisa mediante coordenadas.	`geocode:37.77,-122.41,5km`
`place:ID`	Busca por el ID de un objeto Place de X.	`place:96683cc9126741d1`

Se estima que solo el 1–2 % de las publicaciones incluye geolocalización precisa. Si no hay coordenadas, la API recurre a la geocodificación inversa de la ubicación del perfil del usuario.

7. Idioma y origen

Idioma

Admite códigos ISO 639-1 como lang:en, lang:es, lang:fr, lang:de, lang:ja y lang:ru, además de estos códigos propios de X:

Código	Significado
`lang:und`	Idioma indefinido: solo emojis o contenido multimedia.
`lang:qme`	Solo enlaces multimedia, desde 2022.
`lang:qst`	Texto muy breve.
`lang:qht`	Solo hashtags.
`lang:qam`	Solo menciones.
`lang:qct`	Solo símbolos bursátiles o de criptomonedas.
`lang:zxx`	Solo multimedia o Twitter Card, sin texto.

Origen: aplicación de publicación

Operador	Descripción	Ejemplo
`source:client_name`	Filtra por la aplicación utilizada para publicar. Sustituye los espacios por guiones bajos.	`source:Twitter_for_iPhone`

Valores habituales: Twitter_for_iPhone, Twitter_for_Android, Twitter_Web_App, TweetDeck y twitter_ads.

8. Operadores de tarjetas y URL

Operador	Descripción
`card_domain:domain`	Coincide con el dominio de una Twitter Card. Suele equivaler a `url:`.
`card_url:domain`	Similar a `card_domain:`, pero puede devolver resultados diferentes.
`card_name:audio`	Player Cards de Spotify, SoundCloud y otros.
`card_name:player`	Cualquier Player Card.
`card_name:summary`	Tarjetas de resumen con imagen pequeña.
`card_name:summary_large_image`	Tarjetas de resumen con imagen grande.
`card_name:promo_website`	Tarjetas de sitios web promocionados.
`card_name:promo_image_convo`	Anuncios de conversación con imágenes.
`card_name:promo_video_convo`	Anuncios de conversación con vídeo.
`url:domain`	Coincide con URL de dominios y subdominios. Sustituye guiones por guiones bajos, como en `url:t_mobile.com`.

card_name: normalmente solo coincide con publicaciones de los últimos 7–8 días.

Cómo construir consultas

Un orden práctico:

Agrupa las palabras clave: (bitcoin OR ethereum OR $BTC).
Añade restricciones de contenido: lang:en, filter:images, -filter:replies.
Establece mínimos de interacción: min_faves:50, min_retweets:10.
Excluye ruido: -from:spambot, -scam, -filter:retweets.
Limita las fechas: since:2026-01-01 until:2026-03-01.

Consulta ejemplos completos con paginación, gestión de límites y 14 recetas de consultas en la guía del blog.

Limitaciones conocidas

Máximo de operadores: aproximadamente 22–23 por consulta.
Cobertura geográfica limitada: solo el 1–2 % incluye ubicación precisa.
card_name: se limita a los últimos 7–8 días.
Las cuentas privadas y suspendidas quedan excluidas de los resultados.
La detección del idioma es imperfecta en textos breves, código o publicaciones con muchos emojis.
No se indexan todas las publicaciones. Pueden excluirse las señaladas por infringir las normas de la plataforma.
La corrección automática puede ser silenciosa. Utiliza +word o "word" para forzar coincidencias exactas.
La coincidencia de URL funciona con dominios y subdominios, pero no es fiable con rutas largas.

Fuente

Esta referencia se basa en el repositorio mantenido twitter-advanced-search de Igor Brigadir, una fuente de referencia sobre el comportamiento de búsqueda de X no documentado oficialmente.

Próximos pasos

Búsqueda de publicaciones: guía del endpoint /search-tweets.
Seguimiento de menciones: estrategias para rastrear menciones de cuentas.
Paginación: cómo recorrer grandes conjuntos de resultados.
Search Builder: constructor visual gratuito.
Guía completa del blog: recetas, código y comparación con X API v2.

Primeros pasos

Conceptos básicos

Guías prácticas

Soporte y recursos

Sintaxis básica

Constructor visual gratuito

1. Palabras clave y lógica booleana

2. Filtros de usuarios y cuentas

3. Filtros de interacción

4. Multimedia y tipo de contenido

Filtros multimedia

Tipos de publicación

Filtros de contenido especial

5. Fechas, horas e IDs Snowflake

6. Filtros geográficos

7. Idioma y origen

Idioma

Origen: aplicación de publicación

8. Operadores de tarjetas y URL

Cómo construir consultas

Limitaciones conocidas

Fuente

Próximos pasos

​Sintaxis básica

​Constructor visual gratuito

​1. Palabras clave y lógica booleana

​2. Filtros de usuarios y cuentas

​3. Filtros de interacción

​4. Multimedia y tipo de contenido

​Filtros multimedia

​Tipos de publicación

​Filtros de contenido especial

​5. Fechas, horas e IDs Snowflake

​6. Filtros geográficos

​7. Idioma y origen

​Idioma

​Origen: aplicación de publicación

​8. Operadores de tarjetas y URL

​Cómo construir consultas

​Limitaciones conocidas

​Fuente

​Próximos pasos

Sintaxis básica

Constructor visual gratuito

1. Palabras clave y lógica booleana

2. Filtros de usuarios y cuentas

3. Filtros de interacción

4. Multimedia y tipo de contenido

Filtros multimedia

Tipos de publicación

Filtros de contenido especial

5. Fechas, horas e IDs Snowflake

6. Filtros geográficos

7. Idioma y origen

Idioma

Origen: aplicación de publicación

8. Operadores de tarjetas y URL

Cómo construir consultas

Limitaciones conocidas

Fuente

Próximos pasos