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

Filtrado por identificadores de X

Lección 9 de 16 Actualizado el 30 de julio de 2026 Desarrollador
En esta página
  1. Segmentación de cuentas específicas en X
  2. Los dos parámetros de filtrado
  3. Uso de allowed_x_handles (lista de permitidos)
  4. Uso de excluded_x_handles (lista de bloqueados)
  5. Sintaxis del SDK
  6. Mejores prácticas
  7. Puntos clave

Segmentación de cuentas específicas en X

Al igual que la Búsqueda web permite filtrar por dominios, la Búsqueda en X permite filtrar por cuentas (identificadores). Puedes restringir las búsquedas a publicaciones de un conjunto concreto de cuentas o excluir ciertas cuentas de los resultados. Este filtrado es esencial para casos de uso como la monitorización, el seguimiento de marca o el análisis de influenciadores.

Los dos parámetros de filtrado

La Búsqueda en X ofrece dos parámetros para filtrar por identificadores:

  • allowed_x_handles: limita la búsqueda a publicaciones de las cuentas listadas (lista de permitidos)
  • excluded_x_handles: excluye publicaciones de las cuentas listadas (lista de bloqueados)

Al igual que en la Búsqueda web, estos parámetros son mutuamente excluyentes. No puedes usar ambos en la misma solicitud.

Cada parámetro acepta un array de hasta 10 identificadores (frente a 5 dominios en la Búsqueda web).

Uso de allowed_x_handles (lista de permitidos)

Este parámetro es ideal para monitorizar comunicaciones de cuentas específicas:

response = client.responses.create(
    model="grok-4.20-0309-reasoning",
    input="¿Cuáles son los últimos anuncios de xAI?",
    tools=[{
        "type": "x_search",
        "allowed_x_handles": ["xaboratory", "xaboratorydev"]
    }]
)

El modelo solo buscará publicaciones publicadas por estas cuentas.

Casos de uso de la lista de permitidos

  • Inteligencia competitiva: monitoriza los anuncios de tus competidores
  • Seguimiento de marca: rastrea tus cuentas oficiales y las de tus embajadores
  • Análisis de influenciadores: agrega opiniones de un panel de expertos
  • Seguimiento institucional: sigue cuentas de reguladores u organizaciones oficiales

Uso de excluded_x_handles (lista de bloqueados)

Este parámetro te permite excluir ciertas cuentas, como bots o cuentas irrelevantes:

response = client.responses.create(
    model="grok-4.20-0309-reasoning",
    input="¿Qué opinan los desarrolladores sobre la última versión de Python?",
    tools=[{
        "type": "x_search",
        "excluded_x_handles": ["bot_python_news", "spam_account"]
    }]
)

Casos de uso de la lista de bloqueados

  • Excluir bots: elimina cuentas automatizadas de los resultados
  • Excluir spam: filtra cuentas conocidas por contenido de baja calidad
  • Excluir tus propias cuentas: analiza reacciones externas sin incluir tus propias publicaciones

Sintaxis del SDK

SDK de xAI (Python)

from xai_sdk.tools import x_search

tools=[x_search(
    allowed_x_handles=["elonmusk", "xaboratory"]
)]

SDK de OpenAI (Python)

tools=[{
    "type": "x_search",
    "allowed_x_handles": ["elonmusk", "xaboratory"]
}]

SDK de Vercel AI (JavaScript)

tools: [xai.tools.xSearch({
  allowedXHandles: ["elonmusk", "xaboratory"]
})]

Observa la convención camelCase en el SDK de JavaScript: allowedXHandles en lugar de allowed_x_handles.

Mejores prácticas

Elección entre lista de permitidos y lista de bloqueados

Utiliza la lista de permitidos cuando tengas un conjunto definido de cuentas y solo quieras sus publicaciones. Este es el método más preciso y eficiente en cuanto a tokens.

Utiliza la lista de bloqueados cuando quieras una búsqueda amplia pero necesites limpiarla eliminando fuentes de ruido conocidas.

Optimización del número de identificadores

Con un límite de 10 identificadores, sé selectivo. Si necesitas monitorizar más de 10 cuentas, agrupa tus solicitudes por tema o realiza varias llamadas secuenciales.

Formato del identificador

Los identificadores no incluyen el símbolo @ (por ejemplo, xaboratory). Verifica que los identificadores sean correctos; un identificador mal escrito simplemente no devolverá resultados para esa cuenta.

Puntos clave

  • Dos parámetros: allowed_x_handles (lista de permitidos) y excluded_x_handles (lista de bloqueados)
  • Mutuamente excluyentes: solo uno a la vez por solicitud
  • Máximo 10 identificadores por parámetro
  • Los identificadores se escriben sin el @: "elonmusk", no "@elonmusk"
  • Ideal para monitorización, seguimiento de marca y análisis de influenciadores