{ "openapi": "3.0.1", "info": { "title": "US Distressed Property Leads", "description": "Distressed property leads across major US markets: tax liens, pre-foreclosures, code violations, and vacant/abandoned buildings from official city and county open data. Owner names, addresses, and amounts owed where published. For real estate investors and wholesalers.", "version": "1.0", "x-build-id": "NItyvaAsYTVv6Abxd" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/great_pistachio~us-distressed-property-leads/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-great_pistachio-us-distressed-property-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/great_pistachio~us-distressed-property-leads/runs": { "post": { "operationId": "runs-sync-great_pistachio-us-distressed-property-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/great_pistachio~us-distressed-property-leads/run-sync": { "post": { "operationId": "run-sync-great_pistachio-us-distressed-property-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": [ "filedSince" ], "properties": { "sources": { "title": "Sources", "uniqueItems": true, "type": "array", "description": "Which markets/lists to pull. Leave empty for all.", "items": { "type": "string", "enum": [ "nyc-tax-liens", "la-foreclosures", "detroit-blight", "miami-dade-code-violations", "miami-dade-code-liens", "chicago-violations", "chicago-vacant" ], "enumTitles": [ "New York City — Tax Lien Sale List", "Los Angeles — Registered Foreclosures (with lender)", "Detroit — Blight Tickets (owner + balance due)", "Miami-Dade — Open Code Violations", "Miami-Dade — Code Violation Liens", "Chicago — Building Code Violations", "Chicago — Vacant & Abandoned Buildings" ] }, "default": [] }, "signalTypes": { "title": "Signal Types", "uniqueItems": true, "type": "array", "description": "Optionally narrow to specific distress signals. Leave empty for all.", "items": { "type": "string", "enum": [ "tax_lien", "pre_foreclosure", "code_violation", "code_lien", "vacant" ], "enumTitles": [ "Tax Lien", "Pre-Foreclosure", "Code Violation", "Code Violation Lien", "Vacant / Abandoned" ] }, "default": [] }, "filedSince": { "title": "Filed Since", "enum": [ "last7days", "last30days", "last90days", "last365days", "all" ], "type": "string", "description": "Only include leads dated within this window. Distress lists move slower than new filings, and some (NYC tax liens, Chicago vacant) are published in periodic cycles, so 365 days is the default to catch every source.", "default": "last365days" }, "zipPrefix": { "title": "ZIP Filter", "type": "string", "description": "Only include properties whose ZIP starts with this prefix (e.g. '112' for parts of Brooklyn). Leave empty for all.", "default": "" }, "maxResultsPerSource": { "title": "Max Results per Source", "minimum": 0, "type": "integer", "description": "Cap leads per source. 0 = unlimited.", "default": 50 }, "maxResults": { "title": "Max Results Total", "minimum": 0, "type": "integer", "description": "Cap total leads across all sources. 0 = unlimited.", "default": 0 } } }, "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 } } } } } } } } } }