{ "openapi": "3.0.1", "info": { "title": "Foreclosure & Auction Finder โ€” Deals + Zillow Valuation", "description": "Scrape US foreclosure, REO and bank-owned auction listings and fuse each one with instant home valuation, rent estimate, comparable sales and neighborhood, school and demographic data. Filter by location, ZIP, coordinates or URL and pull the live auction calendar. Export to JSON, CSV or Excel.", "version": "1.0", "x-build-id": "mWUvvtUZzx3lnanKc" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/sian.agency~distressed-deal-finder/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-sian.agency-distressed-deal-finder", "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/sian.agency~distressed-deal-finder/runs": { "post": { "operationId": "runs-sync-sian.agency-distressed-deal-finder", "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/sian.agency~distressed-deal-finder/run-sync": { "post": { "operationId": "run-sync-sian.agency-distressed-deal-finder", "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": { "operation": { "title": "Operation", "enum": [ "search", "calendar", "calendarEvent" ], "type": "string", "description": "What to pull. ๐Ÿš search = distressed inventory (fused with valuation + neighborhood). ๐Ÿ—“ calendar = the live auction calendar. ๐ŸŽฏ calendarEvent = one auction event and its properties.", "default": "search" }, "searchMode": { "title": "Search mode", "enum": [ "location", "zip", "coordinates", "url" ], "type": "string", "description": "How to find distressed inventory (used when operation = search). ๐Ÿ“ location = city/area text ยท ๐Ÿ“ฎ zip = 5-digit ZIP ยท ๐Ÿ—บ coordinates = lat/lng (+ radius) ยท ๐Ÿ”— url = an auction browse URL.", "default": "location" }, "location": { "title": "Location", "type": "string", "description": "๐Ÿ“ City / area text, e.g. \"Dallas, TX\". Leave empty for a nationwide search." }, "zipCode": { "title": "ZIP code", "type": "string", "description": "๐Ÿ“ฎ 5-digit US ZIP (used when searchMode = zip), e.g. 75217." }, "latitude": { "title": "Latitude", "type": "string", "description": "๐Ÿ—บ Latitude (used when searchMode = coordinates), e.g. 32.7451." }, "longitude": { "title": "Longitude", "type": "string", "description": "๐Ÿ—บ Longitude (used when searchMode = coordinates), e.g. -96.6496." }, "radius": { "title": "Radius (miles)", "type": "string", "description": "๐Ÿ—บ Search radius in miles around the coordinates (optional)." }, "url": { "title": "Auction URL", "type": "string", "description": "๐Ÿ”— An auction browse or property URL (used when searchMode = url)." }, "sort": { "title": "Sort", "enum": [ "auction_date", "newest", "oldest", "price_low", "price_high", "distance" ], "type": "string", "description": "Sort order for search results.", "default": "auction_date" }, "availability": { "title": "Availability", "enum": [ "active", "removed" ], "type": "string", "description": "Filter listings by availability.", "default": "active" }, "state": { "title": "State (calendar)", "type": "string", "description": "๐Ÿ—“ 2-letter US state code for the auction calendar, e.g. TX." }, "assetType": { "title": "Asset type (calendar)", "enum": [ "foreclosure", "bank-owned" ], "type": "string", "description": "๐Ÿ—“ Distressed asset type for the calendar.", "default": "foreclosure" }, "dateFrom": { "title": "Date from (calendar)", "type": "string", "description": "๐Ÿ—“ Earliest auction date (YYYY-MM-DD) for the calendar." }, "dateTo": { "title": "Date to (calendar)", "type": "string", "description": "๐Ÿ—“ Latest auction date (YYYY-MM-DD) for the calendar." }, "eventId": { "title": "Event ID (single event)", "type": "string", "description": "๐ŸŽฏ Event code (e.g. E-31553A) or numeric venue id (used when operation = calendarEvent)." }, "enrichValuation": { "title": "Enrich with home valuation", "type": "boolean", "description": "๐Ÿ’ฐ Add instant home value, rent estimate and comparable sales to each distressed listing. Paid tier only.", "default": true }, "enrichNeighborhood": { "title": "Enrich with neighborhood data", "type": "boolean", "description": "๐Ÿ˜ Add school ratings, demographics and local amenities to each distressed listing. Paid tier only.", "default": true }, "maxResults": { "title": "Max results", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Maximum rows per run. FREE runs are capped at 25.", "default": 50 } } }, "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 } } } } } } } } } }