# Search API — Filter Results by Date Range

**URL:** <https://community.perplexity.ai/t/search-api-filter-results-by-date-range/4741>\
**Category:** Announcements\
**Created:** [October 29, 2025, 5:00pm UTC](https://community.perplexity.ai/t/search-api-filter-results-by-date-range/4741 "2025-10-29T17:00:00Z")\
**Posts on this page:** 1\
**Page:** 1

<div class="post-metadata">

**Author:** ![Kesku](https://sea1.discourse-cdn.com/flex001/user_avatar/community.perplexity.ai/kesku/32/898_2.png) [@Kesku](https://community.perplexity.ai/u/Kesku)\
**Post date:** [October 29, 2025, 5:00pm UTC](https://community.perplexity.ai/t/search-api-filter-results-by-date-range/4741/1 "2025-10-29T17:00:00Z")

</div>

New in the Perplexity Search API — developers can now filter search results by specific time periods or recency.

Perfect for getting only the most recent results or narrowing to a specific date window.

 ![img_date_filter.jpg](https://us1.discourse-cdn.com/flex001/uploads/sonar1/original/2X/5/5cf25815ad4c4d4043e5df9e7529816e52615de1.jpeg)

```python
# Simple recency filter
search = client.search.create(
    query="AI safety research",
    search_recency_filter="month"
)

# Precise date range
search = client.search.create(
    query="AI safety research",
    search_after_date_filter="01/01/2025",
    search_before_date_filter="06/30/2025"
)

```

Available recency values: `hour`, `day`, `week`, `month`, `year`.

Docs: [Date/Time Filters](https://docs.perplexity.ai/docs/search/filters/date-time-filters)