Filtrado por fecha
En esta página
Definición de la ventana de tiempo de búsqueda
La búsqueda en X ofrece una funcionalidad de la que carece la búsqueda web: el filtrado por fecha. Puedes definir un periodo específico para limitar los resultados a las publicaciones emitidas dentro de esa ventana temporal. Se trata de una herramienta potente para el análisis de tendencias, el seguimiento de eventos y la monitorización dirigida.
Parámetros de fecha
Dos parámetros controlan la ventana de tiempo:
from_date: fecha de inicio de la búsqueda (inclusive)to_date: fecha de fin de la búsqueda (inclusive)
Ambos son opcionales e independientes. Puedes utilizar uno sin el otro:
- Solo
from_date: todas las publicaciones desde esta fecha - Solo
to_date: todas las publicaciones hasta esta fecha - Ambos juntos: publicaciones dentro de la ventana definida
Formato de fecha
Las fechas siguen el formato ISO 8601: YYYY-MM-DD (año-mes-día).
response = client.responses.create(
model="grok-4.20-0309-reasoning",
input="What were the reactions to the Grok 4 launch?",
tools=[{
"type": "x_search",
"from_date": "2026-03-01",
"to_date": "2026-03-31"
}]
)
Esta consulta busca únicamente publicaciones publicadas en marzo de 2026.
Sintaxis del SDK
SDK de xAI (Python)
El SDK de Python acepta tanto cadenas de texto como objetos datetime:
from xai_sdk.tools import x_search
import datetime
# Uso de cadenas
tools=[x_search(
from_date="2026-01-01",
to_date="2026-04-01"
)]
# Uso de objetos datetime
tools=[x_search(
from_date=datetime.datetime(2026, 1, 1),
to_date=datetime.datetime(2026, 4, 1)
)]
Se prefiere el uso de objetos datetime en entornos de producción, ya que permite calcular fechas de forma dinámica (por ejemplo, «los últimos 7 días»).
SDK de OpenAI (Python)
tools=[{
"type": "x_search",
"from_date": "2026-01-01",
"to_date": "2026-04-01"
}]
SDK de Vercel AI (JavaScript)
tools: [xai.tools.xSearch({
fromDate: "2026-01-01",
toDate: "2026-04-01"
})]
Convención camelCase: fromDate y toDate.
Combinación de fechas y handles
Combinar el filtrado temporal con el filtrado por handles es especialmente potente:
response = client.responses.create(
model="grok-4.20-0309-reasoning",
input="Summarize xAI's announcements this month",
tools=[{
"type": "x_search",
"allowed_x_handles": ["xaboratory", "xaboratorydev"],
"from_date": "2026-04-01",
"to_date": "2026-04-30"
}]
)
Esta consulta combina tres filtros: solo publicaciones de cuentas oficiales de xAI y solo durante abril de 2026.
Casos de uso
Análisis de eventos
Seguimiento de reacciones en tiempo real durante un evento (conferencia, lanzamiento de producto, anuncio):
# Reacciones durante una conferencia magistral
tools=[{
"type": "x_search",
"from_date": "2026-03-25",
"to_date": "2026-03-26"
}]
Monitorización semanal automatizada
Creación de un informe de monitorización automático para la semana anterior:
from datetime import datetime, timedelta
today = datetime.now()
week_ago = today - timedelta(days=7)
tools=[{
"type": "x_search",
"from_date": week_ago.strftime("%Y-%m-%d"),
"to_date": today.strftime("%Y-%m-%d")
}]
Análisis de tendencias
Comparación de debates sobre un tema en distintos periodos mediante múltiples solicitudes con ventanas de tiempo diferenciadas.
Buenas prácticas
La experiencia demuestra que las ventanas cortas funcionan mejor: un periodo de uno a siete días ofrece resultados significativamente más precisos que un mes entero, donde las publicaciones relevantes se pierden entre el volumen de datos. En producción, nunca codifiques estas fechas de forma estática; calcúlalas con datetime en cada ejecución. De lo contrario, tu ventana de «monitorización de 7 días» consultará siempre la misma semana desde el despliegue. Por último, la ventana de tiempo solo define el conjunto de resultados: el prompt dicta qué hacer con ellos. Especifica qué esperas obtener («resumen de tendencias», «publicaciones con mayor interacción», «anuncios importantes») y el modelo filtrará los resultados en consecuencia, en lugar de devolverlo todo.
Puntos clave
from_dateyto_dateen formato ISO 8601 (YYYY-MM-DD)- Ambos parámetros son opcionales e independientes
- Combínalos con el filtrado por handles para búsquedas altamente dirigidas
- El SDK de Python acepta tanto cadenas como objetos
datetime - Exclusivo de la búsqueda en X: la búsqueda web no ofrece filtrado temporal