Operadores de búsqueda de Twitter en 2026
Los operadores de búsqueda de Twitter son comandos cortos como from:, since:, min_faves: y filter:images que escribes en el cuadro de búsqueda de x.com para filtrar posts por cuenta, fecha, engagement y multimedia; una consulta admite unos 22 de ellos.
Respuesta corta: Escribe cada operador sin espacio después de los dos puntos, OR en mayúsculas y las fechas como since:2026-10-01 until:2026-11-01: la fecha final no se incluye, y las dos cuentan en UTC. La API oficial de X cambia el nombre de varios filtros. Para ejecutar desde código las consultas de x.com tal como están escritas, usa POST /search-tweets de Sorsa API: desde $0.07 por 1,000 tweets, con 100 solicitudes gratis.
- Endpoint
POST /search-tweets- Tamaño de página
- unos 20 tweets por solicitud
- Precio
- desde $0.07 por 1,000
#Cómo funcionan los operadores de búsqueda de Twitter
Un operador de búsqueda es una palabra clave con dos puntos, como from: o lang:, o un símbolo, como las comillas o un signo menos, que convierte una búsqueda simple en X en un filtro. Lo escribes en el cuadro de búsqueda de x.com o de la app, junto a tus palabras normales, y X devuelve solo los posts que cumplen todas las condiciones.
Para armar una consulta con clics en lugar de escribirla, abre la herramienta gratuita de búsqueda avanzada de Twitter. Cada filtro que defines ahí escribe su operador en la consulta, y muestra los primeros 20 posts que coinciden. El formulario propio de X en x.com/search-advanced cubre palabras, cuentas, lugares y fechas, y solo se abre con una cuenta con la sesión iniciada (Centro de ayuda de X (se abre en una pestaña nueva)).
Siete reglas deciden si una consulta funciona:
- Un espacio significa AND:
vector databaseencuentra los posts que contienen las dos palabras, en cualquier orden. ORdebe ir en mayúsculas. Un "or" en minúsculas se busca como una palabra.- Un signo menos delante excluye una palabra, una frase o un operador:
-crypto. - Las comillas dobles coinciden con una frase exacta y evitan que X corrija la ortografía.
- Los paréntesis agrupan términos. AND tiene más prioridad que OR, así que
cats OR black dogsse lee comocats OR (black dogs). - Sin espacio después de los dos puntos:
from:nasafiltra por cuenta, mientras quefrom: nasarompe el operador. - Los operadores ignoran las mayúsculas y minúsculas, y X deja de devolver resultados después de unos 22 de ellos en una consulta.
#Todos los operadores de búsqueda de Twitter, según lo que filtran
Las tablas de abajo reúnen los operadores que acepta la búsqueda web de X, agrupados por lo que filtran. X documenta solo lo básico en sus páginas de ayuda; el resto viene de años de pruebas públicas recopiladas en la referencia de Igor Brigadir en GitHub (se abre en una pestaña nueva), así que prueba un operador poco usado en una consulta pequeña antes de que un informe dependa de él.
Palabras, frases y lógica
Las palabras y las frases coinciden con el texto del post, el nombre y el handle del autor, y la forma completa de los enlaces acortados.
| Operador | Encuentra | Ejemplo |
|---|---|---|
word word | Posts con las dos palabras | nasa esa |
OR | Posts con cualquiera de los términos | rust OR golang |
"phrase" | La frase exacta, sin correcciones ortográficas | "state of the art" |
-word | Posts sin la palabra | jaguar -car |
( ) | Términos agrupados | (rust OR go) compiler |
"a * b" | Cualquier palabra en el hueco, solo entre comillas | "best * for startups" |
+word | La palabra exactamente como se escribió | +radiooooo |
#tag | Un hashtag | #buildinpublic |
$TICKER | Un cashtag | $NVDA |
? | Posts que hacen una pregunta | crm ? |
word word- Encuentra
- Posts con las dos palabras
- Ejemplo
nasa esa
OR- Encuentra
- Posts con cualquiera de los términos
- Ejemplo
rust OR golang
"phrase"- Encuentra
- La frase exacta, sin correcciones ortográficas
- Ejemplo
"state of the art"
-word- Encuentra
- Posts sin la palabra
- Ejemplo
jaguar -car
( )- Encuentra
- Términos agrupados
- Ejemplo
(rust OR go) compiler
"a * b"- Encuentra
- Cualquier palabra en el hueco, solo entre comillas
- Ejemplo
"best * for startups"
+word- Encuentra
- La palabra exactamente como se escribió
- Ejemplo
+radiooooo
#tag- Encuentra
- Un hashtag
- Ejemplo
#buildinpublic
$TICKER- Encuentra
- Un cashtag
- Ejemplo
$NVDA
?- Encuentra
- Posts que hacen una pregunta
- Ejemplo
crm ?
Cuentas
Los operadores de cuentas reciben el handle sin la @, excepto el propio operador de mención.
| Operador | Encuentra | Ejemplo |
|---|---|---|
from: | Posts escritos por una cuenta | from:nasa |
to: | Respuestas enviadas a una cuenta | to:nasa |
@handle | Posts que mencionan a una cuenta | @nasa -from:nasa |
list: | Posts de los miembros de una Lista pública, por su ID | list:1849212213712385091 |
filter:verified | Posts de cuentas verificadas | robotics filter:verified |
filter:blue_verified | Posts de suscriptores de X Premium | robotics filter:blue_verified |
filter:follows | Posts de cuentas que sigues; solo en x.com con sesión iniciada | pricing filter:follows |
filter:social | La selección de X de tu red más amplia; pestaña Top, con sesión iniciada | rust filter:social |
from:- Encuentra
- Posts escritos por una cuenta
- Ejemplo
from:nasa
to:- Encuentra
- Respuestas enviadas a una cuenta
- Ejemplo
to:nasa
@handle- Encuentra
- Posts que mencionan a una cuenta
- Ejemplo
@nasa -from:nasa
list:- Encuentra
- Posts de los miembros de una Lista pública, por su ID
- Ejemplo
list:1849212213712385091
filter:verified- Encuentra
- Posts de cuentas verificadas
- Ejemplo
robotics filter:verified
filter:blue_verified- Encuentra
- Posts de suscriptores de X Premium
- Ejemplo
robotics filter:blue_verified
filter:follows- Encuentra
- Posts de cuentas que sigues; solo en x.com con sesión iniciada
- Ejemplo
pricing filter:follows
filter:social- Encuentra
- La selección de X de tu red más amplia; pestaña Top, con sesión iniciada
- Ejemplo
rust filter:social
Engagement
Los operadores de engagement fijan un mínimo de likes, retweets o respuestas, y un signo menos delante convierte el mínimo en un máximo. Los conteos por encima de unos 1,000 son aproximados, así que los resultados cercanos a un umbral alto pueden variar un poco.
| Operador | Encuentra | Ejemplo |
|---|---|---|
min_faves: | Al menos N likes | min_faves:100 |
min_retweets: | Al menos N retweets | min_retweets:50 |
min_replies: | Al menos N respuestas | min_replies:20 |
-min_faves: | Menos de N likes | -min_faves:10 |
-min_retweets: | Menos de N retweets | -min_retweets:5 |
-min_replies: | Menos de N respuestas | -min_replies:3 |
filter:has_engagement | Posts con cualquier like, respuesta o retweet | -filter:has_engagement |
min_faves:- Encuentra
- Al menos N likes
- Ejemplo
min_faves:100
min_retweets:- Encuentra
- Al menos N retweets
- Ejemplo
min_retweets:50
min_replies:- Encuentra
- Al menos N respuestas
- Ejemplo
min_replies:20
-min_faves:- Encuentra
- Menos de N likes
- Ejemplo
-min_faves:10
-min_retweets:- Encuentra
- Menos de N retweets
- Ejemplo
-min_retweets:5
-min_replies:- Encuentra
- Menos de N respuestas
- Ejemplo
-min_replies:3
filter:has_engagement- Encuentra
- Posts con cualquier like, respuesta o retweet
- Ejemplo
-filter:has_engagement
Respuestas, retweets, citas e hilos
La búsqueda de X deja fuera por defecto los retweets nativos y conserva las respuestas, así que los dos filtros de tipo más usados son -filter:replies e include:nativeretweets.
| Operador | Encuentra | Ejemplo |
|---|---|---|
filter:replies | Solo respuestas | from:nasa filter:replies |
-filter:replies | Solo posts de primer nivel | -filter:replies from:nasa |
filter:self_threads | Las respuestas de un autor a sus propios posts | from:nasa filter:self_threads |
conversation_id: | Todos los posts de un hilo | conversation_id:2110405289047048193 |
filter:quote | Posts con cita | "launch" filter:quote |
quoted_tweet_id: | Citas de un post | quoted_tweet_id:2110405289047048193 |
quoted_user_id: | Citas de los posts de una cuenta, por ID numérico | quoted_user_id:1592041833471827968 |
include:nativeretweets | Retweets además de posts | from:nasa include:nativeretweets |
filter:nativeretweets | Solo retweets hechos con el botón | from:nasa filter:nativeretweets |
filter:retweets | Retweets y citas al estilo antiguo "RT" | from:nasa filter:retweets |
filter:replies- Encuentra
- Solo respuestas
- Ejemplo
from:nasa filter:replies
-filter:replies- Encuentra
- Solo posts de primer nivel
- Ejemplo
-filter:replies from:nasa
filter:self_threads- Encuentra
- Las respuestas de un autor a sus propios posts
- Ejemplo
from:nasa filter:self_threads
conversation_id:- Encuentra
- Todos los posts de un hilo
- Ejemplo
conversation_id:2110405289047048193
filter:quote- Encuentra
- Posts con cita
- Ejemplo
"launch" filter:quote
quoted_tweet_id:- Encuentra
- Citas de un post
- Ejemplo
quoted_tweet_id:2110405289047048193
quoted_user_id:- Encuentra
- Citas de los posts de una cuenta, por ID numérico
- Ejemplo
quoted_user_id:1592041833471827968
include:nativeretweets- Encuentra
- Retweets además de posts
- Ejemplo
from:nasa include:nativeretweets
filter:nativeretweets- Encuentra
- Solo retweets hechos con el botón
- Ejemplo
from:nasa filter:nativeretweets
filter:retweets- Encuentra
- Retweets y citas al estilo antiguo "RT"
- Ejemplo
from:nasa filter:retweets
Multimedia y enlaces
Los filtros de multimedia coinciden con lo que está adjunto a un post; los filtros de enlaces, con a lo que apunta. Todos los operadores card_name: solo llegan unos 7 días atrás, encuestas incluidas: card_name:poll2choice_text_only encuentra las encuestas de texto de dos opciones.
| Operador | Encuentra | Ejemplo |
|---|---|---|
filter:media | Cualquier imagen, video o GIF | #nyc filter:media |
filter:images | Imágenes, incluidas las enlazadas | #nyc filter:images |
filter:twimg | Imágenes subidas a X | #nyc filter:twimg |
filter:videos | Cualquier video, enlaces de YouTube incluidos | keynote filter:videos |
filter:native_video | Videos subidos a X | keynote filter:native_video |
card_name:animated_gif | GIFs | monday card_name:animated_gif |
filter:spaces | Enlaces a Spaces de X | ai filter:spaces |
filter:links | Cualquier enlace, incluidos los de multimedia | -filter:media filter:links |
url: | Enlaces a un dominio; los guiones se vuelven guiones bajos | url:github.com |
filter:news | Enlaces a sitios de noticias | election filter:news |
filter:hashtags | Posts con cualquier hashtag | from:nasa filter:hashtags |
filter:mentions | Posts que mencionan a cualquier cuenta | from:nasa filter:mentions |
filter:safe | Deja fuera los posts marcados como sensibles | anime filter:safe |
filter:media- Encuentra
- Cualquier imagen, video o GIF
- Ejemplo
#nyc filter:media
filter:images- Encuentra
- Imágenes, incluidas las enlazadas
- Ejemplo
#nyc filter:images
filter:twimg- Encuentra
- Imágenes subidas a X
- Ejemplo
#nyc filter:twimg
filter:videos- Encuentra
- Cualquier video, enlaces de YouTube incluidos
- Ejemplo
keynote filter:videos
filter:native_video- Encuentra
- Videos subidos a X
- Ejemplo
keynote filter:native_video
card_name:animated_gif- Encuentra
- GIFs
- Ejemplo
monday card_name:animated_gif
filter:spaces- Encuentra
- Enlaces a Spaces de X
- Ejemplo
ai filter:spaces
filter:links- Encuentra
- Cualquier enlace, incluidos los de multimedia
- Ejemplo
-filter:media filter:links
url:- Encuentra
- Enlaces a un dominio; los guiones se vuelven guiones bajos
- Ejemplo
url:github.com
filter:news- Encuentra
- Enlaces a sitios de noticias
- Ejemplo
election filter:news
filter:hashtags- Encuentra
- Posts con cualquier hashtag
- Ejemplo
from:nasa filter:hashtags
filter:mentions- Encuentra
- Posts que mencionan a cualquier cuenta
- Ejemplo
from:nasa filter:mentions
filter:safe- Encuentra
- Deja fuera los posts marcados como sensibles
- Ejemplo
anime filter:safe
Idioma y app
lang: recibe un código de idioma de dos letras y confía en la estimación de X, que es más débil en los posts muy cortos.
| Operador | Encuentra | Ejemplo |
|---|---|---|
lang: | Posts en un idioma | ramen lang:ja |
lang:und | Posts que X no puede clasificar, como los de solo emojis | lang:und filter:images |
lang:qme | Posts formados solo por enlaces de multimedia | lang:qme from:nasa |
source: | Posts enviados desde una app; guiones bajos en lugar de espacios | source:tweetdeck |
lang:- Encuentra
- Posts en un idioma
- Ejemplo
ramen lang:ja
lang:und- Encuentra
- Posts que X no puede clasificar, como los de solo emojis
- Ejemplo
lang:und filter:images
lang:qme- Encuentra
- Posts formados solo por enlaces de multimedia
- Ejemplo
lang:qme from:nasa
source:- Encuentra
- Posts enviados desde una app; guiones bajos en lugar de espacios
- Ejemplo
source:tweetdeck
Ubicación
Los operadores de ubicación solo ven posts que llevan un lugar o coordenadas, que es una pequeña parte de lo que publica la gente, así que una consulta de ubicación devuelve un fragmento delgado de la conversación.
| Operador | Encuentra | Ejemplo |
|---|---|---|
near: | Posts etiquetados cerca de un lugar; comillas si son dos palabras | coffee near:boston |
within: | Un radio para near:, en km o mi | coffee near:tokyo within:15km |
geocode: | Posts dentro de un radio alrededor de unas coordenadas | geocode:40.7128,-74.0060,5km |
place: | Posts etiquetados con un ID de lugar de X | place:96683cc9126741d1 |
near:- Encuentra
- Posts etiquetados cerca de un lugar; comillas si son dos palabras
- Ejemplo
coffee near:boston
within:- Encuentra
- Un radio para
near:, en km o mi - Ejemplo
coffee near:tokyo within:15km
geocode:- Encuentra
- Posts dentro de un radio alrededor de unas coordenadas
- Ejemplo
geocode:40.7128,-74.0060,5km
place:- Encuentra
- Posts etiquetados con un ID de lugar de X
- Ejemplo
place:96683cc9126741d1
Los operadores de fecha y hora vienen a continuación, en una sección propia.
#Cómo buscar en Twitter por fecha
Para buscar en X por fecha, añade since: con el primer día y until: con el día siguiente al último, los dos en formato YYYY-MM-DD: since: incluye su fecha, until: se detiene al comienzo de su fecha, y los dos días empiezan a medianoche UTC.
-
Empieza con el tema o la cuenta.
"solar eclipse", ofrom:nasapara los posts de una cuenta. -
Añade el primer día.
since:2026-10-01incluye el 1 de octubre. -
Añade el día siguiente al último.
until:2026-11-01cubre todo octubre, porque el propio 1 de noviembre queda fuera. -
Lee la pestaña Latest. Enumera todas las coincidencias en orden cronológico; Top muestra una selección clasificada.
La consulta completa es from:nasa since:2026-10-01 until:2026-11-01. Un día es since:2026-10-15 until:2026-10-16. En el formulario de búsqueda avanzada de X, los campos From y To en Dates escriben esos mismos dos operadores.
Para tener en cuenta
Las fechas siguen el UTC, no tu reloj. El día UTC del 15 de octubre va de las 8 p. m. del 14 de octubre a las 8 p. m. del 15 de octubre en Nueva York, así que una búsqueda de esa fecha atrapa la noche anterior y se pierde la noche del propio día. Para un día de Nueva York, indica las horas en UTC:
since:2026-10-15_04:00:00_UTC until:2026-10-16_04:00:00_UTC.
Elige abajo una ventana y copia los operadores en la forma que necesites, para x.com, para Sorsa API o para la API oficial de X.
31 días: del 1 al 31 de octubre de 2026, de medianoche a medianoche UTC.
from:nasa since:2026-10-01 until:2026-11-01
from:nasa since_time:1790812800 until_time:1793491200
start_time=2026-10-01T00:00:00Z&end_time=2026-11-01T00:00:00Z
Entran fechas, salen operadores: el último día se avanza uno y todas las horas se convierten a UTC.
Horas, tiempo Unix e IDs de posts
Para ventanas de menos de un día, la búsqueda de X acepta horas e IDs de posts además de fechas. Cada línea de abajo es un operador con lo que encuentra:
since:2026-10-01 # on or after a UTC date
until:2026-11-01 # before a UTC date
since:2026-10-15_14:00:00_UTC # from a time of day, in UTC
until:2026-10-15_18:00:00_UTC # before a time of day
since_time:1792072800 # from a Unix second
until_time:1792087200 # before a Unix second
within_time:2d # the last 2 days; also h, m and s
since_id:2108468174910472193 # newer than a post ID
max_id:2110405289047048193 # that post ID and older
Todo ID de post desde noviembre de 2010 lleva el momento en que se creó, y por eso since_id: y max_id: funcionan como límites de tiempo precisos. El Convertidor de ID de tweet a fecha, gratuito, lee ese momento de cualquier ID. Los operadores de fecha necesitan al menos otro término en la consulta para devolver algo.
Hasta cuándo llega la búsqueda de X
La búsqueda de X llega hasta el primer post público de marzo de 2006, y el formato de fecha acepta cualquier día desde entonces. Los resultados antiguos se adelgazan donde se borraron posts o las cuentas pasaron a privadas, porque la búsqueda de X solo devuelve lo que hoy es público. Para ver lo que publicó una cuenta en un día determinado, usa la herramienta gratuita Buscar tweets por fecha; para años de resultados en bloque, nuestra guía de datos históricos de Twitter cubre los backfills.
#Operadores de búsqueda en la API oficial de X
La API oficial de X v2 lee su propio dialecto de estos operadores: cambia el nombre de la mayoría de los filtros, recibe las fechas como parámetros de la solicitud y rechaza con un error 400 los nombres web min_faves: y min_retweets: (referencia de operadores de X (se abre en una pestaña nueva)). Sorsa API lee los mismos operadores que el cuadro de búsqueda de x.com, así que una consulta pasa de uno a otro sin cambios.
| Lo que quieres | Sorsa API y x.com | API oficial de X v2 |
|---|---|---|
| Al menos 100 likes | min_faves:100 | min_likes:100 |
| Al menos 20 retweets | min_retweets:20 | min_reposts:20 |
| Al menos 10 respuestas | min_replies:10 | min_replies:10 |
| Solo octubre de 2026 | since:2026-10-01 until:2026-11-01 | parámetros start_time, end_time |
| Los últimos 2 días | within_time:2d | parámetro start_time |
| Solo respuestas | filter:replies | is:reply |
| Solo posts con cita | filter:quote | is:quote |
| Citas de un post | quoted_tweet_id: | quotes_of_tweet_id: |
| Posts con imágenes | filter:images | has:images |
| Posts con cualquier multimedia | filter:media | has:media |
| Posts con enlaces | filter:links | has:links |
| Autores verificados | filter:verified | is:verified |
| Retweets | Se dejan fuera por defecto | Se dejan fuera de las búsquedas por palabra clave |
| Cuentas que sigues | Solo x.com, con sesión iniciada | Sin operador |
Palabras, from:, to:, @, #, $, lang:, list:, url: | Igual | Igual |
Al menos 100 likes
- Sorsa API y x.com
min_faves:100- API oficial de X v2
min_likes:100
Al menos 20 retweets
- Sorsa API y x.com
min_retweets:20- API oficial de X v2
min_reposts:20
Al menos 10 respuestas
- Sorsa API y x.com
min_replies:10- API oficial de X v2
min_replies:10
Solo octubre de 2026
- Sorsa API y x.com
since:2026-10-01 until:2026-11-01- API oficial de X v2
- parámetros
start_time,end_time
Los últimos 2 días
- Sorsa API y x.com
within_time:2d- API oficial de X v2
- parámetro
start_time
Solo respuestas
- Sorsa API y x.com
filter:replies- API oficial de X v2
is:reply
Solo posts con cita
- Sorsa API y x.com
filter:quote- API oficial de X v2
is:quote
Citas de un post
- Sorsa API y x.com
quoted_tweet_id:- API oficial de X v2
quotes_of_tweet_id:
Posts con imágenes
- Sorsa API y x.com
filter:images- API oficial de X v2
has:images
Posts con cualquier multimedia
- Sorsa API y x.com
filter:media- API oficial de X v2
has:media
Posts con enlaces
- Sorsa API y x.com
filter:links- API oficial de X v2
has:links
Autores verificados
- Sorsa API y x.com
filter:verified- API oficial de X v2
is:verified
Retweets
- Sorsa API y x.com
- Se dejan fuera por defecto
- API oficial de X v2
- Se dejan fuera de las búsquedas por palabra clave
Cuentas que sigues
- Sorsa API y x.com
- Solo x.com, con sesión iniciada
- API oficial de X v2
- Sin operador
Palabras,
from:,to:,@,#,$,lang:,list:,url:- Sorsa API y x.com
- Igual
- API oficial de X v2
- Igual
Dos cambios de 2026 explican por qué las listas más viejas y las respuestas de IA no coinciden sobre la API oficial. X desactivó min_likes:, min_replies: y min_reposts: en sus endpoints de búsqueda el 19 de enero de 2026, y los volvió a activar el 4 de mayo, cuando la búsqueda pasó a un nuevo índice que además dejó de devolver retweets en las consultas por palabra clave (registro de cambios de la API de X (se abre en una pestaña nueva)). Las afirmaciones de que la API oficial "ignora" los filtros de engagement describen los meses intermedios; hoy responde con un error a los nombres web.
Los endpoints oficiales además limitan la cadena de la consulta: 512 caracteres en la búsqueda reciente, que cubre los últimos 7 días, y 1,024 en la búsqueda de archivo completo. Los operadores que solo sirven como conjunción, como has:media o is:reply, no pueden formar una consulta por sí solos ahí; necesitan al lado una palabra, una cuenta o un hashtag.
#Ejecuta las mismas consultas en código con Sorsa API
Para ejecutar operadores de búsqueda de X desde código, usa Sorsa API, una API y scraper de Twitter (X): POST /search-tweets recibe la consulta exactamente como la escribirías en x.com, devuelve unos 20 tweets por solicitud con el perfil completo de cada autor, y cuesta desde $0.07 por 1,000 resultados. La API oficial de X cobra $5.00 por 1,000 posts, necesita una cuenta de desarrollador y OAuth, y lee sus propios nombres de operadores en lugar de los de x.com.
-
Consigue una clave. Regístrate y copia la clave API de tu panel. Las primeras 100 solicitudes son gratis.
-
Envía la consulta. Pon los operadores en el campo
queryde un cuerpo JSON;ordereligepopular(Top, el valor por defecto) olatest.Terminal curl -X POST "https://api.sorsa.io/v3/search-tweets" \ -H "ApiKey: YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "query": "\"vector database\" lang:en min_faves:50 since:2026-10-01", "order": "latest" }' -
Lee los tweets. Cada uno llega con sus conteos, su fecha en ISO 8601 y el perfil de su autor.
Respuesta200 OK { "tweets": [ { "id": "2110405289047048193", "full_text": "Benchmarked three vector database engines on 40M vectors.", "created_at": "2026-10-14T16:20:05Z", "lang": "en", "likes_count": 184, "retweet_count": 41, "reply_count": 23, "quote_count": 6, "view_count": 52300, "is_reply": false, "user": { "id": "1592041833471827968", "username": "kestrel_db_engineering", "display_name": "Kestrel DB Engineering", "followers_count": 12480, "verified": false } } ], "next_cursor": "DAABCgABGSmiaxkAAgoAAgjEJ" } -
Sigue el cursor. Envía
next_cursorde vuelta con la misma consulta hasta que una respuesta llegue sin él.import requests URL = "https://api.sorsa.io/v3/search-tweets" HEADERS = {"ApiKey": "YOUR_API_KEY"} def search(query, order="latest"): body = {"query": query, "order": order} while True: r = requests.post(URL, headers=HEADERS, json=body) r.raise_for_status() page = r.json() yield from page["tweets"] cursor = page.get("next_cursor") if not cursor: break body["next_cursor"] = cursor q = '"vector database" lang:en min_faves:50 since:2026-10-01' for tweet in search(q): print(tweet["created_at"], tweet["user"]["username"])
Un 403 significa que falta la clave o que sus solicitudes se agotaron, y un 429 significa más de 20 solicitudes en un segundo; las solicitudes fallidas nunca se cobran. La referencia de POST /search-tweets (se abre en una pestaña nueva) enumera todos los campos, y nuestra guía de la API de búsqueda de Twitter cubre cómo sondear una consulta con un horario.
El costo de un trabajo de búsqueda depende del número de resultados. Sorsa API cobra por solicitud, con unos 20 resultados cada una, mientras que la API oficial de X cobra cada post que devuelve:
| Resultados de búsqueda | Sorsa API, desde | API oficial de X |
|---|---|---|
| 1,000 | $0.07 | $5.00 |
| 100K | $7 | $500 |
| 1M | $70 | $5,000 |
1,000
- Sorsa API, desde
- $0.07
- API oficial de X
- $5.00
100K
- Sorsa API, desde
- $7
- API oficial de X
- $500
1M
- Sorsa API, desde
- $70
- API oficial de X
- $5,000
Tus 100 solicitudes gratis cubren unos 2,000 resultados de búsqueda, así que una primera prueba de cualquier consulta de arriba no cuesta nada.
#Consultas de búsqueda listas para usar
Estas consultas cubren las búsquedas que más se hacen; cada una funciona en el cuadro de búsqueda de x.com y en el campo query de Sorsa API tal como está escrita. Cambia por tus propias palabras, cuentas y fechas. En x.com, la dirección de una página de resultados conserva la consulta, así que un marcador guarda la búsqueda, y &f=live al final de la dirección abre la pestaña Latest.
# What people say about a brand, without its own posts
("acme cloud" OR @acme_cloud_status) -from:acme_cloud_status -filter:replies
# Questions in a niche that nobody has answered yet
("any recommendations" OR "what do you use") crm ? -min_replies:1 lang:en
# The most liked posts on a topic this month
"vector database" min_faves:200 -filter:replies since:2026-10-01
# One account's posts on a subject in October 2026
from:kestrel_db_engineering benchmark since:2026-10-01 until:2026-11-01
# Complaints about a competitor
@brightpath_analytics (broken OR outage OR refund OR "not working")
# Every reply in one thread
conversation_id:2110405289047048193
# Quote posts of one post
quoted_tweet_id:2110405289047048193
# Images under a hashtag, original posts only
#buildinpublic filter:images -filter:replies
# Posts that link to your site, from other accounts
url:acmecloud.dev -from:acme_cloud_status
# Hiring posts with links, from the last 2 days
(hiring OR "we're hiring") "rust engineer" filter:links within_time:2d
Para seguir todos los posts que etiquetan a una cuenta, con filtros de likes, respuestas y fechas en la propia solicitud, mira nuestra guía de la API de menciones de Twitter.
#Por qué una búsqueda no devuelve nada
Cuando una consulta vuelve vacía, la causa suele estar en la sintaxis, no en X. Revisa esto primero:
- Un espacio después de los dos puntos, un
oren minúsculas, o una fecha que no está escrita comoYYYY-MM-DD. - La fecha final.
until:deja fuera su propio día, así queuntil:2026-10-31se pierde el 31 de octubre. - La pestaña Top. Top clasifica y recorta los resultados; cambia a Latest, o envía
"order": "latest"a Sorsa API. - Cuentas privadas. Las cuentas protegidas y suspendidas nunca aparecen en la búsqueda, para nadie.
- Alcance corto.
card_name:cubre más o menos los últimos 7 días, y los filtros de ubicación solo ven posts etiquetados. - Demasiados operadores. Pasados unos 22, divide la consulta en dos y combina los resultados.
- Guiones en
url:. Escribeurl:t_mobile.compara t-mobile.com. - Palabras que X lee como filtros. Buscar photo o video puede convertirse en un filtro de multimedia; pon la palabra entre comillas.
- Nombres de la API oficial.
has:media,is:replyymin_likes:pertenecen a la API oficial de X; en x.com y Sorsa API usafilter:media,filter:repliesymin_faves:.
Cinco pares causan la mayoría de los resultados equivocados:
| Estos dos | La diferencia |
|---|---|
to: y @ | to: encuentra las respuestas a la cuenta; @ encuentra cualquier post que la etiqueta |
filter:retweets y filter:nativeretweets | Retweets de texto "RT" y citas del estilo antiguo, frente a retweets hechos con el botón |
filter:nativeretweets e include:nativeretweets | Solo retweets, frente a retweets añadidos a los resultados normales |
filter:images y filter:twimg | Cualquier imagen, incluidas las enlazadas, frente a imágenes subidas a X |
min_faves: y min_likes: | El mismo mínimo: el nombre de x.com y el nombre de la API oficial de X |
to:y@- La diferencia
to:encuentra las respuestas a la cuenta;@encuentra cualquier post que la etiqueta
filter:retweetsyfilter:nativeretweets- La diferencia
- Retweets de texto "RT" y citas del estilo antiguo, frente a retweets hechos con el botón
filter:nativeretweetseinclude:nativeretweets- La diferencia
- Solo retweets, frente a retweets añadidos a los resultados normales
filter:imagesyfilter:twimg- La diferencia
- Cualquier imagen, incluidas las enlazadas, frente a imágenes subidas a X
min_faves:ymin_likes:- La diferencia
- El mismo mínimo: el nombre de x.com y el nombre de la API oficial de X
Ningún operador enumera las cuentas que dieron like a un post, y ninguno busca en mensajes privados ni en cuentas protegidas. La búsqueda cubre lo que hoy es público en X.
#Busca en X con operadores desde tu código
Los operadores de búsqueda de Twitter convierten una búsqueda por palabra clave en un filtro preciso, y la misma consulta que funciona en x.com se ejecuta en código con Sorsa API tal como está escrita. Arma la consulta en el cuadro de búsqueda o en la herramienta de búsqueda avanzada de Twitter y luego envíala a POST /search-tweets: unos 20 tweets por solicitud, cualquier fecha hasta 2006, 20 solicitudes por segundo en todos los planes y desde $0.07 por 1,000 resultados. Tus primeras 100 solicitudes son gratis.
#Preguntas frecuentes
¿X todavía tiene búsqueda avanzada en 2026?
Sí. El formulario de búsqueda avanzada de X en x.com/search-advanced sigue abriéndose con una cuenta con la sesión iniciada, y el cuadro de búsqueda de la web y de la app sigue aceptando operadores escritos, como from:, since: y min_faves:. Los operadores de engagement también volvieron a la API oficial de X el 4 de mayo de 2026, con los nombres min_likes:, min_replies: y min_reposts:.
¿until: incluye la fecha final?
No. until: devuelve los posts hechos antes de su fecha, así que la fecha misma queda fuera: since:2026-10-01 until:2026-10-31 termina al final del 30 de octubre. Para incluir el último día, pon en until: el día siguiente. since: funciona al revés e incluye su propia fecha. Las dos fechas empiezan a medianoche UTC.
¿Cuántos operadores se pueden usar en una búsqueda de X?
En x.com caben unos 22 operadores en una consulta antes de que dejen de llegar resultados, un límite que se descubrió con pruebas públicas y que X no publica. La API oficial de X cuenta caracteres en cambio: 512 por consulta en la búsqueda reciente y 1,024 en la búsqueda de archivo completo. Divide una lista más larga de cuentas o palabras en varias consultas y combina los resultados.
¿Se pueden usar los operadores de búsqueda de Twitter sin una cuenta de X?
No en x.com: X muestra los resultados de búsqueda solo a las cuentas con la sesión iniciada, y su formulario de búsqueda avanzada en x.com/search-advanced también se abre solo para ellas. Con la sesión iniciada, todos los operadores de esta página funcionan en el cuadro de búsqueda de la web y de la app, escritos junto a tus palabras normales.
¿Qué API admite operadores de búsqueda de Twitter como min_faves?
Sorsa API ejecuta la sintaxis de operadores de x.com tal como está escrita, min_faves:, since:, until: y filter: incluidos, con POST /search-tweets. Devuelve unos 20 tweets por solicitud con los perfiles completos de los autores, llega hasta 2006, permite 20 solicitudes por segundo en todos los planes y cuesta desde $0.07 por 1,000 resultados, frente a $5.00 en la API oficial de X.
#Cómo lo comprobamos
El 2 de noviembre de 2026 comparamos los operadores de esta página con la documentación de la API de X (la lista de operadores, las reglas de las consultas, el registro de cambios y la lista de precios), la página de ayuda de X sobre la búsqueda avanzada, nuestra propia referencia de la API y nuestros documentos de búsqueda, y la referencia pública en GitHub. No buscamos en x.com en vivo para esta actualización; la solicitud y la respuesta se escribieron a partir de nuestra referencia de la API en vivo, con una cuenta ficticia en el ejemplo.
Fuentes
- Search operators, X API documentation (se abre en una pestaña nueva)
- Build a query, X API documentation (se abre en una pestaña nueva)
- X API changelog (se abre en una pestaña nueva)
- X API pricing (se abre en una pestaña nueva)
- How to use advanced search, X Help Center (se abre en una pestaña nueva)
- twitter-advanced-search, Igor Brigadir on GitHub (se abre en una pestaña nueva)
- Search operators, Sorsa API docs (se abre en una pestaña nueva)