Filtrér efter brugernavne og datoer på X
På denne side
Målret dine X-søgninger præcist
X Search leverer først rigtig værdi, når du mestrer dets filtreringsparametre. I stedet for at trække et rå feed af indlæg kan du målrette specifikke kontoer, indstille præcise tidsvinduer og udelukke støjende kilder. Disse filtre omdanner et generelt søgeværktøj til et præcist overvågningsinstrument.
Filtrér efter brugernavne: allowed_x_handles og excluded_x_handles
Overvåg specifikke kontoer
Parameteren allowed_x_handles begrænser søgningen til indlæg udgivet af de kontoer, du angiver. Du kan målrette op til 10 brugernavne samtidigt:
response = client.responses.create(
model="grok-4.5",
input="Summary of recent announcements from these tech accounts",
tools=[{
"type": "x_search",
"allowed_x_handles": [
"elonmusk",
"sama",
"demishassabis",
"ylecun"
]
}]
)
Udeluk støjende kontoer
Parameteren excluded_x_handles fungerer modsat. Den tillader alle kontoer undtagen dem, du specificerer. Dette er nyttigt til at eliminere bots eller kontoer med irrelevant indhold:
response = client.responses.create(
model="grok-4.5",
input="Serious discussions on AI regulation",
tools=[{
"type": "x_search",
"excluded_x_handles": ["bot_spam_1", "compte_parodie"]
}]
)
Regel om gensidig udelukkelse
Ligesom webdomæner er allowed_x_handles og excluded_x_handles gensidigt udelukkende. Du kan ikke kombinere dem i et enkelt kald. Grænsen er 10 brugernavne pr. parameter, hvilket er det dobbelte af grænsen for webdomæner.
Filtrér efter datoer: from_date og to_date
Tidsparametre lader dig definere et præcist søgevindue i ISO 8601-formatet (YYYY-MM-DD):
response = client.responses.create(
model="grok-4.5",
input="Reactions to the Grok 4.5 announcement",
tools=[{
"type": "x_search",
"from_date": "2026-03-01",
"to_date": "2026-03-15"
}]
)
Disse filtre er særligt nyttige til:
- At analysere effekten af en begivenhed: definer perioden omkring begivenheden
- At sammenligne stemning før/efter: kør to forespørgsler med forskellige vinduer
- At undgå ældre støj: fokuser på nyere diskussioner
Brug med det native Python SDK
xAI SDK accepterer Python datetime-objekter udover ISO-strenge:
from xai_sdk.tools import x_search
from datetime import datetime
response = client.chat.create(
model="grok-4.5",
tools=[x_search(
from_date=datetime(2026, 3, 1),
to_date=datetime(2026, 3, 31)
)]
)
camelCase-konvention i JavaScript
Vercel AI SDK bruger camelCase-konventionen for parameternavne:
tools: [xai.tools.xSearch({
allowedXHandles: ["elonmusk"],
fromDate: "2026-03-01",
toDate: "2026-03-31"
})]
Kombination af filtre
Du kan kombinere brugernavne og datoer i et enkelt kald for maksimal præcision:
response = client.responses.create(
model="grok-4.5",
input="What did Sam Altman say about GPT-5 in March 2026?",
tools=[{
"type": "x_search",
"allowed_x_handles": ["sama"],
"from_date": "2026-03-01",
"to_date": "2026-03-31"
}]
)
Byg et dynamisk overvågningssystem
Ved at kombinere disse filtre programmatisk kan du bygge et konfigurerbart overvågningsværktøj:
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")
}
# Monitor AI leaders for the week
tool = create_x_monitor(
handles=["sama", "demishassabis", "ylecun"],
days_back=7
)
Øvelse
Konfigurer en målrettet X-søgning for 3 til 5 indflydelsesrige kontoer i din sektor. Indstil et tidsvindue på én uge og sammenlign resultaterne med en søgning uden filtre på brugernavne. Mål forskellen i relevans.
Vigtige pointer
allowed_x_handlesogexcluded_x_handlesfiltrerer efter konto (maks. 10 af hver)- Begge parametre for brugernavne er gensidigt udelukkende
from_dateogto_datedefinerer tidsvinduet i formatetYYYY-MM-DD- Datoer kan kombineres med filtre for brugernavne
- Python SDK accepterer
datetime-objekter, mens JavaScript SDK bruger camelCase - Disse filtre omdanner X Search fra et generelt værktøj til et målrettet overvågningsinstrument