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.
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
When you include these parameters in your API request, you'll receive properties that were listed within the specified date range.
This request returns properties listed during April 2025.
The parameters accept dates in ISO 8601 format:
YYYY-MM-DD (e.g., 2025-04-15)
You can use either parameter independently:
minListDate only: Get properties listed on or after a specific date
maxListDate only: Get properties listed on or before a specific date
These date parameters can be combined with other API filters:
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.
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-30This 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-012. Properties Listed in Last 30 Days
GET /listings?minListDate=2025-04-01&maxListDate=2025-05-013. Properties Listed in Specific Month
GET /listings?minListDate=2025-03-01&maxListDate=2025-03-31Advanced 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-01maxListDate only: Get properties listed on or before a specific date
GET /listings?maxListDate=2025-04-30Combining 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=3Need 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
Thank you!