Skip to main content
The Source Policy feature allows you to precisely control which domains Parallel processors can access during web research and to apply a freshness constraint. It’s available for both Tasks and Web Tools and lets you tailor search results by specifying domains to include or exclude and by setting a start date so results are limited to recent content.

​
Configuration

You can configure source control by setting the following parameters:
ParameterTypeSupportedDescription
include_domainsarray[string]Task API, Search APIList of domains to allow. Only sources from these domains will be included in results. Maximum 10 domains.
exclude_domainsarray[string]Task API, Search APIList of domains to block. Sources from these domains will be excluded from results. Maximum 10 domains.
after_datestring<date>Search APIOptional start date for filtering results. Results are limited to content published on or after this date. Provided as an RFC 3339 date string (YYYY-MM-DD).
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.