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

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?

Updated on: 05/12/2025