Skip to main content
The Source Policy feature allows you to precisely control which domains Parallel processors can access during web research. It’s available for both Tasks and Web Tools and lets you tailor search results by specifying domains to include or exclude, ensuring more relevant and trustworthy information.

​
Configuration

You can configure domain control by setting the following parameters:
ParameterTypeDescription
include_domainsarray[string]List of domains to allow. Only sources from these domains will be included in results. Maximum 10 domains.
exclude_domainsarray[string]List of domains to block. Sources from these domains will be excluded from results. Maximum 10 domains.
Specifying an apex domain such as example.com will automatically include all its subdomains (e.g., www.example.com, blog.example.com, api.example.com).

​
Domain Limit

Hard limit: 10 domains per request. You can specify up to 10 domains total in either include_domains or exclude_domains. Exceeding this limit will raise a validation error. This limit applies to each array separately—you cannot combine them to exceed 10 domains per policy type.

​
Example

curl -X POST "https://api.parallel.ai/v1/tasks/runs" \
  -H "x-api-key: $PARALLEL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
      "input": "How many employees does Parallel Web Systems have?",
      "processor": "core",
      "source_policy": {
        "include_domains": ["linkedin.com"]
      }
    }'

​
Best Practices

  • Use either include_domains or exclude_domains in a single query. Specifying exclude_domains is redundant when include_domains is set, as only include_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 as www.).
  • Wildcards can be used in domain specifications, for example, to research only “.org” domains. However, paths, 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.