Filtrera efter användarnamn och datum på X
På denna sida
Målinrikta dina X-sökningar exakt
X Search levererar verkligt värde när du väl behärskar dess filtreringsparametrar. Istället för att hämta ett råflöde av inlägg kan du rikta in dig på specifika konton, ange exakta tidsfönster och utesluta brus. Dessa filter förvandlar ett generellt sökverktyg till ett precisionsinstrument för övervakning.
Filtrera efter användarnamn: allowed_x_handles och excluded_x_handles
Övervaka specifika konton
Parametern allowed_x_handles begränsar sökningen till inlägg publicerade av de konton du listar. Du kan målinrikta upp till 10 användarnamn 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"
]
}]
)
Uteslut brusiga konton
Parametern excluded_x_handles fungerar tvärtom. Den tillåter alla konton utom de du anger. Detta är användbart för att eliminera botar eller konton med irrelevant innehåll:
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 ömsesidig uteslutning
Precis som för webbdomäner är allowed_x_handles och excluded_x_handles ömsesidigt uteslutande. Du kan inte kombinera dem i samma anrop. Gränsen är 10 användarnamn per parameter, vilket är dubbelt så högt som gränsen för webbdomäner.
Filtrera efter datum: from_date och to_date
Tidsparametrar låter dig definiera ett exakt sökfönster i ISO 8601-format (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"
}]
)
Dessa filter är särskilt användbara för att:
- Analysera effekten av en händelse: definiera perioden kring händelsen
- Jämföra sentiment före/efter: kör två frågor med olika tidsfönster
- Undvika äldre brus: fokusera på senaste diskussioner
Användning med det nativa Python SDK:t
xAI SDK accepterar Python-objekt av typen datetime utöver ISO-strängar:
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 använder camelCase-konventionen för parameternamn:
tools: [xai.tools.xSearch({
allowedXHandles: ["elonmusk"],
fromDate: "2026-03-01",
toDate: "2026-03-31"
})]
Kombinera filter
Du kan kombinera användarnamn och datum i ett enda anrop för maximal precision:
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"
}]
)
Bygg ett dynamiskt övervakningssystem
Genom att kombinera dessa filter programmatiskt kan du bygga ett konfigurerbart övervakningsverktyg:
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
)
Övning
Konfigurera en målinriktad X-sökning för 3 till 5 inflytelserika konton inom din bransch. Ställ in ett tidsfönster på en vecka och jämför resultaten med en sökning utan filter för användarnamn. Mät skillnaden i relevans.
Viktiga punkter
allowed_x_handlesochexcluded_x_handlesfiltrerar efter konto (max 10 vardera)- Båda parametrarna för användarnamn är ömsesidigt uteslutande
from_dateochto_datedefinierar tidsfönstret i formatetYYYY-MM-DD- Datum kan kombineras med filter för användarnamn
- Python SDK accepterar
datetime-objekt, medan JavaScript SDK använder camelCase - Dessa filter förvandlar X Search från ett generellt verktyg till ett målinriktat övervakningsinstrument