Date and Time Filtering

Filter search results by publication date

Filter search results by publication date. Find recent breakthroughs or analyse historical trends.

Dates use ISO 8601 format: YYYY-MM-DD. Both start_date and end_date are optional and work independently or together.

What You Can Do

• Find recent developments - Get the latest research, news, or market data
• Access historical content - Research how topics evolved over time
• Reduce noise - Focus on relevant time periods
• Enable trend analysis - Compare content across different eras

Parameters

start_date

Format: YYYY-MM-DD

Include content published on or after this date.

Example: "2024-01-01"

end_date

Format: YYYY-MM-DD

Include content published on or before this date.

Example: "2024-12-31"

Date Format

Dates must match YYYY-MM-DD exactly (ISO 8601 standard).

✅ Correct	❌ Incorrect
"2024-03-15"	"3/15/2024"
"2024-01-01"	"March 15, 2024"
"2024-12-31"	"15-03-2024"

Examples

Recent Content

Python

from valyu import Valyu

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

Date Range

Python

from valyu import Valyu

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

Historical Research

Python

from valyu import Valyu

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

Use Cases

Market Intelligence

Python

from valyu import Valyu

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

Academic Research

Python

from valyu import Valyu

valyu = Valyu("your-api-key-here")
response = valyu.search(
    "CRISPR gene editing therapeutic applications",
    search_type="proprietary",
    start_date="2023-06-01",
    max_num_results=15
)

Trend Analysis

Python

from valyu import Valyu

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

# Early AI era
early_ai = valyu.search(
    "artificial intelligence capabilities",
    start_date="1980-01-01",
    end_date="2000-12-31"
)

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

Event-Based Research

Python

from valyu import Valyu

valyu = Valyu("your-api-key-here")
response = valyu.search(
    "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

More specific date ranges typically improve response times and result relevance.

Recommended Ranges

Content Type	Recommended Range	Why
Academic Papers	6-12 months	Longer publication cycles
News	Days to weeks	Fast-moving information
Technical Docs	1-3 months	Regular updates
Financial Reports	Quarters or years	Reporting cycles