{ "openapi": "3.0.1", "info": { "title": "Zillow Motivated Seller Leads & Real ZIP Sales Comps", "description": "US homes for sale whose owners look ready to deal, each priced against what homes in its ZIP code actually sold for (Redfin Data Center). Price cuts with amount and date, days on market vs the ZIP, under assessed value, by owner, pre-foreclosure. A 0-100 motivation score with its reasons.", "version": "1.0", "x-build-id": "trzM3CNGpTxbZuG7i" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/wellbuilt_zythem~zillow-motivated-sellers/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-wellbuilt_zythem-zillow-motivated-sellers", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/wellbuilt_zythem~zillow-motivated-sellers/runs": { "post": { "operationId": "runs-sync-wellbuilt_zythem-zillow-motivated-sellers", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/wellbuilt_zythem~zillow-motivated-sellers/run-sync": { "post": { "operationId": "run-sync-wellbuilt_zythem-zillow-motivated-sellers", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "locations": { "title": "Locations", "type": "array", "description": "Cities, neighbourhoods or ZIP codes. Write them as you would on Zillow: \"Austin, TX\", \"Cleveland, OH\", \"78702\".", "default": [ "Austin, TX" ], "items": { "type": "string" } }, "minMotivationScore": { "title": "Minimum motivation score (0-100)", "minimum": 0, "maximum": 100, "type": "integer", "description": "The one filter that matters. 40 keeps leads with a real signal; 60 keeps only the strong ones. 0 returns everything.", "default": 40 }, "onlyPriceCuts": { "title": "Only homes that cut their price", "type": "boolean", "description": "A published price cut is the clearest public admission that the first price failed.", "default": false }, "minDaysOnMarket": { "title": "Minimum days on market", "minimum": 0, "type": "integer", "description": "60 or more usually means the listing is stale and the seller knows it.", "default": 0 }, "onlyForSaleByOwner": { "title": "Only for sale by owner", "type": "boolean", "description": "No agent in the middle.", "default": false }, "onlyNonOwnerOccupied": { "title": "Only absentee owners", "type": "boolean", "description": "Zillow sets this on nearly every listing, so it is a weak filter and scores nothing. Kept because some buyers still want it.", "default": false }, "maxPricePerSqftVsZipPct": { "title": "Only homes priced under their ZIP's real sales (%)", "minimum": -90, "maximum": 100, "type": "integer", "description": "Keep homes whose asking price per square foot is at least this far from what homes in the same ZIP code actually sold for (Redfin Data Center, last 90 days). -15 keeps homes asking 15% or more under their ZIP. Empty for no filter. Homes in ZIPs with fewer than 5 sales have no comparison and are dropped by this filter." }, "minPrice": { "title": "Minimum price (USD)", "minimum": 0, "type": "integer", "description": "Skip anything cheaper. 0 for no minimum.", "default": 0 }, "maxPrice": { "title": "Maximum price (USD)", "minimum": 0, "type": "integer", "description": "Skip anything dearer. 0 for no maximum.", "default": 0 }, "homeTypes": { "title": "Home types", "type": "array", "description": "Leave empty for all.", "items": { "type": "string", "enum": [ "SINGLE_FAMILY", "CONDO", "TOWNHOUSE", "MULTI_FAMILY", "MANUFACTURED", "LOT" ], "enumTitles": [ "Single family", "Condo", "Townhouse", "Multi family", "Manufactured", "Land" ] }, "default": [] }, "listingStatus": { "title": "Listing status", "enum": [ "sale", "sold", "rent" ], "type": "string", "description": "For sale is the default. Recently sold is for comparables; for rent is for rental analysis.", "default": "sale" }, "pagesPerLocation": { "title": "Pages per location", "minimum": 1, "maximum": 20, "type": "integer", "description": "About 41 homes per page. Zillow stops paginating past 20.", "default": 3 }, "withPermits": { "title": "Building permit history of the home ($)", "type": "boolean", "description": "For homes in Austin, Chicago, Seattle, Orlando, New Orleans, Baton Rouge, Cincinnati, Mesa, Everett, Somerville, New York and Marin County: the building permits at that address in the last 5 years, from the city's official register. A price cut with no permit in 5 years is flagged deferredMaintenance (+10 motivation); a renovation permit in the last 24 months is flagged renovatedRecently. Charged per listing checked, as the permit_check event; homes outside the 12 cities are marked permitCoverage: false and cost nothing.", "default": false }, "socrataAppToken": { "title": "Socrata app token (optional)", "type": "string", "description": "Free token from any Socrata portal; gives the permit lookups their own rate limit." }, "maxResults": { "title": "Maximum results", "minimum": 0, "type": "integer", "description": "0 for no limit.", "default": 0 }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Zillow refuses about half of all requests and nearly all from datacenter IPs. A US residential exit is required, and each retry leaves from a different one.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "US" } } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }