Filtrera efter X-konton
På denna sida
Måla in specifika konton på X
Precis som Web Search låter dig filtrera efter domäner, låter X Search dig filtrera efter konton (handles). Du kan begränsa sökningar till inlägg från en specifik uppsättning konton, eller exkludera vissa konton från resultaten. Denna filtrering är avgörande för användningsområden som övervakning, varumärkesbevakning eller influencer-analys.
De två filtreringsparametrarna
X Search erbjuder två parametrar för att filtrera efter konton:
allowed_x_handles: begränsar sökningen till inlägg från de listade kontona (allowlist)excluded_x_handles: exkluderar inlägg från de listade kontona (blocklist)
Precis som för Web Search är dessa parametrar ömsesidigt uteslutande. Du kan inte använda båda i samma begäran.
Varje parameter accepterar en array med upp till 10 handles (jämfört med 5 domäner för Web Search).
Använda allowed_x_handles (allowlist)
Denna parameter är idealisk för att övervaka kommunikation från specifika konton:
response = client.responses.create(
model="grok-4.20-0309-reasoning",
input="What are the latest announcements from xAI?",
tools=[{
"type": "x_search",
"allowed_x_handles": ["xaboratory", "xaboratorydev"]
}]
)
Modellen kommer endast att söka efter inlägg publicerade av dessa konton.
Användningsområden för allowlist
- Konkurrentanalys: övervaka dina konkurrenters tillkännagivanden
- Varumärkesbevakning: spåra dina officiella konton och dina ambassadörers konton
- Influencer-analys: samla åsikter från en panel av experter
- Institutionell bevakning: följ konton från tillsynsmyndigheter eller officiella organisationer
Använda excluded_x_handles (blocklist)
Denna parameter låter dig exkludera vissa konton, såsom botar eller irrelevanta konton:
response = client.responses.create(
model="grok-4.20-0309-reasoning",
input="What do developers think about the latest version of Python?",
tools=[{
"type": "x_search",
"excluded_x_handles": ["bot_python_news", "spam_account"]
}]
)
Användningsområden för blocklist
- Exkludera botar: ta bort automatiserade konton från resultaten
- Exkludera spam: filtrera bort konton kända för innehåll av låg kvalitet
- Exkludera dina egna konton: analysera externa reaktioner utan dina egna inlägg
SDK-syntax
xAI SDK (Python)
from xai_sdk.tools import x_search
tools=[x_search(
allowed_x_handles=["elonmusk", "xaboratory"]
)]
OpenAI SDK (Python)
tools=[{
"type": "x_search",
"allowed_x_handles": ["elonmusk", "xaboratory"]
}]
Vercel AI SDK (JavaScript)
tools: [xai.tools.xSearch({
allowedXHandles: ["elonmusk", "xaboratory"]
})]
Observera camelCase-konventionen i JavaScript SDK: allowedXHandles istället för allowed_x_handles.
Bästa praxis
Välja mellan allowlist och blocklist
Använd allowlist när du har en definierad uppsättning konton och endast vill ha deras inlägg. Detta är den mest precisa och token-effektiva metoden.
Använd blocklist när du vill göra en bred sökning men behöver rensa upp den genom att eliminera kända brus-källor.
Optimera antalet handles
Med en gräns på 10 handles bör du vara selektiv. Om du behöver övervaka fler än 10 konton, gruppera dina begäranden efter ämne eller gör flera sekventiella anrop.
Format för handles
Handles innehåller inte symbolen @ (till exempel xaboratory). Kontrollera att handles är korrekta – ett felstavat handle kommer helt enkelt att returnera inga resultat för det kontot.
Viktiga punkter
- Två parametrar:
allowed_x_handles(allowlist) ochexcluded_x_handles(blocklist) - Ömsesidigt uteslutande: endast en åt gången per begäran
- Maximalt 10 handles per parameter
- Handles skrivs utan
@:"elonmusk", inte"@elonmusk" - Idealiskt för övervakning, varumärkesbevakning och influencer-analys