PostSearchRequest

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/housedata-dev/json-schema/housedata-dev-post-search-request-schema.json",
  "title": "PostSearchRequest",
  "x-generated": "2026-10-30",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/_ae-authored/housedata-dev-openapi-generated.yml#/components/schemas/PostSearchRequest",
  "type": "object",
  "properties": {
    "location": {
      "type": "string",
      "description": "A city, ZIP, neighborhood or county as typed into Zillow. Required unless regionId is given."
    },
    "regionId": {
      "type": "string",
      "description": "A Zillow region id from /autocomplete, instead of location."
    },
    "status": {
      "type": "string",
      "description": "one of forSale, forRent, sold · default forSale"
    },
    "sort": {
      "type": "string",
      "description": "one of relevance, daysOn, price, beds, baths, livingArea, lotArea, yearBuilt, recentlyChanged, featured, rentalPriorityScore"
    },
    "sortAscending": {
      "type": "boolean",
      "description": "default false"
    },
    "page": {
      "type": "integer",
      "description": "≥ 1 · default 1"
    },
    "pageSize": {
      "type": "integer",
      "description": "1–40 · default 20"
    },
    "fields": {
      "type": "string",
      "description": "Projection applied to each result's property"
    }
  }
}