{ "openapi": "3.0.1", "info": { "title": "Auction Property Leads - Sheriff Sales, Trustee Sales, Online", "description": "Bulk Zillow auction property listings: sheriff sales, trustee sales, online foreclosure auctions. Filter by city/state, price, beds/baths/sqft. Auto-computes flip score, ARV estimate, rehab cost, MAO (70% rule). Built for cash buyers, wholesalers, flippers hunting auction inventory.", "version": "0.1", "x-build-id": "TJAfteJTYmWJ7OD8U" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/seibs.co~property-auction-leads/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-seibs.co-property-auction-leads", "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/seibs.co~property-auction-leads/runs": { "post": { "operationId": "runs-sync-seibs.co-property-auction-leads", "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/seibs.co~property-auction-leads/run-sync": { "post": { "operationId": "run-sync-seibs.co-property-auction-leads", "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", "required": [ "locations" ], "properties": { "locations": { "title": "Locations", "maxItems": 25, "type": "array", "description": "US locations to search. Format: 'City, ST'. Example: ['Austin, TX', 'Dallas, TX', 'Phoenix, AZ']. Max 25 locations per run.", "default": [ "Austin, TX" ], "items": { "type": "string" } }, "only_auctions": { "title": "Restrict to auction listings only", "type": "boolean", "description": "Restrict to auction-status listings only (recommended for this actor).", "default": true }, "only_foreclosures": { "title": "Restrict to foreclosure listings only", "type": "boolean", "description": "Restrict to pre-foreclosure / foreclosure listings only. Leave off for this actor unless you want auction + foreclosure intersect.", "default": false }, "include_foreclosures": { "title": "Include foreclosures in results", "type": "boolean", "description": "Allow pre-foreclosure and foreclosure inventory to appear alongside auctions in the result set.", "default": true }, "min_price": { "title": "Min price (USD)", "minimum": 0, "type": "integer", "description": "Minimum list price filter. Leave empty for no lower bound." }, "max_price": { "title": "Max price (USD)", "minimum": 0, "type": "integer", "description": "Maximum list price filter. Leave empty for no upper bound." }, "min_beds": { "title": "Min beds", "minimum": 0, "type": "integer", "description": "Minimum bedroom count." }, "max_beds": { "title": "Max beds", "minimum": 0, "type": "integer", "description": "Maximum bedroom count." }, "min_baths": { "title": "Min baths", "minimum": 0, "type": "integer", "description": "Minimum bathroom count (fractional baths allowed via runner)." }, "min_sqft": { "title": "Min sqft", "minimum": 0, "type": "integer", "description": "Minimum living-area square footage." }, "max_sqft": { "title": "Max sqft", "minimum": 0, "type": "integer", "description": "Maximum living-area square footage." }, "min_year_built": { "title": "Min year built", "minimum": 1700, "maximum": 2100, "type": "integer", "description": "Earliest construction year." }, "max_year_built": { "title": "Max year built", "minimum": 1700, "maximum": 2100, "type": "integer", "description": "Latest construction year." }, "home_types": { "title": "Home types", "uniqueItems": true, "type": "array", "description": "Zillow home-type filter. SingleFamily is the most common auction inventory.", "items": { "type": "string", "enum": [ "SingleFamily", "Condo", "Townhouse", "MultiFamily", "Manufactured", "LotsLand" ] }, "default": [ "SingleFamily" ] }, "days_on_zillow_min": { "title": "Days on Zillow (min)", "minimum": 0, "maximum": 1000, "type": "integer", "description": "Only return listings that have been on Zillow at least this many days. Common buckets: 30 (moderate aging), 60 (motivated seller territory), 90 (very motivated), 180+ (stale, often distressed). Leave blank to skip." }, "has_price_drop": { "title": "Has price drop", "type": "boolean", "description": "Only include listings that have had at least one price reduction.", "default": false }, "min_flip_score": { "title": "Min flip score (0.0-1.0)", "type": "string", "description": "Drop records whose computed flip score is below this threshold. 0.6+ = high-confidence flip candidate. Leave blank to emit everything. Enter as a decimal between 0.0 and 1.0 (e.g. 0.5).", "default": "" }, "enrich_details": { "title": "Enrich listing detail pages", "type": "boolean", "description": "Fetch each listing's detail page to populate description, price history, photos, nearby comps, schools, HOA, and tax data. Required for accurate flip score and ARV.", "default": true }, "enrich_concurrency": { "title": "Enrichment concurrency", "minimum": 1, "maximum": 16, "type": "integer", "description": "Parallel detail-page fetches. 4 is the safe default; raise cautiously. 16 is the hard ceiling.", "default": 4 }, "use_apify_proxy": { "title": "Use Apify Proxy", "type": "boolean", "description": "Route Zillow requests through Apify Proxy. Strongly recommended; running without proxy will hit blocks quickly.", "default": true }, "apify_proxy_groups": { "title": "Apify Proxy groups", "type": "array", "description": "Proxy groups to use. RESIDENTIAL is the most reliable against Zillow.", "default": [ "RESIDENTIAL" ], "items": { "type": "string" } }, "apify_proxy_country": { "title": "Apify Proxy country code", "type": "string", "description": "Two-letter country code for residential proxy (e.g. 'US'). Leave blank for any.", "default": "US" }, "max_results_per_location": { "title": "Max results per location", "minimum": 1, "maximum": 100, "type": "integer", "description": "Cap on records emitted per location. Hard ceiling 100 to keep compute cost predictable.", "default": 100 }, "max_pages_per_location": { "title": "Max search pages per location", "minimum": 1, "maximum": 20, "type": "integer", "description": "Cap on Zillow search-result pages crawled per location. Hard ceiling 20.", "default": 5 }, "preset_filter": { "title": "Preset filter (optional)", "enum": [ "", "conservative_flipper", "aggressive_flipper", "brrrr_investor", "wholesaler" ], "type": "string", "description": "Apply a flipper-strategy preset. User-supplied fields below override the preset.", "default": "" }, "min_lot_sqft": { "title": "Min lot size (sqft)", "minimum": 0, "type": "integer", "description": "Lot area floor in sqft. 43560 = 1 acre. Useful for finding subdivide/ADU opportunities." }, "max_lot_sqft": { "title": "Max lot size (sqft)", "minimum": 0, "type": "integer", "description": "Lot area ceiling in sqft. Leave blank for no ceiling." }, "max_hoa_fee": { "title": "Max HOA fee per month ($)", "minimum": 0, "type": "integer", "description": "Drop listings with monthly HOA above this. High HOAs kill flip math (eat into holding cost). 100 is a strict filter; 300 is moderate." }, "min_school_rating": { "title": "Min school rating (1-10)", "minimum": 1, "maximum": 10, "type": "integer", "description": "Drop listings whose best nearby school rates below this (impacts ARV directly). Requires enrich_details=true." }, "sort_order": { "title": "Sort order", "enum": [ "best_deals", "newest", "lowest_price", "biggest_discount", "largest_sqft", "oldest_built" ], "type": "string", "description": "How Zillow returns results. 'best_deals' is the default global relevance ranking; 'biggest_discount' surfaces price-drop listings first.", "default": "best_deals" }, "must_include_keywords": { "title": "Required keywords (must all appear in description)", "type": "array", "description": "Server-side filter: only emit listings whose description contains ALL of these case-insensitive substrings. Example: ['as-is', 'cash'].", "default": [], "items": { "type": "string" } }, "must_exclude_keywords": { "title": "Excluded keywords (drop if any appear)", "type": "array", "description": "Drop any listing whose description contains ANY of these case-insensitive substrings. Example: ['turnkey', 'renovated', 'new construction'].", "default": [], "items": { "type": "string" } }, "only_absentee_owners": { "title": "Only absentee owners", "type": "boolean", "description": "Drop listings where the owner's mailing address matches the property address. Absentee owners (landlords, out-of-state heirs) are typically more flexible on price. Requires enrich_details=true.", "default": false }, "estimated_rehab_months": { "title": "Estimated rehab months (for holding cost)", "minimum": 1, "maximum": 18, "type": "integer", "description": "How long you expect rehab + listing + closing to take. Used to estimate total holding cost (mortgage interest + tax + utilities + HOA) during the project.", "default": 4 } } }, "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 } } }, "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 } } } } } } } } } }