Ga naar hoofdinhoud
Nederlands— Kies een taal
Menu

Domeinfiltering

Les 5 van 16 Bijgewerkt op 30 juli 2026 Ontwikkelaar
Op deze pagina
  1. Zoekbronnen beheren
  2. Twee wederzijds uitsluitende parameters
  3. allowed_domains gebruiken (allowlist)
  4. excluded_domains gebruiken (blocklist)
  5. SDK-syntax
  6. Limieten en best practices
  7. Belangrijkste punten

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) en excluded_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