Filter your Valyu DeepSearch results by publication date to find exactly the content you need, when you need it. Whether you’re researching recent breakthroughs or analysing historical trends, date filtering ensures temporal precision in your AI’s knowledge retrieval.
Date filters use the ISO 8601 standard format: YYYY-MM-DD. Both start_date and end_date are optional parameters that work independently or together.

Why Use Date Filtering?

Date and time filters provide precise temporal control over your search results, enabling you to:
  • 🎯 Find recent developments - Get the latest research, news, or market data
  • πŸ“š Access historical content - Research how topics evolved over time
  • ⚑ Improve search efficiency - Reduce noise by focusing on relevant time periods
  • πŸ” Enable trend analysis - Compare content across different eras

Parameters Reference

start_date

Format: YYYY-MM-DDOnly include content published on or after this date.Example: "2024-01-01"

end_date

Format: YYYY-MM-DDOnly include content published on or before this date.Example: "2024-12-31"

Date Format Requirements

Strict Format Required: Dates must match the YYYY-MM-DD format exactly (ISO 8601 standard).
βœ… Correct Format❌ Incorrect Format
"2024-03-15""3/15/2024"
"2024-01-01""March 15, 2024"
"2024-12-31""15-03-2024"

Quick Start Examples

Recent Content Only

Perfect for getting the latest information on rapidly evolving topics:
from valyu import Valyu

valyu = Valyu(api_key="your-valyu-api-key")
response = valyu.search(
    query="quantum computing breakthroughs",
    start_date="2024-06-01"  # Only content from June 2024 onwards
)

Specific Date Range

Ideal for research within defined time periods:
from valyu import Valyu

valyu = Valyu(api_key="your-valyu-api-key")
response = valyu.search(
    query="artificial intelligence ethics",
    start_date="2023-01-01",
    end_date="2023-12-31"  # All of 2023
)

Historical Research

Great for studying foundational work or past trends:
from valyu import Valyu

valyu = Valyu(api_key="your-valyu-api-key")
response = valyu.search(
    query="machine learning foundations",
    end_date="2015-12-31"  # Pre-deep learning era
)

Advanced Usage Patterns

Combine with Search Types

Date filters work seamlessly with other parameters for maximum precision:
from valyu import Valyu

valyu = Valyu(api_key="your-valyu-api-key")

# Recent academic research only
academic_response = valyu.search(
    query="climate change mitigation strategies",
    search_type="proprietary",  # Academic sources
    start_date="2024-01-01",
    max_num_results=10
)

# Recent web content and news
web_response = valyu.search(
    query="climate change mitigation strategies", 
    search_type="web",  # Web sources
    start_date="2024-01-01",
    max_num_results=10
)

Source-Specific Date Filtering

Target specific domains or datasets within time ranges:
from valyu import Valyu

valyu = Valyu(api_key="your-valyu-api-key")
response = valyu.search(
    query="neural network architecture innovations",
    included_sources=["arxiv.org", "openai.com"],
    start_date="2024-01-01",
    max_num_results=15
)

Use Case Examples

πŸ“ˆ Market Intelligence

Track market trends, earnings reports, and economic indicators within specific periods:
from valyu import Valyu

valyu = Valyu(api_key="your-valyu-api-key")
response = valyu.search(
    query="cryptocurrency adoption trends Q4 2024",
    start_date="2024-10-01",
    search_type="all",
    max_num_results=10
)

πŸŽ“ Academic Research

Find recent papers, compare research across eras, or track scientific progress:
from valyu import Valyu

valyu = Valyu(api_key="your-valyu-api-key")
response = valyu.search(
    query="CRISPR gene editing therapeutic applications",
    search_type="proprietary",  # Academic sources only
    start_date="2023-06-01",
    max_num_results=15
)

πŸ“Š Trend Analysis

Study how topics, opinions, or technologies evolved over different time periods:
from valyu import Valyu

valyu = Valyu(api_key="your-valyu-api-key")

# Compare AI discourse: early era vs modern era
early_ai = valyu.search(
    query="artificial intelligence capabilities",
    start_date="1980-01-01",
    end_date="2000-12-31"
)

modern_ai = valyu.search(
    query="artificial intelligence capabilities", 
    start_date="2020-01-01",
    end_date="2024-12-31"
)

πŸ“… Event-Based Research

Research content around specific events, crises, or breakthrough moments:
from valyu import Valyu

valyu = Valyu(api_key="your-valyu-api-key")
response = valyu.search(
    query="remote work productivity studies",
    start_date="2020-03-01",
    end_date="2022-12-31",  # Pandemic era
    search_type="all",
    max_num_results=20
)

Best Practices

Performance Tip: More specific date ranges typically improve response times and result relevance by reducing the search space.

Strategic Date Range Selection

Content TypeRecommended RangeReasoning
Academic Papers6-12 monthsLonger publication cycles
News & Current EventsDays to weeksFast-moving information
Technical Documentation1-3 monthsRegular updates, best practices
Financial ReportsQuarters or yearsReporting cycles and trends

Date filtering provides powerful temporal control over your Valyu DeepSearch results, enabling precise content discovery for time-sensitive research, historical analysis, and trend tracking across all data sources.