Configuration
You can configure domain control by setting the following parameters:| Parameter | Type | Description |
|---|---|---|
include_domains | array[string] | List of domains to allow. Only sources from these domains will be included in results. |
exclude_domains | array[string] | List of domains to block. Sources from these domains will be excluded from results. |
example.com will automatically include all its
subdomains (e.g., www.example.com, blog.example.com, api.example.com).
You can specify up to 10 domains per request. Exceeding this limit will raise a validation error.
Best Practices
- Use either
include_domainsorexclude_domainsin a single query. Specifyingexclude_domainsis redundant wheninclude_domainsis set, as onlyinclude_domainswill be applied. - List each domain in its apex form (e.g.,
example.com). Do not include schemes (http://,https://) or subdomain prefixes (such aswww.). - Wildcards cannot be used in domain specifications. Each domain must be explicitly listed.
- Although there is a maximum limit of 10 domains, carefully using specific and targeted domains will give better results.