{ "openapi": "3.0.1", "info": { "title": "Distressed Property Leads — Tax, Vacancy & Code Violations", "description": "Finds distressed real estate in official city and county open-data portals: tax-delinquent and tax-sale rolls, vacant and condemned building registries, demolitions, and open code violations. Merges every signal onto the same property and scores it, so you call the most motivated owners first.", "version": "0.1", "x-build-id": "EaxffoYesjeUKVhrh" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/omegapointsolutions~distressed-property-leads/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-omegapointsolutions-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/omegapointsolutions~distressed-property-leads/runs": { "post": { "operationId": "runs-sync-omegapointsolutions-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/omegapointsolutions~distressed-property-leads/run-sync": { "post": { "operationId": "run-sync-omegapointsolutions-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", "properties": { "states": { "title": "States", "uniqueItems": true, "type": "array", "description": "Two-letter state codes to include, e.g. IL, OH. Leave empty to query every jurisdiction in the registry.", "items": { "type": "string" } }, "jurisdictions": { "title": "Jurisdictions", "uniqueItems": true, "type": "array", "description": "City or county names to include, e.g. Chicago, Cook County. Leave empty for all jurisdictions in the selected states.", "items": { "type": "string" } }, "signalTypes": { "title": "Distress signal types", "uniqueItems": true, "type": "array", "description": "Which kinds of distress to collect. Leave empty for all of them.", "items": { "type": "string", "enum": [ "tax_sale", "tax_delinquent", "condemned", "demolition", "vacant", "code_violation" ], "enumTitles": [ "Tax sale", "Tax delinquent", "Condemned / dangerous", "Demolition", "Vacant / abandoned", "Code violation" ] } }, "maxRecordsPerSource": { "title": "Max records per dataset", "minimum": 1, "maximum": 50000, "type": "integer", "description": "How many rows to read from each dataset before moving on. Higher values find more properties and cost more to run.", "default": 1000 }, "minDistressScore": { "title": "Minimum distress score", "minimum": 0, "maximum": 100, "type": "integer", "description": "Drop properties scoring below this (0-100). Around 40 keeps only properties with strong or stacked signals.", "default": 0 }, "minSignalCount": { "title": "Minimum signals per property", "minimum": 1, "type": "integer", "description": "Require at least this many distress records on the same property. Set to 2 or more for a short, high-conviction list.", "default": 1 }, "maxResults": { "title": "Max properties returned", "minimum": 0, "type": "integer", "description": "Cap the number of scored properties in the output. 0 means no cap.", "default": 0 }, "socrataAppToken": { "title": "Socrata app token (optional)", "type": "string", "description": "Your own free Socrata application token. Not required, but it raises the per-publisher rate limit on large runs." }, "requestDelaySeconds": { "title": "Delay between requests (seconds)", "minimum": 0, "maximum": 10, "type": "number", "description": "Pause between paged requests to stay polite to the data publishers.", "default": 0.2 }, "requireAddress": { "title": "Require a usable address or coordinates", "type": "boolean", "description": "Drop leads that end up with no street address and no coordinates. Some datasets publish only a parcel number; those rows merge with addressed rows when possible, and any that remain unlocatable cannot be mailed, visited or skip-traced. Turn off only if you work parcel numbers directly.", "default": true } } }, "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 } } } } } } } } } }