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, enabled 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

Need support?

If you encounter any issues implementing these parameters or have additional questions about our API capabilities, please don't hesitate to reach out to our support team. We're here to help you make the most of our listing data and ensure your integration is successful.

Updated on: 01/05/2025