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.
Example
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 can be used in domain specifications, for example, to research only “.org” domains. However, paths are, for example “example.com/blog”, are not yet supported.
- Although there is a maximum limit of 10 domains, carefully using specific and targeted domains will give better results.