Take precise control over your search sources with DeepSearch’s source filtering capabilities. Whether you need to focus on specific authoritative domains, access particular datasets, or exclude unreliable sources, source filtering ensures your AI gets exactly the right content.
Source filters accept domains, URLs, dataset names, or specific paths.

​
Why Use Source Filtering?

Source filtering provides granular control over your search results, enabling you to:
  • 🎯 Target authoritative sources - Focus on trusted domains and academic datasets
  • 🚫 Block unreliable content - Exclude known low-quality or biased sources
  • 📚 Access specific datasets - Search within Valyu’s proprietary academic collections
  • ⚡ Improve result quality - Get more relevant, higher-quality information

​
Parameters Reference

included_sources

Type: Array of stringsOnly search within these specific sources. Can include domains, URLs, or dataset names.Example: ["arxiv.org", "valyu/valyu-pubmed"]

excluded_sources

Type: Array of stringsExclude these sources from search results. Supports the same formats as included_sources.Example: ["reddit.com", "news.ycombinator.com"]
If both included_sources and excluded_sources are provided, the included_sources will override the excluded_sources.

​
Source Format Options

Valyu supports multiple source specification formats for maximum flexibility:
FormatExampleWhat It Does
Domain Name"arxiv.org"Includes/excludes entire domain
Base URL"https://docs.aws.amazon.com"Includes/excludes entire site
Specific Path"techcrunch.com/news"Targets only that specific path
Dataset Name"valyu/valyu-arxiv"Searches Valyu’s proprietary datasets
Path Specificity: When using specific paths (e.g., "valyu.network/blog"), only that exact path is included/excluded. For entire domains, use just the domain name or base URL.

​
Quick Start Examples

​
Focus on Academic Sources

Perfect for research requiring peer-reviewed, scholarly content: 
from valyu import Valyu

valyu = Valyu(api_key="your-valyu-api-key")
response = valyu.search(
    "quantum computing error correction",
    included_sources=[
        "arxiv.org",
        "valyu/valyu-arxiv", 
        "valyu/valyu-pubmed",
        "nature.com",
        "science.org"
    ],
    search_type="all"
)

​
Exclude Social Media and Forums

Remove noise from social platforms and discussion forums: 
from valyu import Valyu

valyu = Valyu(api_key="your-valyu-api-key")
response = valyu.search(
    "artificial intelligence safety research",
    excluded_sources=[
        "reddit.com",
        "news.ycombinator.com", 
        "twitter.com",
        "linkedin.com",
        "quora.com"
    ]
)

​
Target Specific Documentation Sites

Focus on official documentation and technical resources: 
from valyu import Valyu

valyu = Valyu(api_key="your-valyu-api-key")
response = valyu.search(
    "React server components best practices",
    included_sources=[
        "https://react.dev/",
        "https://nextjs.org/docs",
        "https://docs.aws.amazon.com/",
        "developer.mozilla.org"
    ]
)

​
Use Case Examples

​
Financial Research

Target authoritative financial sources for market analysis and economic research: 
from valyu import Valyu

valyu = Valyu(api_key="your-valyu-api-key")
response = valyu.search(
    "cryptocurrency regulation impact banking sector",
    included_sources=[
        "federalreserve.gov",
        "sec.gov", 
        "reuters.com/business",
        "bloomberg.com",
        "imf.org"
    ],
    max_num_results=15
)

​
Medical Research

Access peer-reviewed medical literature and clinical data: 
from valyu import Valyu

valyu = Valyu(api_key="your-valyu-api-key")
response = valyu.search(
    "immunotherapy cancer treatment efficacy",
    included_sources=[
        "valyu/valyu-pubmed",
        "valyu/valyu-clinical-trials",
        "valyu/valyu-drug-labels",
        "nejm.org",
        "thelancet.com", 
        "nature.com/nm"
    ],
    search_type="proprietary"
)

​
Technical Documentation

Focus on official documentation and authoritative technical sources: 
from valyu import Valyu

valyu = Valyu(api_key="your-valyu-api-key")
response = valyu.search(
    "Kubernetes security best practices RBAC",
    included_sources=[
        "kubernetes.io/docs",
        "docs.aws.amazon.com",
        "cloud.google.com/kubernetes-engine/docs"
    ]
)

​
News and Current Events

Get balanced news coverage while avoiding biased or unreliable sources: 
from valyu import Valyu

valyu = Valyu(api_key="your-valyu-api-key")
response = valyu.search(
    "artificial intelligence regulation European Union",
    included_sources=[
        "reuters.com",
        "bbc.com/news",
        "apnews.com", 
        "europa.eu",
        "politico.eu"
    ]
)