{
  "data": {
    "id": "LHqBAKVU6YO7qxV6c",
    "actId": "TFgUch48s7mbPQ6Kw",
    "userId": "zq8lKbpLzTjGDayPC",
    "startedAt": "2026-10-18T04:59:57.170Z",
    "finishedAt": "2026-10-18T05:00:14.696Z",
    "status": "SUCCEEDED",
    "meta": {
      "origin": "CLI"
    },
    "stats": {
      "durationMillis": 17445,
      "runTimeSecs": 17.445,
      "computeUnits": 0.019383333333333332,
      "imageSizeBytes": 367048192
    },
    "options": {
      "useCache": true,
      "betaPackages": false,
      "memoryMbytes": 4096,
      "diskMbytes": 8192
    },
    "createdByOrganizationMemberUserId": "GK9YjZRyQZVzOdoH5",
    "exitCode": 0,
    "inputSchema": "{\n  \"title\": \"Zillow Foreclosure Scraper Input\",\n  \"type\": \"object\",\n  \"schemaVersion\": 1,\n  \"properties\": {\n    \"locations\": {\n      \"title\": \"Locations\",\n      \"type\": \"array\",\n      \"description\": \"US locations to search, one per line: a city (\\\"Austin, TX\\\"), ZIP code (\\\"78701\\\"), neighborhood (\\\"Hyde Park, Austin, TX\\\") or county (\\\"Travis County, TX\\\").\",\n      \"editor\": \"stringList\",\n      \"prefill\": [\n        \"Austin, TX\"\n      ]\n    },\n    \"startUrls\": {\n      \"title\": \"Zillow search URLs\",\n      \"type\": \"array\",\n      \"description\": \"Zillow search pages to scrape instead of (or in addition to) locations. The distress filter is layered on top of whatever the URL already filters.\",\n      \"editor\": \"requestListSources\"\n    },\n    \"distressTypes\": {\n      \"title\": \"Distress types\",\n      \"type\": \"array\",\n      \"description\": \"Which distressed listing categories to return. Leave empty for all four.\",\n      \"editor\": \"select\",\n      \"items\": {\n        \"type\": \"string\",\n        \"enum\": [\n          \"foreclosure\",\n          \"preForeclosure\",\n          \"preMarketForeclosure\",\n          \"auction\",\n          \"bankOwned\"\n        ],\n        \"enumTitles\": [\n          \"Foreclosures for sale (incl. bank-owned)\",\n          \"Pre-foreclosures (pre-market)\",\n          \"Foreclosed, not yet listed (pre-market REO)\",\n          \"Foreclosure auctions\",\n          \"Bank-owned (REO) only\"\n        ]\n      },\n      \"prefill\": [\n        \"foreclosure\"\n      ]\n    },\n    \"priceMin\": {\n      \"title\": \"Minimum price ($)\",\n      \"type\": \"integer\",\n      \"description\": \"Lower bound on the listing price. Leave blank for no minimum.\",\n      \"editor\": \"number\",\n      \"minimum\": 0,\n      \"maximum\": 100000000\n    },\n    \"priceMax\": {\n      \"title\": \"Maximum price ($)\",\n      \"type\": \"integer\",\n      \"description\": \"Upper bound on the listing price. Leave blank for no maximum.\",\n      \"editor\": \"number\",\n      \"minimum\": 0,\n      \"maximum\": 100000000\n    },\n    \"bedsMin\": {\n      \"title\": \"Minimum bedrooms\",\n      \"type\": \"number\",\n      \"description\": \"Only include properties with at least this many bedrooms. Leave blank for no minimum.\",\n      \"editor\": \"number\",\n      \"minimum\": 0,\n      \"maximum\": 10\n    },\n    \"bathsMin\": {\n      \"title\": \"Minimum bathrooms\",\n      \"type\": \"number\",\n      \"description\": \"Only include properties with at least this many bathrooms (decimals allowed, e.g. 1.5). Leave blank for no minimum.\",\n      \"editor\": \"number\",\n      \"minimum\": 0,\n      \"maximum\": 10\n    },\n    \"homeTypes\": {\n      \"title\": \"Home types\",\n      \"type\": \"array\",\n      \"description\": \"Limit results to specific property types. Leave empty for all types.\",\n      \"editor\": \"select\",\n      \"items\": {\n        \"type\": \"string\",\n        \"enum\": [\n          \"singleFamily\",\n          \"condo\",\n          \"townhouse\",\n          \"multiFamily\",\n          \"apartment\",\n          \"manufactured\",\n          \"lotLand\"\n        ],\n        \"enumTitles\": [\n          \"Houses\",\n          \"Condos\",\n          \"Townhouses\",\n          \"Multi-family\",\n          \"Apartments\",\n          \"Manufactured homes\",\n          \"Lots / land\"\n        ]\n      }\n    },\n    \"daysOnZillow\": {\n      \"title\": \"Days on Zillow\",\n      \"type\": \"string\",\n      \"description\": \"Only include listings that have been on Zillow within this window.\",\n      \"editor\": \"select\",\n      \"enum\": [\n        \"any\",\n        \"1\",\n        \"7\",\n        \"14\",\n        \"30\",\n        \"90\",\n        \"6m\",\n        \"12m\",\n        \"24m\",\n        \"36m\"\n      ],\n      \"enumTitles\": [\n        \"Any time\",\n        \"Last 24 hours\",\n        \"Last 7 days\",\n        \"Last 14 days\",\n        \"Last 30 days\",\n        \"Last 90 days\",\n        \"Last 6 months\",\n        \"Last 12 months\",\n        \"Last 24 months\",\n        \"Last 36 months\"\n      ],\n      \"default\": \"any\"\n    },\n    \"sortBy\": {\n      \"title\": \"Sort by\",\n      \"type\": \"string\",\n      \"description\": \"Order in which Zillow returns the listings.\",\n      \"editor\": \"select\",\n      \"enum\": [\n        \"relevance\",\n        \"newest\",\n        \"priceDesc\",\n        \"priceAsc\",\n        \"beds\",\n        \"baths\",\n        \"size\",\n        \"lot\",\n        \"zestimateDesc\",\n        \"zestimateAsc\"\n      ],\n      \"enumTitles\": [\n        \"Relevance (Zillow's default)\",\n        \"Newest\",\n        \"Price: high to low\",\n        \"Price: low to high\",\n        \"Bedrooms\",\n        \"Bathrooms\",\n        \"Square feet\",\n        \"Lot size\",\n        \"Zestimate: high to low\",\n        \"Zestimate: low to high\"\n      ],\n      \"default\": \"relevance\"\n    },\n    \"includeDetails\": {\n      \"title\": \"Include full property details\",\n      \"type\": \"boolean\",\n      \"description\": \"Open each listing's detail page for the listing agent, photos, description, year built and distress flags. Adds one request per listing; rows still return without it.\",\n      \"default\": true,\n      \"prefill\": false\n    },\n    \"includeAuctionDetails\": {\n      \"title\": \"Include auction details (auction.com)\",\n      \"type\": \"boolean\",\n      \"description\": \"For auction listings whose page links to auction.com, also read that public page for the auction date/time, occupancy, starting bid and lender/attorney details. Adds one request per linked auction and requires \\\"Include full property details\\\".\",\n      \"default\": false,\n      \"prefill\": false\n    },\n    \"maxItems\": {\n      \"title\": \"Max items\",\n      \"type\": \"integer\",\n      \"description\": \"Maximum number of listings to return across all locations and URLs (1–5000).\",\n      \"editor\": \"number\",\n      \"minimum\": 1,\n      \"maximum\": 5000,\n      \"default\": 100,\n      \"prefill\": 3\n    }\n  },\n  \"required\": []\n}",
    "readme": "# Zillow Distressed Property Finder by City or ZIP\n\nZillow keeps its foreclosure, pre-foreclosure, pre-market REO and auction inventory inside its regular map search. This actor applies those distress filters server-side for you and returns structured records for any US city, ZIP code, neighborhood or county, with optional per-listing detail enrichment: listing agent, phone, brokerage, photos, description, year built, HOA and per-row distress flags.\n\n## What this actor does\n\n- Searches one or more locations: city (\"Austin, TX\"), ZIP (\"78701\"), neighborhood (\"Hyde Park, Austin, TX\") or county (\"Travis County, TX\").\n- Also accepts Zillow search URLs you already have; the distress filter is layered on top of the URL's own filters.\n- Restricts results to the distress categories you pick: foreclosures (including bank-owned), pre-foreclosures, pre-market foreclosed (REO) and auctions.\n- Applies Zillow's own filters server-side: price range, minimum beds/baths, home types, days on Zillow and sort order.\n- Pages through Zillow's result pages up to its own limit, with no browser and no cookies required.\n- Optionally opens each listing's detail page for the listing agent, photos, description, year built, HOA and authoritative distress flags.\n- Fields Zillow doesn't publish for a listing (no price, no Zestimate, no photos) are left out of that record rather than filled with a placeholder.\n\n## Output per listing\n\n| Field | Description |\n|---|---|\n| `zpid` | Zillow property ID. |\n| `url` | Zillow property detail page URL. |\n| `distressType` | `foreclosure`, `bankOwned`, `preForeclosure`, `preMarketForeclosure`, `auction` or `comingSoon`. |\n| `isForeclosure` / `isBankOwned` / `isPreForeclosure` / `isAuction` / `isComingSoon` | Per-listing distress flags as Zillow marks them. |\n| `homeStatus` / `statusText` | Raw Zillow status and its display label. |\n| `address` / `city` / `state` / `zipCode` | Property address components. |\n| `price` | Listing price, in USD. |\n| `zestimate` / `rentZestimate` | Zillow's value and rent estimates, in USD. |\n| `taxAssessedValue` | Tax-assessed value, in USD. |\n| `beds` / `baths` / `sqft` | Bedroom and bathroom counts, and living area in square feet. |\n| `lotAreaValue` / `lotAreaUnit` | Lot size and its unit (`sqft` or `acres`). |\n| `propertyType` / `yearBuilt` | Property type (e.g. `SINGLE_FAMILY`) and construction year. |\n| `latitude` / `longitude` | Property coordinates. |\n| `daysOnZillow` / `listedDate` | Days on Zillow and the date the listing was posted. |\n| `listingAgentName` / `listingAgentPhone` / `brokerName` / `mlsName` / `mlsId` | Listing attribution from the detail page. |\n| `photos` / `photoCount` | Property photo URLs (largest size, Zillow photo CDN only) and how many photos Zillow shows. |\n| `description` | Listing description text. |\n| `monthlyHoaFee` / `pricePerSquareFoot` | HOA fee and price per square foot when shown. |\n| `postingUrl` | External listing or auction page when Zillow provides one (e.g. an auction.com detail link). |\n| `auctionDate` / `auctionDateTime` | Auction date and sale start date-time, read from the linked auctioneer page. |\n| `startingBid` / `principalLoanAmount` | Published starting bid and original loan principal when the auctioneer shows them. |\n| `occupancyStatus` | Occupancy reported by the auctioneer (e.g. `OCCUPIED`, `VACANT`). |\n| `lender` / `servicer` | Beneficiary (lender) and loan servicer names. |\n| `foreclosureAttorney` / `foreclosureAttorneyPhone` | Foreclosure attorney / trustee firm and its phone. |\n| `buyerPremiumAvailable` | Whether the auction charges a buyer's premium. |\n| `auctionEventTitle` | The auctioneer's sale event title. |\n| `lastSoldPrice` / `lastSoldDate` | Most recent recorded sale price and date, when Zillow publishes them. |\n| `comingSoonDate` | The date a coming-soon listing is scheduled to go live. |\n| `scrapedAt` | ISO 8601 timestamp of when this actor fetched the record. |\n\n## Input\n\n| Field | Type | Default | Description |\n|---|---|---|---|\n| `locations` | Array of strings | – | Cities, ZIP codes, neighborhoods or counties — one entry each. |\n| `startUrls` | Array of URLs | – | Zillow search pages; the distress filter is applied on top. |\n| `distressTypes` | Array (select) | all four | `foreclosure`, `preForeclosure`, `preMarketForeclosure`, `auction`; legacy `bankOwned` (REO-only) is also accepted. Leave empty for all. |\n| `priceMin` / `priceMax` | Integer | – | Listing price bounds in USD. |\n| `bedsMin` / `bathsMin` | Number | – | Minimum bedrooms / bathrooms. |\n| `homeTypes` | Array (select) | all | `singleFamily`, `condo`, `townhouse`, `multiFamily`, `apartment`, `manufactured`, `lotLand`. |\n| `daysOnZillow` | Select | `any` | Only listings seen within the window (1 day … 36 months). |\n| `sortBy` | Select | `relevance` | Relevance, newest, price, beds, baths, size, lot or Zestimate. |\n| `includeDetails` | Boolean | `true` | Open each listing's detail page for agent, photos, description and year built. |\n| `includeAuctionDetails` | Boolean | `false` | Read the linked auctioneer page (auction.com only) for the auction schedule, starting bid, occupancy and lender/attorney fields. One extra request per linked auction; requires `includeDetails`. |\n| `maxItems` | Integer | `100` | Maximum listings across all locations and URLs (1–5000). |\n\nProvide at least one `locations` entry or one `startUrls` entry.\n\n### Example: foreclosures and auctions in one city\n\n```json\n{\n    \"locations\": [\"Phoenix, AZ\"],\n    \"distressTypes\": [\"foreclosure\", \"auction\"],\n    \"priceMax\": 400000,\n    \"includeDetails\": true,\n    \"maxItems\": 100\n}\n```\n\n### Example: bank-owned homes by ZIP code\n\n```json\n{\n    \"locations\": [\"85001\", \"85032\"],\n    \"distressTypes\": [\"preMarketForeclosure\"],\n    \"includeDetails\": true,\n    \"maxItems\": 200\n}\n```\n\n### Example: reuse a saved Zillow search URL\n\n```json\n{\n    \"startUrls\": [{\"url\": \"https://www.zillow.com/austin-tx/foreclosures/\"}],\n    \"maxItems\": 300\n}\n```\n\n## Use cases\n\n- **Distressed-inventory investing** — track foreclosure and pre-foreclosure properties before they hit the broader market.\n- **Wholesaling** — build a pre-foreclosure outreach list for a ZIP or neighborhood.\n- **Auction prep** — research properties scheduled for a foreclosure auction ahead of time.\n- **REO acquisition** — surface pre-market bank-owned properties for buy-and-hold portfolios.\n- **Market intelligence** — quantify distress rates by city, ZIP or county over time.\n\n## FAQ\n\n**What's the difference between the distress types?**\n`foreclosure` is an active foreclosure listing for sale (Zillow's foreclosure filter also includes bank-owned homes); `bankOwned` marks a home the lender already owns (REO); `preForeclosure` is a pre-market record early in the foreclosure process, not yet listed; `preMarketForeclosure` is a pre-market record the bank has already taken back; `auction` is a property scheduled for a foreclosure auction.\n\n**How many results can I get per run?**\nUp to 5,000 via `maxItems`. Zillow itself caps any single search at 20 result pages (about 820 listings). If a market hits that cap, split it into several `locations` — by home type, ZIP or neighborhood — and pass them together; the slices are disjoint, so their union covers the full inventory (verified: Los Angeles distressed inventory = 1,349 listings; its seven home-type slices sum to exactly 1,349).\n\n**Do I need proxies or cookies?**\nNo. The actor routes its requests automatically and needs no account, cookie or API key from you.\n\n**Why do some listings have no price or Zestimate?**\nZillow genuinely doesn't show a price or estimate for many pre-market distressed records. Those fields are omitted from the record instead of being filled with a placeholder.\n\n**Does this include auction dates, unpaid balances or lender details?**\nZillow's own pages don't carry them, but auction listings link out to the auctioneer (`postingUrl`). Turn on `includeAuctionDetails` and the actor also reads the linked auction.com page, adding the auction date and sale time, occupancy, starting bid, loan principal, lender, servicer and foreclosure attorney (each when the auctioneer publishes it). Roughly two thirds of sampled Zillow auctions link to auction.com; other auctioneers and unpaid balances are not covered.\n\n**Is this affiliated with Zillow?**\nNo. This actor is an independent tool that reads publicly visible Zillow search results and is not affiliated with or endorsed by Zillow.\n",
    "actorDefinition": {
      "actorSpecification": 1,
      "name": "zillow-distressed-property-finder-by-city-or-zip",
      "title": "Zillow Distressed Property Finder by City or ZIP",
      "description": "Find foreclosure, pre-foreclosure, bank-owned, and auction properties on Zillow by city, neighborhood, or ZIP, with price, Zestimate, tax value, and property specs for each listing.",
      "version": "1.0",
      "buildTag": "latest",
      "dockerfile": "./Dockerfile",
      "input": {
        "title": "Zillow Foreclosure Scraper Input",
        "type": "object",
        "schemaVersion": 1,
        "properties": {
          "locations": {
            "title": "Locations",
            "type": "array",
            "description": "US locations to search, one per line: a city (\"Austin, TX\"), ZIP code (\"78701\"), neighborhood (\"Hyde Park, Austin, TX\") or county (\"Travis County, TX\").",
            "editor": "stringList",
            "prefill": [
              "Austin, TX"
            ]
          },
          "startUrls": {
            "title": "Zillow search URLs",
            "type": "array",
            "description": "Zillow search pages to scrape instead of (or in addition to) locations. The distress filter is layered on top of whatever the URL already filters.",
            "editor": "requestListSources"
          },
          "distressTypes": {
            "title": "Distress types",
            "type": "array",
            "description": "Which distressed listing categories to return. Leave empty for all four.",
            "editor": "select",
            "items": {
              "type": "string",
              "enum": [
                "foreclosure",
                "preForeclosure",
                "preMarketForeclosure",
                "auction",
                "bankOwned"
              ],
              "enumTitles": [
                "Foreclosures for sale (incl. bank-owned)",
                "Pre-foreclosures (pre-market)",
                "Foreclosed, not yet listed (pre-market REO)",
                "Foreclosure auctions",
                "Bank-owned (REO) only"
              ]
            },
            "prefill": [
              "foreclosure"
            ]
          },
          "priceMin": {
            "title": "Minimum price ($)",
            "type": "integer",
            "description": "Lower bound on the listing price. Leave blank for no minimum.",
            "editor": "number",
            "minimum": 0,
            "maximum": 100000000
          },
          "priceMax": {
            "title": "Maximum price ($)",
            "type": "integer",
            "description": "Upper bound on the listing price. Leave blank for no maximum.",
            "editor": "number",
            "minimum": 0,
            "maximum": 100000000
          },
          "bedsMin": {
            "title": "Minimum bedrooms",
            "type": "number",
            "description": "Only include properties with at least this many bedrooms. Leave blank for no minimum.",
            "editor": "number",
            "minimum": 0,
            "maximum": 10
          },
          "bathsMin": {
            "title": "Minimum bathrooms",
            "type": "number",
            "description": "Only include properties with at least this many bathrooms (decimals allowed, e.g. 1.5). Leave blank for no minimum.",
            "editor": "number",
            "minimum": 0,
            "maximum": 10
          },
          "homeTypes": {
            "title": "Home types",
            "type": "array",
            "description": "Limit results to specific property types. Leave empty for all types.",
            "editor": "select",
            "items": {
              "type": "string",
              "enum": [
                "singleFamily",
                "condo",
                "townhouse",
                "multiFamily",
                "apartment",
                "manufactured",
                "lotLand"
              ],
              "enumTitles": [
                "Houses",
                "Condos",
                "Townhouses",
                "Multi-family",
                "Apartments",
                "Manufactured homes",
                "Lots / land"
              ]
            }
          },
          "daysOnZillow": {
            "title": "Days on Zillow",
            "type": "string",
            "description": "Only include listings that have been on Zillow within this window.",
            "editor": "select",
            "enum": [
              "any",
              "1",
              "7",
              "14",
              "30",
              "90",
              "6m",
              "12m",
              "24m",
              "36m"
            ],
            "enumTitles": [
              "Any time",
              "Last 24 hours",
              "Last 7 days",
              "Last 14 days",
              "Last 30 days",
              "Last 90 days",
              "Last 6 months",
              "Last 12 months",
              "Last 24 months",
              "Last 36 months"
            ],
            "default": "any"
          },
          "sortBy": {
            "title": "Sort by",
            "type": "string",
            "description": "Order in which Zillow returns the listings.",
            "editor": "select",
            "enum": [
              "relevance",
              "newest",
              "priceDesc",
              "priceAsc",
              "beds",
              "baths",
              "size",
              "lot",
              "zestimateDesc",
              "zestimateAsc"
            ],
            "enumTitles": [
              "Relevance (Zillow's default)",
              "Newest",
              "Price: high to low",
              "Price: low to high",
              "Bedrooms",
              "Bathrooms",
              "Square feet",
              "Lot size",
              "Zestimate: high to low",
              "Zestimate: low to high"
            ],
            "default": "relevance"
          },
          "includeDetails": {
            "title": "Include full property details",
            "type": "boolean",
            "description": "Open each listing's detail page for the listing agent, photos, description, year built and distress flags. Adds one request per listing; rows still return without it.",
            "default": true,
            "prefill": false
          },
          "includeAuctionDetails": {
            "title": "Include auction details (auction.com)",
            "type": "boolean",
            "description": "For auction listings whose page links to auction.com, also read that public page for the auction date/time, occupancy, starting bid and lender/attorney details. Adds one request per linked auction and requires \"Include full property details\".",
            "default": false,
            "prefill": false
          },
          "maxItems": {
            "title": "Max items",
            "type": "integer",
            "description": "Maximum number of listings to return across all locations and URLs (1–5000).",
            "editor": "number",
            "minimum": 1,
            "maximum": 5000,
            "default": 100,
            "prefill": 3
          }
        },
        "required": []
      },
      "output": {
        "actorOutputSchemaVersion": 1,
        "title": "Zillow Distressed Property Finder by City or ZIP Output",
        "description": "Distressed Zillow listings — foreclosures, pre-foreclosures, pre-market REO and auctions — with price, property specs, distress flags, listing agent, photos and location details.",
        "properties": {
          "foreclosures": {
            "type": "string",
            "title": "Zillow distressed listings",
            "description": "Dataset of scraped Zillow distressed listings.",
            "template": "{{links.apiDefaultDatasetUrl}}/items"
          }
        }
      },
      "storages": {
        "dataset": {
          "actorSpecification": 1,
          "title": "Zillow Foreclosure Listings",
          "fields": {
            "type": "object",
            "properties": {
              "zpid": {
                "type": "integer",
                "nullable": true,
                "description": "Zillow property ID"
              },
              "url": {
                "type": "string",
                "description": "Zillow property detail page URL"
              },
              "distressType": {
                "type": "string",
                "nullable": true,
                "description": "Distress classification: foreclosure, bankOwned, preForeclosure, preMarketForeclosure, auction, comingSoon"
              },
              "homeStatus": {
                "type": "string",
                "nullable": true,
                "description": "Raw Zillow homeStatus value"
              },
              "address": {
                "type": "string",
                "nullable": true,
                "description": "Street address"
              },
              "city": {
                "type": "string",
                "nullable": true,
                "description": "City"
              },
              "state": {
                "type": "string",
                "nullable": true,
                "description": "State abbreviation"
              },
              "zipCode": {
                "type": "string",
                "nullable": true,
                "description": "ZIP code"
              },
              "price": {
                "type": "number",
                "nullable": true,
                "description": "Listing price ($)"
              },
              "zestimate": {
                "type": "number",
                "nullable": true,
                "description": "Zillow estimate ($)"
              },
              "rentZestimate": {
                "type": "number",
                "nullable": true,
                "description": "Zillow rent estimate ($/month)"
              },
              "taxAssessedValue": {
                "type": "number",
                "nullable": true,
                "description": "Tax-assessed value ($)"
              },
              "beds": {
                "type": "number",
                "nullable": true,
                "description": "Bedrooms"
              },
              "baths": {
                "type": "number",
                "nullable": true,
                "description": "Bathrooms"
              },
              "sqft": {
                "type": "number",
                "nullable": true,
                "description": "Living area (sq ft)"
              },
              "lotAreaValue": {
                "type": "number",
                "nullable": true,
                "description": "Lot area size"
              },
              "lotAreaUnit": {
                "type": "string",
                "nullable": true,
                "description": "Lot area unit: sqft or acres"
              },
              "propertyType": {
                "type": "string",
                "nullable": true,
                "description": "Property type (e.g. SINGLE_FAMILY)"
              },
              "yearBuilt": {
                "type": "integer",
                "nullable": true,
                "description": "Year the property was built"
              },
              "latitude": {
                "type": "number",
                "nullable": true,
                "description": "Latitude"
              },
              "longitude": {
                "type": "number",
                "nullable": true,
                "description": "Longitude"
              },
              "daysOnZillow": {
                "type": "integer",
                "nullable": true,
                "description": "Days on Zillow"
              },
              "statusText": {
                "type": "string",
                "nullable": true,
                "description": "Zillow status label (e.g. Foreclosure, Pre-foreclosure, Auction)"
              },
              "isForeclosure": {
                "type": "boolean",
                "nullable": true,
                "description": "Flagged as an active foreclosure-listed property"
              },
              "isBankOwned": {
                "type": "boolean",
                "nullable": true,
                "description": "Flagged as bank-owned (REO)"
              },
              "isPreForeclosure": {
                "type": "boolean",
                "nullable": true,
                "description": "Flagged as pre-foreclosure"
              },
              "isAuction": {
                "type": "boolean",
                "nullable": true,
                "description": "Flagged as a foreclosure auction"
              },
              "isComingSoon": {
                "type": "boolean",
                "nullable": true,
                "description": "Flagged as coming soon"
              },
              "listingAgentName": {
                "type": "string",
                "nullable": true,
                "description": "Listing agent name"
              },
              "listingAgentPhone": {
                "type": "string",
                "nullable": true,
                "description": "Listing agent phone number"
              },
              "brokerName": {
                "type": "string",
                "nullable": true,
                "description": "Listing brokerage"
              },
              "mlsName": {
                "type": "string",
                "nullable": true,
                "description": "MLS name"
              },
              "mlsId": {
                "type": "string",
                "nullable": true,
                "description": "MLS listing ID"
              },
              "photos": {
                "type": "array",
                "nullable": true,
                "description": "Property photo URLs (Zillow photo CDN only)"
              },
              "photoCount": {
                "type": "integer",
                "nullable": true,
                "description": "Number of photos available"
              },
              "description": {
                "type": "string",
                "nullable": true,
                "description": "Listing description"
              },
              "listedDate": {
                "type": "string",
                "nullable": true,
                "description": "Date the listing was posted (ISO 8601)"
              },
              "monthlyHoaFee": {
                "type": "number",
                "nullable": true,
                "description": "Monthly HOA fee ($)"
              },
              "pricePerSquareFoot": {
                "type": "number",
                "nullable": true,
                "description": "Price per square foot ($)"
              },
              "postingUrl": {
                "type": "string",
                "nullable": true,
                "description": "External listing/auction page when Zillow provides one (e.g. auction.com)"
              },
              "lastSoldPrice": {
                "type": "number",
                "nullable": true,
                "description": "Most recent recorded sale price ($)"
              },
              "lastSoldDate": {
                "type": "string",
                "nullable": true,
                "description": "Most recent recorded sale date (YYYY-MM-DD)"
              },
              "comingSoonDate": {
                "type": "string",
                "nullable": true,
                "description": "Date a coming-soon listing goes live (ISO 8601)"
              },
              "scrapedAt": {
                "type": "string",
                "description": "ISO 8601 scrape timestamp"
              },
              "auctionDate": {
                "type": "string",
                "nullable": true,
                "description": "Foreclosure auction date (YYYY-MM-DD), from the linked auctioneer page"
              },
              "auctionDateTime": {
                "type": "string",
                "nullable": true,
                "description": "Auction sale start date-time (ISO 8601)"
              },
              "startingBid": {
                "type": "number",
                "nullable": true,
                "description": "Published starting bid ($)"
              },
              "principalLoanAmount": {
                "type": "number",
                "nullable": true,
                "description": "Original loan principal ($) when the auctioneer publishes it"
              },
              "occupancyStatus": {
                "type": "string",
                "nullable": true,
                "description": "Occupancy status reported by the auctioneer (e.g. OCCUPIED, VACANT)"
              },
              "lender": {
                "type": "string",
                "nullable": true,
                "description": "Beneficiary (lender) name from the auctioneer's party list"
              },
              "servicer": {
                "type": "string",
                "nullable": true,
                "description": "Loan servicer name from the auctioneer's party list"
              },
              "foreclosureAttorney": {
                "type": "string",
                "nullable": true,
                "description": "Foreclosure attorney / trustee firm handling the sale"
              },
              "foreclosureAttorneyPhone": {
                "type": "string",
                "nullable": true,
                "description": "Foreclosure attorney / trustee phone"
              },
              "buyerPremiumAvailable": {
                "type": "boolean",
                "nullable": true,
                "description": "Whether the auction charges a buyer's premium"
              },
              "auctionEventTitle": {
                "type": "string",
                "nullable": true,
                "description": "Auctioneer event title (sale event name)"
              }
            }
          },
          "views": {
            "overview": {
              "title": "Foreclosure Listings Overview",
              "transformation": {
                "fields": [
                  "url",
                  "distressType",
                  "address",
                  "city",
                  "state",
                  "price",
                  "beds",
                  "baths",
                  "taxAssessedValue",
                  "scrapedAt"
                ]
              },
              "display": {
                "component": "table",
                "properties": {
                  "url": {
                    "label": "URL",
                    "format": "link"
                  },
                  "distressType": {
                    "label": "Type",
                    "format": "text"
                  },
                  "address": {
                    "label": "Address",
                    "format": "text"
                  },
                  "city": {
                    "label": "City",
                    "format": "text"
                  },
                  "state": {
                    "label": "State",
                    "format": "text"
                  },
                  "price": {
                    "label": "Price $",
                    "format": "number"
                  },
                  "beds": {
                    "label": "Beds",
                    "format": "number"
                  },
                  "baths": {
                    "label": "Baths",
                    "format": "number"
                  },
                  "scrapedAt": {
                    "label": "Scraped At",
                    "format": "text"
                  }
                }
              }
            }
          }
        }
      },
      "readme": "# Zillow Distressed Property Finder by City or ZIP\n\nZillow keeps its foreclosure, pre-foreclosure, pre-market REO and auction inventory inside its regular map search. This actor applies those distress filters server-side for you and returns structured records for any US city, ZIP code, neighborhood or county, with optional per-listing detail enrichment: listing agent, phone, brokerage, photos, description, year built, HOA and per-row distress flags.\n\n## What this actor does\n\n- Searches one or more locations: city (\"Austin, TX\"), ZIP (\"78701\"), neighborhood (\"Hyde Park, Austin, TX\") or county (\"Travis County, TX\").\n- Also accepts Zillow search URLs you already have; the distress filter is layered on top of the URL's own filters.\n- Restricts results to the distress categories you pick: foreclosures (including bank-owned), pre-foreclosures, pre-market foreclosed (REO) and auctions.\n- Applies Zillow's own filters server-side: price range, minimum beds/baths, home types, days on Zillow and sort order.\n- Pages through Zillow's result pages up to its own limit, with no browser and no cookies required.\n- Optionally opens each listing's detail page for the listing agent, photos, description, year built, HOA and authoritative distress flags.\n- Fields Zillow doesn't publish for a listing (no price, no Zestimate, no photos) are left out of that record rather than filled with a placeholder.\n\n## Output per listing\n\n| Field | Description |\n|---|---|\n| `zpid` | Zillow property ID. |\n| `url` | Zillow property detail page URL. |\n| `distressType` | `foreclosure`, `bankOwned`, `preForeclosure`, `preMarketForeclosure`, `auction` or `comingSoon`. |\n| `isForeclosure` / `isBankOwned` / `isPreForeclosure` / `isAuction` / `isComingSoon` | Per-listing distress flags as Zillow marks them. |\n| `homeStatus` / `statusText` | Raw Zillow status and its display label. |\n| `address` / `city` / `state` / `zipCode` | Property address components. |\n| `price` | Listing price, in USD. |\n| `zestimate` / `rentZestimate` | Zillow's value and rent estimates, in USD. |\n| `taxAssessedValue` | Tax-assessed value, in USD. |\n| `beds` / `baths` / `sqft` | Bedroom and bathroom counts, and living area in square feet. |\n| `lotAreaValue` / `lotAreaUnit` | Lot size and its unit (`sqft` or `acres`). |\n| `propertyType` / `yearBuilt` | Property type (e.g. `SINGLE_FAMILY`) and construction year. |\n| `latitude` / `longitude` | Property coordinates. |\n| `daysOnZillow` / `listedDate` | Days on Zillow and the date the listing was posted. |\n| `listingAgentName` / `listingAgentPhone` / `brokerName` / `mlsName` / `mlsId` | Listing attribution from the detail page. |\n| `photos` / `photoCount` | Property photo URLs (largest size, Zillow photo CDN only) and how many photos Zillow shows. |\n| `description` | Listing description text. |\n| `monthlyHoaFee` / `pricePerSquareFoot` | HOA fee and price per square foot when shown. |\n| `postingUrl` | External listing or auction page when Zillow provides one (e.g. an auction.com detail link). |\n| `auctionDate` / `auctionDateTime` | Auction date and sale start date-time, read from the linked auctioneer page. |\n| `startingBid` / `principalLoanAmount` | Published starting bid and original loan principal when the auctioneer shows them. |\n| `occupancyStatus` | Occupancy reported by the auctioneer (e.g. `OCCUPIED`, `VACANT`). |\n| `lender` / `servicer` | Beneficiary (lender) and loan servicer names. |\n| `foreclosureAttorney` / `foreclosureAttorneyPhone` | Foreclosure attorney / trustee firm and its phone. |\n| `buyerPremiumAvailable` | Whether the auction charges a buyer's premium. |\n| `auctionEventTitle` | The auctioneer's sale event title. |\n| `lastSoldPrice` / `lastSoldDate` | Most recent recorded sale price and date, when Zillow publishes them. |\n| `comingSoonDate` | The date a coming-soon listing is scheduled to go live. |\n| `scrapedAt` | ISO 8601 timestamp of when this actor fetched the record. |\n\n## Input\n\n| Field | Type | Default | Description |\n|---|---|---|---|\n| `locations` | Array of strings | – | Cities, ZIP codes, neighborhoods or counties — one entry each. |\n| `startUrls` | Array of URLs | – | Zillow search pages; the distress filter is applied on top. |\n| `distressTypes` | Array (select) | all four | `foreclosure`, `preForeclosure`, `preMarketForeclosure`, `auction`; legacy `bankOwned` (REO-only) is also accepted. Leave empty for all. |\n| `priceMin` / `priceMax` | Integer | – | Listing price bounds in USD. |\n| `bedsMin` / `bathsMin` | Number | – | Minimum bedrooms / bathrooms. |\n| `homeTypes` | Array (select) | all | `singleFamily`, `condo`, `townhouse`, `multiFamily`, `apartment`, `manufactured`, `lotLand`. |\n| `daysOnZillow` | Select | `any` | Only listings seen within the window (1 day … 36 months). |\n| `sortBy` | Select | `relevance` | Relevance, newest, price, beds, baths, size, lot or Zestimate. |\n| `includeDetails` | Boolean | `true` | Open each listing's detail page for agent, photos, description and year built. |\n| `includeAuctionDetails` | Boolean | `false` | Read the linked auctioneer page (auction.com only) for the auction schedule, starting bid, occupancy and lender/attorney fields. One extra request per linked auction; requires `includeDetails`. |\n| `maxItems` | Integer | `100` | Maximum listings across all locations and URLs (1–5000). |\n\nProvide at least one `locations` entry or one `startUrls` entry.\n\n### Example: foreclosures and auctions in one city\n\n```json\n{\n    \"locations\": [\"Phoenix, AZ\"],\n    \"distressTypes\": [\"foreclosure\", \"auction\"],\n    \"priceMax\": 400000,\n    \"includeDetails\": true,\n    \"maxItems\": 100\n}\n```\n\n### Example: bank-owned homes by ZIP code\n\n```json\n{\n    \"locations\": [\"85001\", \"85032\"],\n    \"distressTypes\": [\"preMarketForeclosure\"],\n    \"includeDetails\": true,\n    \"maxItems\": 200\n}\n```\n\n### Example: reuse a saved Zillow search URL\n\n```json\n{\n    \"startUrls\": [{\"url\": \"https://www.zillow.com/austin-tx/foreclosures/\"}],\n    \"maxItems\": 300\n}\n```\n\n## Use cases\n\n- **Distressed-inventory investing** — track foreclosure and pre-foreclosure properties before they hit the broader market.\n- **Wholesaling** — build a pre-foreclosure outreach list for a ZIP or neighborhood.\n- **Auction prep** — research properties scheduled for a foreclosure auction ahead of time.\n- **REO acquisition** — surface pre-market bank-owned properties for buy-and-hold portfolios.\n- **Market intelligence** — quantify distress rates by city, ZIP or county over time.\n\n## FAQ\n\n**What's the difference between the distress types?**\n`foreclosure` is an active foreclosure listing for sale (Zillow's foreclosure filter also includes bank-owned homes); `bankOwned` marks a home the lender already owns (REO); `preForeclosure` is a pre-market record early in the foreclosure process, not yet listed; `preMarketForeclosure` is a pre-market record the bank has already taken back; `auction` is a property scheduled for a foreclosure auction.\n\n**How many results can I get per run?**\nUp to 5,000 via `maxItems`. Zillow itself caps any single search at 20 result pages (about 820 listings). If a market hits that cap, split it into several `locations` — by home type, ZIP or neighborhood — and pass them together; the slices are disjoint, so their union covers the full inventory (verified: Los Angeles distressed inventory = 1,349 listings; its seven home-type slices sum to exactly 1,349).\n\n**Do I need proxies or cookies?**\nNo. The actor routes its requests automatically and needs no account, cookie or API key from you.\n\n**Why do some listings have no price or Zestimate?**\nZillow genuinely doesn't show a price or estimate for many pre-market distressed records. Those fields are omitted from the record instead of being filled with a placeholder.\n\n**Does this include auction dates, unpaid balances or lender details?**\nZillow's own pages don't carry them, but auction listings link out to the auctioneer (`postingUrl`). Turn on `includeAuctionDetails` and the actor also reads the linked auction.com page, adding the auction date and sale time, occupancy, starting bid, loan principal, lender, servicer and foreclosure attorney (each when the auctioneer publishes it). Roughly two thirds of sampled Zillow auctions link to auction.com; other auctioneers and unpaid balances are not covered.\n\n**Is this affiliated with Zillow?**\nNo. This actor is an independent tool that reads publicly visible Zillow search results and is not affiliated with or endorsed by Zillow.\n"
    },
    "buildNumber": "1.0.2",
    "imageDigest": "2f29288ecd12d7521100636b86a6824d71301bf621dde06f7e7741fd3171370f",
    "actVersion": {
      "sourceType": "SOURCE_FILES",
      "buildTag": "latest",
      "versionNumber": "1.0"
    },
    "usage": {
      "ACTOR_COMPUTE_UNITS": 0.019383333333333332
    }
  }
}