Domeinfiltering
Op deze pagina
Zoekbronnen beheren
Standaard doorzoekt Web Search het volledige internet. Dit werkt goed voor algemene vragen, maar schiet vaak tekort voor professionele use cases waarbij u betrouwbare, gecontroleerde bronnen nodig heeft. Met domeinfiltering kunt u specifieke sites beperken of uitsluiten.
Twee wederzijds uitsluitende parameters
Web Search biedt twee filterparameters:
allowed_domains: beperkt de zoekopdracht tot opgegeven domeinen (allowlist)excluded_domains: sluit specifieke domeinen uit van de resultaten (blocklist)
Deze twee parameters zijn wederzijds uitsluitend. U kunt ze niet in hetzelfde verzoek combineren. Als u dit toch probeert, retourneert de API een foutmelding.
Elke parameter accepteert een array van maximaal 5 domeinen.
allowed_domains gebruiken (allowlist)
Gebruik deze parameter wanneer u precies weet welke bronnen u wilt raadplegen. Bijvoorbeeld voor academisch onderzoek:
response = client.responses.create(
model="grok-4.20-0309-reasoning",
input="What are the latest publications on transformers?",
tools=[{
"type": "web_search",
"allowed_domains": ["arxiv.org", "nature.com", "science.org"]
}]
)
Het model doorzoekt alleen deze drie domeinen. Dit garandeert dat de resultaten afkomstig zijn van geverifieerde wetenschappelijke bronnen.
Use cases voor allowlists
- Academisch onderzoek: beperken tot arxiv.org, scholar.google.com, nature.com
- Technische documentatie: beperken tot officiële technologiewebsites
- Concurrentie-informatie: beperken tot websites van concurrenten
- Naleving van regelgeving: beperken tot overheids- of regelgevende bronnen
excluded_domains gebruiken (blocklist)
Gebruik deze parameter wanneer u een brede zoekopdracht wilt uitvoeren, maar onbetrouwbare of irrelevante bronnen moet uitsluiten:
response = client.responses.create(
model="grok-4.20-0309-reasoning",
input="What are the best JavaScript frameworks in 2026?",
tools=[{
"type": "web_search",
"excluded_domains": ["reddit.com", "quora.com"]
}]
)
Het model doorzoekt het volledige internet, met uitzondering van de uitgesloten domeinen.
Use cases voor blocklists
- Forums uitsluiten: vermijd ongeverifieerde meningen
- Aggregators uitsluiten: vermijd dubbele content
- Concurrenten uitsluiten: houd hun content uit uw resultaten
- Paywalls uitsluiten: vermijd sites met ontoegankelijke content
SDK-syntax
xAI SDK
tools=[client.tools.web_search(
allowed_domains=["arxiv.org", "nature.com"]
)]
OpenAI SDK
tools=[{
"type": "web_search",
"excluded_domains": ["reddit.com"]
}]
Vercel AI SDK
tools: [xai.tools.webSearch({
allowedDomains: ["arxiv.org", "nature.com"]
})]
Let op de camelCase-conventie (allowedDomains) in de JavaScript SDK.
Limieten en best practices
De limiet van 5 domeinen lijkt misschien restrictief. In de praktijk dwingt dit u om selectief te zijn met bronnen, wat de kwaliteit van de resultaten verbetert. Als u meer flexibiliteit nodig heeft, kunt u meerdere verzoeken uitvoeren met verschillende domeinen en de resultaten aan de clientzijde samenvoegen.
Zorg bij het gebruik van allowed_domains dat de gekozen domeinen het gevraagde onderwerp dekken. Een te restrictief domein kan voorkomen dat het model relevante informatie vindt, waardoor het mogelijk reageert zonder actuele gegevens.
Belangrijkste punten
- Twee beschikbare parameters:
allowed_domains(allowlist) enexcluded_domains(blocklist) - Wederzijds uitsluitend: u kunt ze niet combineren in hetzelfde verzoek
- Maximum 5 domeinen per parameter
- Allowlist is ideaal voor gecontroleerde, betrouwbare bronnen
- Blocklist werkt goed voor brede zoekopdrachten met enkele uitsluitingen