Search sales with filters
Search and list individual real-estate sale transactions and active listings with filters — one row per sale/listing. Filter by location (state, county, city, zip), sale price, sale or listing date, property characteristics (beds, baths, square footage, property type), and listing status, with sorting and cursor pagination. This is the discrete per-transaction sales-record search: use it to find specific sales or build a filtered list of sold/active listings. If you only need how many sales match and not the records themselves, send the same request body to countSales.
In: header
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/v1/sales" \ -H "Content-Type: application/json" \ -d '{}'{
"cursor": "string",
"data": [
{
"apn": "string",
"baths": 0,
"beds": 0,
"buyerName": "string",
"city": "string",
"coordinates": {
"lat": 0,
"lon": 0
},
"daysOnMarket": 0,
"fips": "string",
"id": "string",
"listPrice": 0,
"listingAgentId": "string",
"listingAgentName": "string",
"mlsStatus": "SLD",
"originalListPrice": 0,
"propertyType": "string",
"recordingDate": "string",
"salePrice": 0,
"sellerName": "string",
"soldAgentId": "string",
"soldAgentName": "string",
"soldPrice": 0,
"sqft": 0,
"state": "string",
"streetAddress": "string",
"transactionDate": "string",
"yearBuilt": 0,
"zipCode": "string"
}
],
"locationNormalizations": [
{
"candidates": [
"string"
],
"confidence": "normalized",
"displayName": "Saint Louis, MO",
"field": "city",
"id": "city_mo_saint-louis",
"normalized": "Saint Louis",
"original": "St. Louis",
"variants": [
"string"
]
}
],
"total": 0
}{
"error": "string"
}{
"error": "string"
}{
"error": "string"
}{
"error": "string"
}{
"error": "string",
"limit": 0,
"size": 0
}