Ir al contenido principal
Español— Elegir un idioma
Menú

Filtrado por fecha

Lección 10 de 16 Actualizado el 30 de julio de 2026 Desarrollador
En esta página
  1. Definición de la ventana de tiempo de búsqueda
  2. Parámetros de fecha
  3. Formato de fecha
  4. Sintaxis del SDK
  5. Combinación de fechas y handles
  6. Casos de uso
  7. Buenas prácticas
  8. Puntos clave

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_date y to_date en 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