{
  "description": "Search Zillow by city, ZIP, property URL, ZPID or address; filter buy, rent and sold listings; enrich each record with property or rental-building detail.",
  "properties": {
    "addresses": {
      "description": "Full street addresses to resolve to Zillow property pages, for example '1306 Castle Ct, Houston, TX 77006'.",
      "editor": "stringList",
      "items": {
        "type": "string"
      },
      "title": "Street Addresses",
      "type": "array"
    },
    "amenities": {
      "description": "Only include listings with the selected amenities.",
      "editor": "select",
      "items": {
        "enum": [
          "pool",
          "garage",
          "airConditioning",
          "waterfront",
          "cityView",
          "threeDHome",
          "age55Plus",
          "singleStory",
          "basementFinished",
          "basementUnfinished",
          "waterView",
          "mountainView",
          "parkView"
        ],
        "enumTitles": [
          "Pool",
          "Garage",
          "Air conditioning",
          "Waterfront",
          "City view",
          "3D home",
          "55+ community",
          "Single story",
          "Finished basement",
          "Unfinished basement",
          "Water view",
          "Mountain view",
          "Park view"
        ],
        "type": "string"
      },
      "title": "Amenities",
      "type": "array"
    },
    "auctionOnly": {
      "default": false,
      "description": "Only include auction listings.",
      "prefill": false,
      "title": "Auction Only",
      "type": "boolean"
    },
    "bathsMin": {
      "default": "any",
      "description": "Minimum number of bathrooms.",
      "editor": "select",
      "enum": [
        "any",
        "1",
        "1.5",
        "2",
        "2.5",
        "3",
        "4",
        "5"
      ],
      "enumTitles": [
        "Any",
        "1+",
        "1.5+",
        "2+",
        "2.5+",
        "3+",
        "4+",
        "5+"
      ],
      "title": "Minimum Bathrooms",
      "type": "string"
    },
    "bedsMin": {
      "default": "any",
      "description": "Minimum number of bedrooms.",
      "editor": "select",
      "enum": [
        "any",
        "1",
        "2",
        "3",
        "4",
        "5"
      ],
      "enumTitles": [
        "Any",
        "1+",
        "2+",
        "3+",
        "4+",
        "5+"
      ],
      "title": "Minimum Bedrooms",
      "type": "string"
    },
    "daysOnZillow": {
      "default": "any",
      "description": "Only include listings added within this period.",
      "editor": "select",
      "enum": [
        "any",
        "1",
        "7",
        "14",
        "30",
        "90",
        "180",
        "365",
        "730",
        "1095"
      ],
      "enumTitles": [
        "Any",
        "1 day",
        "7 days",
        "14 days",
        "30 days",
        "90 days",
        "6 months",
        "12 months",
        "24 months",
        "36 months"
      ],
      "title": "Days on Zillow",
      "type": "string"
    },
    "endPage": {
      "default": 5,
      "description": "Maximum search result pages per search task (1-24). Zillow returns up to 41 listings per page.",
      "maximum": 24,
      "minimum": 1,
      "prefill": 1,
      "title": "Maximum Pages",
      "type": "integer"
    },
    "foreclosureOnly": {
      "default": false,
      "description": "Only include foreclosure listings.",
      "prefill": false,
      "title": "Foreclosure Only",
      "type": "boolean"
    },
    "fsboOnly": {
      "default": false,
      "description": "Only include for-sale-by-owner listings.",
      "prefill": false,
      "title": "For Sale By Owner Only",
      "type": "boolean"
    },
    "hoaMax": {
      "description": "Maximum monthly HOA fee in US dollars.",
      "maximum": 10000,
      "minimum": 0,
      "title": "Maximum HOA Fee",
      "type": "integer"
    },
    "includePending": {
      "default": false,
      "description": "Add pending and under-contract listings to active results.",
      "prefill": false,
      "title": "Include Pending Listings",
      "type": "boolean"
    },
    "keyword": {
      "description": "Free-text keyword to match in the listing, for example 'pool'.",
      "editor": "textfield",
      "title": "Keyword",
      "type": "string"
    },
    "lotSizeMax": {
      "default": "any",
      "description": "Maximum lot size in square feet.",
      "editor": "select",
      "enum": [
        "any",
        "2000",
        "5000",
        "10890",
        "21780",
        "43560",
        "87120"
      ],
      "enumTitles": [
        "Any",
        "2,000 sqft",
        "5,000 sqft",
        "0.25 acre",
        "0.5 acre",
        "1 acre",
        "2 acres"
      ],
      "title": "Maximum Lot Size",
      "type": "string"
    },
    "lotSizeMin": {
      "default": "any",
      "description": "Minimum lot size in square feet.",
      "editor": "select",
      "enum": [
        "any",
        "2000",
        "5000",
        "10890",
        "21780",
        "43560",
        "87120"
      ],
      "enumTitles": [
        "Any",
        "2,000 sqft",
        "5,000 sqft",
        "0.25 acre",
        "0.5 acre",
        "1 acre",
        "2 acres"
      ],
      "title": "Minimum Lot Size",
      "type": "string"
    },
    "maxItems": {
      "default": 50,
      "description": "Maximum number of records for the whole run across all sources (1-5000).",
      "maximum": 5000,
      "minimum": 1,
      "prefill": 3,
      "title": "Maximum Properties",
      "type": "integer"
    },
    "mode": {
      "default": "BUY",
      "description": "Search active for-sale listings, rentals, or recently sold listings.",
      "editor": "select",
      "enum": [
        "BUY",
        "RENT",
        "SOLD"
      ],
      "enumTitles": [
        "For Sale (Buy)",
        "For Rent",
        "Recently Sold"
      ],
      "prefill": "BUY",
      "title": "Search Mode",
      "type": "string"
    },
    "newConstructionOnly": {
      "default": false,
      "description": "Only include new-construction listings.",
      "prefill": false,
      "title": "New Construction Only",
      "type": "boolean"
    },
    "openHouseOnly": {
      "default": false,
      "description": "Only include listings with an open house.",
      "prefill": false,
      "title": "Open House Only",
      "type": "boolean"
    },
    "parkingSpotsMin": {
      "description": "Minimum number of parking spots (1-10).",
      "maximum": 10,
      "minimum": 1,
      "title": "Minimum Parking Spots",
      "type": "integer"
    },
    "priceMax": {
      "description": "Maximum listing price in US dollars.",
      "maximum": 100000000,
      "minimum": 0,
      "title": "Maximum Price",
      "type": "integer"
    },
    "priceMin": {
      "description": "Minimum listing price in US dollars.",
      "maximum": 100000000,
      "minimum": 0,
      "sectionCaption": "Filters",
      "sectionDescription": "Filters are applied to location searches and search URLs through Zillow's searchQueryState.",
      "title": "Minimum Price",
      "type": "integer"
    },
    "priceReducedOnly": {
      "default": false,
      "description": "Only include listings with a price reduction.",
      "prefill": false,
      "title": "Price Reduced Only",
      "type": "boolean"
    },
    "propertyTypes": {
      "description": "Limit results to selected property types. Leave empty for all homes.",
      "editor": "select",
      "items": {
        "enum": [
          "house",
          "condo",
          "townhouse",
          "multiFamily",
          "manufactured",
          "lotLand",
          "apartment"
        ],
        "enumTitles": [
          "House",
          "Condo",
          "Townhouse",
          "Multi-family",
          "Manufactured",
          "Lot / Land",
          "Apartment"
        ],
        "type": "string"
      },
      "title": "Property Types",
      "type": "array"
    },
    "rentalFilters": {
      "description": "Rent-only filters. Ignored with a status note outside RENT mode.",
      "editor": "select",
      "items": {
        "enum": [
          "pets",
          "furnished",
          "parking",
          "inUnitLaundry",
          "shortTerm",
          "noPets",
          "byOwner",
          "incomeRestricted",
          "studentHousing",
          "onlyRentalSeniorHousingType",
          "hasFitnessCenter",
          "hasDishwasher",
          "onlyRentalInstantTourAvailable",
          "hasAcceptingBackupOffers"
        ],
        "enumTitles": [
          "Pets allowed",
          "Furnished",
          "Parking",
          "In-unit laundry",
          "Short-term lease",
          "No pets",
          "By owner",
          "Income restricted",
          "Student housing",
          "Senior housing",
          "Fitness center",
          "Dishwasher",
          "Instant tour available",
          "Accepting backup offers"
        ],
        "type": "string"
      },
      "sectionCaption": "Rental Filters",
      "sectionDescription": "These filters apply only to RENT searches.",
      "title": "Rental Filters",
      "type": "array"
    },
    "scrapeDetails": {
      "default": true,
      "description": "Fetch each search result's detail page for description, photos, MLS, tax, open house and building floor plans. Explicit URLs, ZPIDs and addresses are always enriched.",
      "prefill": false,
      "sectionCaption": "Options",
      "title": "Scrape Full Details",
      "type": "boolean"
    },
    "search": {
      "description": "City, ZIP, neighborhood, county or state to search (for example 'Houston, TX' or '77002').",
      "editor": "textfield",
      "prefill": "Houston, TX",
      "sectionCaption": "Search Settings",
      "sectionDescription": "Enter a location and choose a search mode. You can also use the lookup lists below or paste URLs.",
      "title": "Search Location",
      "type": "string"
    },
    "sortBy": {
      "default": "relevance",
      "description": "Result order. Relevance uses Zillow's priority order in RENT mode.",
      "editor": "select",
      "enum": [
        "relevance",
        "priceLow",
        "priceHigh",
        "newest",
        "zestimate",
        "zestimateLow"
      ],
      "enumTitles": [
        "Relevance",
        "Price: low to high",
        "Price: high to low",
        "Newest",
        "Zestimate: high to low",
        "Zestimate: low to high"
      ],
      "title": "Sort By",
      "type": "string"
    },
    "sqftMax": {
      "description": "Maximum living area in square feet.",
      "maximum": 100000,
      "minimum": 0,
      "title": "Maximum Square Feet",
      "type": "integer"
    },
    "sqftMin": {
      "description": "Minimum living area in square feet.",
      "maximum": 100000,
      "minimum": 0,
      "title": "Minimum Square Feet",
      "type": "integer"
    },
    "startUrls": {
      "default": [],
      "description": "Property detail URLs, /apartments/ building URLs, or Zillow search page URLs. Search URLs keep their own filters and mode.",
      "editor": "requestListSources",
      "items": {
        "properties": {
          "url": {
            "description": "Page URL to scrape.",
            "title": "URL",
            "type": "string"
          }
        },
        "type": "object"
      },
      "sectionCaption": "Lookup Lists",
      "sectionDescription": "Use any combination of URLs, ZPIDs and street addresses. Explicit detail sources are always enriched.",
      "title": "Start URLs",
      "type": "array"
    },
    "yearBuiltMax": {
      "description": "Latest construction year.",
      "maximum": 2026,
      "minimum": 1800,
      "title": "Built Before",
      "type": "integer"
    },
    "yearBuiltMin": {
      "description": "Earliest construction year.",
      "maximum": 2026,
      "minimum": 1800,
      "title": "Built After",
      "type": "integer"
    },
    "zpids": {
      "description": "Zillow property IDs or URLs containing _zpid. Each ZPID is resolved to its canonical detail page.",
      "editor": "stringList",
      "items": {
        "type": "string"
      },
      "title": "ZPIDs",
      "type": "array"
    }
  },
  "required": [
    "mode"
  ],
  "schemaVersion": 1,
  "title": "Zillow For-Sale, Rent & Sold Listing Extractor",
  "type": "object"
}