{ "openapi": "3.0.1", "info": { "title": "Distressed Property Leads - NYC, Detroit, Philly & Chicago", "description": "Motivated-seller leads for New York City, Detroit, Philadelphia and Chicago. Stacks open code violations, blight tickets, tax liens, evictions, vacant-building complaints and scofflaw listings per property, scores distress, and attaches the owner name and mailing address. Keyless government data.", "version": "1.3", "x-build-id": "XnPum9icMnaFJxHCD" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/malonestar~distressed-property-signal-stacker/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-malonestar-distressed-property-signal-stacker", "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/malonestar~distressed-property-signal-stacker/runs": { "post": { "operationId": "runs-sync-malonestar-distressed-property-signal-stacker", "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/malonestar~distressed-property-signal-stacker/run-sync": { "post": { "operationId": "run-sync-malonestar-distressed-property-signal-stacker", "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": { "metros": { "title": "Metros to scan", "uniqueItems": true, "type": "array", "description": "Which metro lead pipelines to run. Defaults to New York City only, which is exactly what this actor did before multi-metro support, so saved tasks and API callers that omit this field are unaffected. Detroit and Philadelphia publish the owner name and mailing address on the violation record itself. Chicago publishes neither and is matched to the Cook County assessor roll on an exact address, so its owner-match rate is lower and is reported on every row. Add metros one at a time: each one is a separate full-city scan and you are billed per result.", "items": { "type": "string", "enum": [ "nyc", "detroit", "philadelphia", "chicago" ], "enumTitles": [ "New York City (violations + tax liens + evictions)", "Detroit (blight tickets + vacant registrations + assessor)", "Philadelphia (L&I violations + OPA assessor)", "Chicago (violations + 311 vacant + scofflaw + Cook assessor)" ] }, "default": [ "nyc" ] }, "borough": { "title": "Borough", "enum": [ "MANHATTAN", "BRONX", "BROOKLYN", "QUEENS", "STATEN ISLAND" ], "type": "string", "description": "NYC borough to scan. Accepts a name (MANHATTAN, BRONX, BROOKLYN, QUEENS, STATEN ISLAND) or a borough code 1-5. One borough per run keeps runs fast and cheap. Applies only when \"nyc\" is one of the selected metros; it is ignored by Detroit, Philadelphia and Chicago, which are scanned city-wide.", "default": "BRONX" }, "minSignals": { "title": "Minimum distinct signals", "minimum": 1, "maximum": 3, "type": "integer", "description": "Only emit parcels showing at least this many DIFFERENT distress signal types (open violations, tax-lien-sale notice, executed evictions). 2 = solid motivated-seller leads; 3 = only the most distressed parcels; 1 = everything with any signal.", "default": 2 }, "lookbackMonths": { "title": "Lookback window (months)", "minimum": 1, "maximum": 60, "type": "integer", "description": "How many months of history to count, anchored to each dataset's own most-recent record date (not today) so a lagging source like the lien-sale list still yields its latest cycle. Applies to violation issue dates, lien-sale list months, and eviction execution dates.", "default": 12 }, "maxResults": { "title": "Max results", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Maximum number of ranked parcel leads to emit (highest distress score first). You are billed per result, so this caps your spend.", "default": 100 } } }, "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 } } } } } } } } } }