La lista de operadores de búsqueda avanzada de X: qué acepta el buscador web y qué rechaza la API

¿Cómo es la lista completa de operadores de búsqueda avanzada de X?

Dos conjuntos documentados forman la lista de operadores de búsqueda avanzada de X: los campos que el centro de ayuda de X expone a través del formulario de búsqueda avanzada en x.com, y los operadores que la documentación para desarrolladores de X define para los endpoints de búsqueda v2. Los conjuntos coinciden en palabras clave, cuentas e idioma, y luego se separan en fechas, umbrales de engagement y geografía, porque el buscador web conservó la sintaxis de la API estándar v1.1 retirada mientras que v2 recibió nombres de operador nuevos. Comprueba en qué lado de esa separación estás antes de escribir un solo carácter.

Función	Operador	Qué encuentra	Buscador web	X API v2
Contenido	keyword	Una palabra tokenizada en el cuerpo del post	Sí	Sí
Contenido	"exact phrase"	Las palabras en ese orden	Sí	Sí
Contenido	#hashtag	El hashtag, coincidencia exacta	Sí	Sí
Contenido	$cashtag	Un símbolo bursátil	No verificado	Sí
Contenido	url:	Un token dentro del enlace o del enlace expandido	No verificado	Sí
Contenido	lang:en	El idioma que X asignó al post	Sí	Sí, requiere conjunción
Contenido	-term, OR, ( )	Excluir, alternar, agrupar	Sí	Sí
Cuentas	from:handle	Posts escritos por esa cuenta	Sí	Sí
Cuentas	to:handle	Respuestas dirigidas a esa cuenta	Sí	Sí
Cuentas	@handle	Posts que mencionan esa cuenta	Sí	Sí
Cuentas	list:id	Posts de los miembros de una Lista	No verificado	Sí
Cuentas	retweets_of:handle	Reposts de esa cuenta	No	Sí
Cuentas	is:verified	Posts de un autor verificado	No verificado	Sí, requiere conjunción
Cuentas	bio:, bio_name:	Texto en el perfil del autor	No	Solo Enterprise Powerstream
Engagement	min_faves:25	Al menos 25 likes	Sí	Rechazado con 400
Engagement	min_retweets:10	Al menos 10 reposts	Sí	Rechazado con 400
Engagement	min_likes:25	Al menos 25 likes	No	Sí
Engagement	min_reposts:10	Al menos 10 reposts	No	Sí
Engagement	min_replies:3	Al menos 3 respuestas	No verificado	Sí
Fechas	since:2026-08-01	Posts desde ese día en adelante	Sí	No, usa start_time
Fechas	until:2026-09-01	Posts anteriores a ese día	Sí	No, usa end_time
Fechas	start_time, end_time	Límites en ISO 8601	No	Sí, parámetros de solicitud
Fechas	since_id, until_id	Límites por ID de post	No	Sí, parámetros de solicitud
Medios	has:media, has:images, has:videos, has:links	Un adjunto o un enlace	No verificado	Sí, requiere conjunción
Medios	has:hashtags, has:cashtags, has:mentions, has:geo	Esa entidad presente en cualquier parte	No verificado	Sí, requiere conjunción
Medios	is:retweet, is:reply, is:quote	Tipo de post	No verificado	Sí, requiere conjunción
Medios	-is:nullcast	Descarta los posts solo promocionados	No	Sí, negación obligatoria
Geo	near:"San Francisco, CA"	Posts etiquetados cerca de un lugar	Sí	No
Geo	within:15mi	Radio, se usa junto a near:	Sí	No
Geo	place:seattle	Un lugar etiquetado	No	Sí
Geo	place_country:US	Un código de país ISO	No	Sí
Geo	point_radius:[2.355128 48.861118 16km]	Un círculo alrededor de una coordenada	No	Sí
Geo	bounding_box:[-105.30 39.96 -105.17 40.09]	Un rectángulo de coordenadas	No	Sí
Hilos	conversation_id:1334987486343299072	Todos los posts de un hilo	No	Sí
Hilos	in_reply_to_tweet_id:, quotes_of_tweet_id:, retweets_of_tweet_id:	Respuestas, citas y reposts de un post	No	Sí
Hilos	context:, entity:	Las anotaciones temáticas propias de X	No	Sí, entity: solo en recent search

Última verificación: 8 de septiembre de 2026

Fuentes: X Help Center, How to use advanced search, pie de página sellado 2026 X Corp, leído el 8 de septiembre de 2026. Documentación para desarrolladores de X, Search Operators y Build a query, leídos el 8 de septiembre de 2026.

¿Qué operadores funcionan en el buscador web gratuito sin clave de API?

Catorce operadores llevan un Sí en la columna web de arriba porque el centro de ayuda de X los confirma, y el resto de las entradas web son inferencias. Esa página documenta los campos del formulario de búsqueda avanzada y luego enlaza dos búsquedas prearmadas cuyas URLs deletrean la sintaxis: New Years -Resolution lang:en near:"San Francisco, CA" within:15mi since:2013-12-30 until:2014-01-02 y #WorldCup lang:en near:"Brazil" within:15mi until:2014-07-31. Trata esas dos URLs como la referencia web y prueba tú mismo cualquier cosa que vaya más allá.

X impone una condición de acceso. Su centro de ayuda indica que la búsqueda avanzada "is available when you're logged in to X.com," (está disponible cuando has iniciado sesión en X.com), así que el buscador web es gratuito, pero no libre de cuenta.

¿Qué operadores de X solo funcionan a través de la API?

Los hilos, las anotaciones y la geografía precisa son exclusivos de la API, porque esos operadores apuntan a IDs de post y a geometría de coordenadas para las que el formulario web no tiene campo. conversation_id: extrae todas las respuestas de un hilo, context: coincide con las anotaciones temáticas propias de X, y point_radius: acepta una longitud, una latitud y un radio. Recurre a la API cuando tu pregunta trate sobre la forma de una conversación y no sobre las palabras que contiene.

La longitud de la consulta es el techo real de la API. La documentación de X limita una consulta de recent search de autoservicio a 512 caracteres, la de full-archive a 1.024 y la de enterprise a 4.096, y cuenta la cadena entera. La aritmética de una lista de palabras clave cabe en una línea:

Characters = (variants x average variant length) + (OR joins x 4) + (parentheses x 2)

Veinte variantes de un nombre de producto con una media de 12 caracteres, unidas por OR dentro de un grupo:

(20 x 12) + (19 x 4) + 2 = 240 + 76 + 2 = 318 characters

Eso deja 512 menos 318 = 194 caracteres para lang:, -is:retweet y el resto en el nivel de autoservicio de recent search. Full-archive duplica el margen hasta 1.024. Presupuesta primero los filtros y gasta lo que quede en variantes, y lee cuánto cuesta la API de X por nivel y cómo funcionan sus cuotas de solicitudes antes de comprometerte con esa vía.

Adónde van los 512 caracteres de una recent search

Variantes (20 x 12 caracteres)240

Uniones OR (19 x 4)76

Paréntesis2

Libres para filtros194

¿Cómo se fijan umbrales de engagement en la búsqueda de X?

X usa nombres distintos para el mismo umbral en cada superficie, y su propia referencia de operadores lo dice en un aviso destacado: "The equivalent operators on X web search are named min_faves: and min_retweets:. Those names are not valid in the X API and will be rejected with a 400 error. Use min_likes: and min_reposts: instead." (Los operadores equivalentes en la búsqueda web de X se llaman min_faves: y min_retweets:. Esos nombres no son válidos en la API de X y se rechazarán con un error 400. Usa min_likes: y min_reposts: en su lugar.) min_replies: conserva su nombre en ambas. Cada uno acepta un entero no negativo y funciona igual en recent search y en full-archive.

Los umbrales recortan ruido y recortan intención de compra al mismo tiempo. Quien pide una recomendación de herramienta reúne dos likes, no doscientos, así que min_faves:50 borra exactamente los posts que vale la pena responder. Sube los umbrales para el seguimiento de competidores y de crisis, y ponlos a cero u omítelos cuando estés cazando intención.

¿Cómo se busca un rango de fechas exacto en X?

El buscador web acepta since: y until: con fechas YYYY-MM-DD, y la API no acepta ninguno de los dos. since:2026-08-01 until:2026-09-01 devuelve agosto en el buscador web; ese mismo rango en la API son los parámetros de solicitud start_time y end_time en ISO 8601, con since_id y until_id como equivalentes por ID de post. El centro de ayuda de X confirma que el archivo web llega hasta el primer post público de 2006, y la API divide eso en recent search con 7 días para cualquier desarrollador y full-archive hasta 2006 para los niveles de pago.

Los rangos son semiabiertos en el buscador web, así que until:2026-09-01 se detiene antes del 1 de septiembre en vez de incluirlo. Suma un día a tu fecha final cuando un informe necesite contar el último día.

¿Qué operadores de medios y de geo siguen funcionando?

Todos los operadores has: e is: están documentados para la API y ninguno para el buscador web, así que la columna de medios es donde más se equivocan las guías. La tabla de migración de X mapea los nombres antiguos de la estándar v1.1 a los nuevos: filter:links pasó a ser has:links, filter:media pasó a ser has:media, filter:images y filter:twimg pasaron a ser has:images, y filter:retweets pasó a ser is:retweet. El buscador web desciende de esa familia heredada, y por eso la sintaxis filter: sigue circulando y por eso nada de ella aparece en la documentación actual de X.

La documentación de X también se contradice con el vídeo. La referencia Search Operators lista has:video_link para vídeos nativos de X, mientras que la introducción de Search Posts y la tabla de migración listan las dos has:videos. Prueba primero has:videos y ten preparada la alternativa, porque una de las dos páginas está desactualizada y X no dice cuál.

La geografía se separa limpiamente. near: más within: pertenecen al buscador web, place:, place_country:, point_radius: y bounding_box: pertenecen a la API, y ninguna pareja funciona en el otro lado.

Tres consultas que un marketer ejecuta en X

Intención de compra, buscador web, solo operadores verificados:

("looking for" OR "recommend a" OR "alternative to" OR "switching from") (CRM OR "help desk" OR helpdesk) lang:en since:2026-08-25 -from:YourBrand

Señales de abandono hacia la competencia, buscador web, con umbrales activados para que solo salgan posts con tracción:

(@Competitor OR Competitor) (cancelled OR canceling OR "switching to") lang:en min_faves:5 since:2026-06-01 until:2026-09-01

La misma caza de intención a través de la API, donde cambian todos los nombres de operador:

("looking for" OR "any recommendations" OR "alternative to") ("project management" OR "task tracker") lang:en -is:retweet -is:nullcast -has:links min_likes:2

El orden de las operaciones decide qué devuelve cada una. X combina AND antes que OR, así que apple OR iphone ipad se evalúa como apple OR (iphone ipad), y los paréntesis de las tres consultas de arriba sostienen la estructura en vez de decorarla. La lógica booleana genérica más allá de eso pertenece a las reglas detrás de AND, OR y NOT; esta página se queda en la sintaxis específica de X.

¿Qué operadores no se pudieron verificar?

Diez familias de operadores aparecen en la documentación de X solo como nombres retirados de la estándar v1.1, lo que las deja como no verificadas en vez de funcionales: toda la familia filter:, source:, card_name:, card_domain:, include:antisocial, include:sensitive_content, filter:follows, filter:has_engagement, filter:trusted y el parámetro de solicitud geocode. El resumen de migración de X lista cada una bajo una columna Standard con la columna v2 en blanco, y el endpoint estándar v1.1 ya no existe.

El buscador web nunca migró a los nombres de v2, así que heredó esa familia antigua entera, y X no publica ninguna lista de lo que sobrevivió. Ejecuta cada operador contra una consulta que ya sabes que devuelve resultados y compara los recuentos. Lo que devuelva el conjunto sin filtrar se está ignorando en vez de aplicarse.

RedReplier vigila X junto a Reddit, Bluesky, Facebook y Hacker News en un solo sitio, ordena lo que encuentra por intención de compra y explica con IA por qué se marcó cada mención. Su monitorización de X acepta palabras clave y un sitio web en lugar de una cadena de consulta, y expone una API y un servidor MCP para Claude Code, Cursor y cualquier cliente MCP estándar. La práctica en la que encaja todo esto es el social listening, y la versión de construir o comprar de la pregunta es montar tú mismo una API de social listening.

Preguntas frecuentes

¿Funciona la búsqueda avanzada de X sin iniciar sesión?

No. El centro de ayuda de X indica que la búsqueda avanzada está disponible cuando has iniciado sesión en X.com. La búsqueda no cuesta nada, pero necesita una cuenta, así que un navegador sin sesión o un scraper sin autenticar no obtiene resultados del buscador web.

¿Por qué falla min_likes: en el buscador web?

El buscador web y la API usan nombres distintos para ese umbral. La referencia de operadores de X dice que min_likes: y min_reposts: son los nombres de la API y que min_faves: y min_retweets: son los nombres de la búsqueda web, y que los nombres web devuelven un error 400 desde la API. Cambia la pareja según la superficie que estés consultando.

¿Hasta dónde llega hacia atrás la búsqueda de X?

Hasta el primer post público de 2006 en el buscador web, según el centro de ayuda de X. La API divide ese archivo: recent search cubre los últimos 7 días para cualquier desarrollador, y full-archive search alcanza 2006 para clientes de pago por uso y enterprise.

¿Puedo usar near: y within: con la API de X?

No. near: y within: son operadores exclusivos del buscador web. Los equivalentes de la API son place:, place_country:, point_radius:[longitude latitude radius] y bounding_box:.

¿Es has:videos o has:video_link?

X documenta los dos. Su página Search Operators lista has:video_link para vídeos nativos de X, mientras que su introducción de Search Posts y su tabla de migración de v1 a v2 listan has:videos. Prueba ambos contra una consulta que sepas que devuelve posts con vídeo y quédate con el que cambie el recuento de resultados.

¿Por qué mi consulta devuelve menos posts de los que espero?

Los operadores que requieren conjunción son la causa habitual. La documentación de X indica que operadores como has:media, is:retweet y lang: no pueden ir solos en una consulta, así que necesitan al menos un operador independiente al lado, como una palabra clave o from:. La segunda causa es la precedencia: AND se enlaza con más fuerza que OR, así que pon paréntesis alrededor de cada grupo OR.

¿El límite de caracteres de la API de X cuenta caracteres o tokens?

La API de X cuenta caracteres, no tokens, y toda la cadena de la consulta cuenta contra el límite, operadores incluidos. La recent search self-serve tiene un tope de 512 caracteres, full-archive lo duplica a 1.024, y enterprise llega a 4.096. Presupuestar primero los operadores que exigen conjunción, como lang: y -is:retweet, deja más caracteres para las variantes de palabras clave.

¿Por qué -is:nullcast necesita un signo menos delante?

is:nullcast solo no es un operador válido de la API de X, la documentación exige la negación -is:nullcast. Escrito así elimina los posts solo promocionados y conserva los orgánicos en el resultado. No existe una forma positiva para pedir directamente los posts nullcast.

¿Cómo se comprueba si un operador de X no verificado, como source: o filter:trusted, sigue funcionando?

Se prueba contra una consulta que ya se sabe que devuelve resultados, una vez con el operador y otra sin él, y se comparan los conteos. Si el número no cambia, X está ignorando el operador en vez de aplicarlo. Esa prueba hace falta porque X no publica una lista de qué operadores retirados del estándar v1.1 sobrevivieron al cambio.

¿Por qué las guías de búsqueda de X más antiguas listan operadores que hoy no devuelven nada?

Muchas guías copian los nombres retirados del estándar v1.1, como toda la familia filter:, source: y card_name:, porque esos nombres funcionaban antes y casi ningún sitio los marcó formalmente como obsoletos. La tabla de migración de X solo traduce parte de ellos a nombres v2 como has:links o is:retweet y deja la columna v2 en blanco para el resto. Conviene probar cualquier operador dudoso antes de construir una consulta alrededor de él.