Raw schema
{
"type": "object",
"properties": {
"query": {
"description": "Keywords to match in the sale title or description, e.g. \"mid-century\" or \"tools\"",
"type": "string",
"maxLength": 100
},
"city": {
"description": "City name, e.g. \"Grand Rapids\"",
"type": "string",
"maxLength": 80
},
"zip": {
"description": "5-digit US ZIP code",
"type": "string",
"pattern": "^\\d{5}$"
},
"lat": {
"description": "Latitude for a radius search (use with lng)",
"type": "number",
"minimum": -90,
"maximum": 90
},
"lng": {
"description": "Longitude for a radius search (use with lat)",
"type": "number",
"minimum": -180,
"maximum": 180
},
"radiusKm": {
"description": "Radius in kilometers for lat/lng search (default 25)",
"type": "number",
"minimum": 1,
"maximum": 200
},
"startDate": {
"description": "Only sales starting on or after this date (YYYY-MM-DD)",
"type": "string",
"maxLength": 30
},
"endDate": {
"description": "Only sales starting on or before this date (YYYY-MM-DD)",
"type": "string",
"maxLength": 30
},
"saleType": {
"description": "Sale type code: ESTATE (whole-house sale), YARD (yard or garage sale), AUCTION, FLEA_MARKET, RETAIL (shop or storefront, incl. consignment), DORM_DASH (dorm move-out).",
"maxItems": 6,
"type": "array",
"items": {
"type": "string",
"enum": [
"ESTATE",
"YARD",
"AUCTION",
"FLEA_MARKET",
"RETAIL",
"DORM_DASH"
]
}
},
"limit": {
"description": "Max results (default 20, max 50)",
"type": "integer",
"minimum": 1,
"maximum": 50
},
"minConfidence": {
"description": "Minimum listing confidence 0 to 1. 0.7 = organizer-verified, 0.4 = corroborated by a third party.",
"type": "number",
"minimum": 0,
"maximum": 1
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}