{ "openapi": "3.0.1", "info": { "title": "Probate & Foreclosure Leads Scraper — US County Records", "description": "Collect US distressed-property leads from government open-data portals — probate, foreclosure, sheriff sale, tax lien, tax sale. Unified schema with case numbers, addresses, parcel IDs, parties, sale dates & amounts. Filter by state, county, date, equity. No proxies. JSON/CSV out.", "version": "0.0", "x-build-id": "j0DV2r3ohcVtq3sK0" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/memo23~probate-foreclosure-leads-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-memo23-probate-foreclosure-leads-scraper", "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/memo23~probate-foreclosure-leads-scraper/runs": { "post": { "operationId": "runs-sync-memo23-probate-foreclosure-leads-scraper", "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/memo23~probate-foreclosure-leads-scraper/run-sync": { "post": { "operationId": "run-sync-memo23-probate-foreclosure-leads-scraper", "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": { "eventTypes": { "title": "Event types", "type": "array", "description": "Distressed-property event types to collect. Leave empty to collect all five.", "items": { "type": "string", "enum": [ "probate", "foreclosure", "sheriff_sale", "tax_lien", "tax_sale" ], "enumTitles": [ "Probate", "Foreclosure", "Sheriff Sale", "Tax Lien", "Tax Sale" ] } }, "states": { "title": "States", "type": "array", "description": "Restrict results to these US states. Leave empty for all states with available open data.", "items": { "type": "string", "enum": [ "AL", "AK", "AZ", "AR", "CA", "CO", "CT", "DE", "DC", "FL", "GA", "HI", "ID", "IL", "IN", "IA", "KS", "KY", "LA", "ME", "MD", "MA", "MI", "MN", "MS", "MO", "MT", "NE", "NV", "NH", "NJ", "NM", "NY", "NC", "ND", "OH", "OK", "OR", "PA", "RI", "SC", "SD", "TN", "TX", "UT", "VT", "VA", "WA", "WV", "WI", "WY" ], "enumTitles": [ "Alabama", "Alaska", "Arizona", "Arkansas", "California", "Colorado", "Connecticut", "Delaware", "District of Columbia", "Florida", "Georgia", "Hawaii", "Idaho", "Illinois", "Indiana", "Iowa", "Kansas", "Kentucky", "Louisiana", "Maine", "Maryland", "Massachusetts", "Michigan", "Minnesota", "Mississippi", "Missouri", "Montana", "Nebraska", "Nevada", "New Hampshire", "New Jersey", "New Mexico", "New York", "North Carolina", "North Dakota", "Ohio", "Oklahoma", "Oregon", "Pennsylvania", "Rhode Island", "South Carolina", "South Dakota", "Tennessee", "Texas", "Utah", "Vermont", "Virginia", "Washington", "West Virginia", "Wisconsin", "Wyoming" ] } }, "counties": { "title": "Counties", "type": "array", "description": "Restrict to specific counties by name (e.g. `Cook`, `King`, `Orleans`). Case-insensitive, matched against both the portal's jurisdiction and per-row county columns. Leave empty for all.", "items": { "type": "string" } }, "dateFrom": { "title": "Date from (YYYY-MM-DD)", "type": "string", "description": "Keep events whose sale date (or filing date when no sale date exists) is on/after this date. Leave empty to disable." }, "dateTo": { "title": "Date to (YYYY-MM-DD)", "type": "string", "description": "Keep events whose sale date (or filing date when no sale date exists) is on/before this date. Leave empty to disable." }, "minEstimatedEquity": { "title": "Min estimated equity (USD)", "type": "integer", "description": "Only include records where `estimatedValue - mortgageBalance` is at least this value. Requires both figures in the source data, so non-zero values reduce coverage. 0 disables the filter.", "default": 0 }, "onlyOwnerOccupied": { "title": "Only owner-occupied", "type": "boolean", "description": "Drop records where owner-occupancy cannot be verified from the source data (owner-occupied / homestead flags).", "default": false }, "maxItems": { "title": "Max items", "type": "integer", "description": "Maximum number of distressed-property records to return across all source datasets.", "default": 100 }, "maxItemsPerDataset": { "title": "Max items per source dataset", "type": "integer", "description": "Cap per single source dataset so one large county doesn't consume the whole `maxItems` budget. 0 = no cap.", "default": 0 }, "liveDiscovery": { "title": "Live cross-portal discovery", "type": "boolean", "description": "In addition to the curated registry of verified county datasets, run live discovery queries across the whole open-data network to pick up newly published datasets. Slightly slower start, wider coverage.", "default": true }, "socrataAppToken": { "title": "Socrata app token (optional)", "type": "string", "description": "Optional free app token that raises the open-data API rate limits — recommended for large pulls (10k+ records). Get one at evergreen.data.socrata.com/signup." }, "maxConcurrency": { "title": "Max concurrent dataset fetches", "minimum": 1, "maximum": 20, "type": "integer", "description": "How many source datasets are paged in parallel.", "default": 6 } } }, "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 } } } } } } } } } }