> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.repliers.com/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Using minListDate and maxListDate Parameters For Days On Market Filtering

The `/listings` API endpoint provides filtering capabilities through the `minListDate` and `maxListDate` parameters. These parameters allow you to precisely target properties based on their time on market, enabling you to offer days on market filters. 

## What are minListDate and maxListDate?

These two parameters work together to filter properties based on when they were listed on the market:

* **minListDate**: Sets the earliest listing date to include in results
* **maxListDate**: Sets the latest listing date to include in results

## Basic Usage

When you include these parameters in your API request, you'll receive properties that were listed within the specified date range.

### Example Request

```
GET /listings?minListDate=2025-04-01&maxListDate=2025-04-30
```

This request returns properties listed during April 2025.

## Date Format

The parameters accept dates in ISO 8601 format:

* `YYYY-MM-DD` (e.g., 2025-04-15)

## Common Filtering Scenarios

### 1. Properties Listed in Last 7 Days

```
GET /listings?minListDate=2025-04-24&maxListDate=2025-05-01
```

### 2. Properties Listed in Last 30 Days

```
GET /listings?minListDate=2025-04-01&maxListDate=2025-05-01
```

### 3. Properties Listed in Specific Month

```
GET /listings?minListDate=2025-03-01&maxListDate=2025-03-31
```

## Advanced Usage

### Using Only One Parameter

You can use either parameter independently:

* **minListDate only**: Get properties listed on or after a specific date
    
```
GET /listings?minListDate=2025-01-01
```
    
* **maxListDate only**: Get properties listed on or before a specific date
    
```
GET /listings?maxListDate=2025-04-30
```

### Combining with Other Filters

These date parameters can be combined with other API filters:

```
GET /listings?minListDate=2025-04-01&maxListDate=2025-04-30&minPrice=300000&maxPrice=500000&bedrooms=3
```

### New listings vs. listing updates (delta)
 - `minListDate` / `maxListDate` filters by **when the listing was first listed**.
 - If you want a 'delta' for a feed of **changes** (price changes, status changes, edits), use `minUpdatedOn` (polling) or webhooks.

 See: [Data Replication with Repliers](https://help.repliers.com/en/article/data-replication-with-repliers-1nqvact/)

# What questions does this article answer?

* How do `minListDate` and `maxListDate` work on the `/listings` endpoint?  
* How can I filter properties based on when they were listed (time on market)?  
* How can I implement a "Days on Market" filter in my UI using these date parameters?  
* What's the basic pattern for targeting a specific listing date range?