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_domains
orexclude_domains
in a single query. Specifyingexclude_domains
is redundant wheninclude_domains
is set, as onlyinclude_domains
will 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.