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-DDInclude content published on or after this date.Example: "2024-01-01"
end_date
Format: YYYY-MM-DDInclude content published on or before this date.Example: "2024-12-31"
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
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
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
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
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
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
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
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 |
