Filtrer par Handles et Dates sur X

Cibler précisément vos recherches sur X

La valeur de X Search explose lorsque vous maîtrisez ses paramètres de filtrage. Au lieu de récupérer un flux brut de posts, vous pouvez cibler des comptes spécifiques, définir des fenêtres temporelles précises, et exclure les sources de bruit. Ces filtres transforment un outil de recherche généraliste en un instrument de veille chirurgical.

Filtrer par handles : `allowed_x_handles` et `excluded_x_handles`

Surveiller des comptes spécifiques

Le paramètre allowed_x_handles restreint la recherche aux posts publiés par les comptes que vous listez. Vous pouvez cibler jusqu’à 10 handles simultanément :

response = client.responses.create(
    model="grok-3",
    input="Résumé des dernières annonces de ces comptes tech",
    tools=[{
        "type": "x_search",
        "allowed_x_handles": [
            "@elonmusk",
            "@sama",
            "@demaboratory",
            "@ylecun"
        ]
    }]
)

Exclure des comptes bruyants

Le paramètre excluded_x_handles fonctionne en miroir. Il autorise tous les comptes sauf ceux que vous spécifiez. Pratique pour éliminer les bots ou les comptes dont le contenu n’est pas pertinent :

response = client.responses.create(
    model="grok-3",
    input="Discussions sérieuses sur la régulation de l'IA",
    tools=[{
        "type": "x_search",
        "excluded_x_handles": ["@bot_spam_1", "@compte_parodie"]
    }]
)

Règle d’exclusivité mutuelle

Comme pour les domaines web, allowed_x_handles et excluded_x_handles sont mutuellement exclusifs. Vous ne pouvez pas les combiner dans un même appel. La limite est de 10 handles par paramètre, soit le double de la limite pour les domaines web.

Filtrer par dates : `from_date` et `to_date`

Les paramètres temporels vous permettent de définir une fenêtre de recherche précise au format ISO 8601 (YYYY-MM-DD) :

response = client.responses.create(
    model="grok-3",
    input="Réactions à l'annonce de Grok 3",
    tools=[{
        "type": "x_search",
        "from_date": "2026-03-01",
        "to_date": "2026-03-15"
    }]
)

Ces filtres sont particulièrement utiles pour :

Analyser l’impact d’un événement : définir la période autour de l’événement
Comparer les sentiments avant/après : lancer deux requêtes avec des fenêtres différentes
Éviter le bruit ancien : se concentrer sur les discussions récentes

Utilisation avec le SDK Python natif

Le xAI SDK accepte des objets datetime Python en plus des chaînes ISO :

from xai_sdk.tools import x_search
from datetime import datetime

response = client.chat.create(
    model="grok-3",
    tools=[x_search(
        from_date=datetime(2026, 3, 1),
        to_date=datetime(2026, 3, 31)
    )]
)

Convention camelCase en JavaScript

Le Vercel AI SDK utilise la convention camelCase pour les noms de paramètres :

tools: [xai.tools.xSearch({
  allowedXHandles: ["@elonmusk"],
  fromDate: "2026-03-01",
  toDate: "2026-03-31"
})]

Combinaisons de filtres

Vous pouvez combiner handles et dates dans un même appel pour une précision maximale :

response = client.responses.create(
    model="grok-3",
    input="Qu'a dit Sam Altman sur GPT-5 en mars 2026 ?",
    tools=[{
        "type": "x_search",
        "allowed_x_handles": ["@sama"],
        "from_date": "2026-03-01",
        "to_date": "2026-03-31"
    }]
)

Construire un système de veille dynamique

En combinant ces filtres de façon programmatique, vous pouvez construire un outil de veille configurable :

def create_x_monitor(handles, days_back=7):
    from datetime import datetime, timedelta
    today = datetime.now()
    start = (today - timedelta(days=days_back)).strftime("%Y-%m-%d")

    return {
        "type": "x_search",
        "allowed_x_handles": handles,
        "from_date": start,
        "to_date": today.strftime("%Y-%m-%d")
    }

# Veille sur les leaders IA de la semaine
tool = create_x_monitor(
    handles=["@sama", "@demaboratory", "@ylecun"],
    days_back=7
)

Mise en pratique

Configurez une recherche X ciblée sur 3 à 5 comptes influents dans votre secteur. Définissez une fenêtre temporelle d’une semaine et comparez les résultats avec une recherche sans filtre de handles. Mesurez la différence de pertinence.

Points clés à retenir

allowed_x_handles et excluded_x_handles filtrent par comptes (max 10 chacun)
Les deux paramètres de handles sont mutuellement exclusifs
from_date et to_date définissent la fenêtre temporelle au format YYYY-MM-DD
Les dates sont combinables avec les filtres de handles
Le SDK Python accepte les objets datetime, le SDK JavaScript utilise le camelCase
Ces filtres transforment X Search d’un outil généraliste en un instrument de veille ciblé