{ "openapi": "3.0.1", "info": { "title": "Probate & Foreclosure Leads Scraper: Government Records", "description": "Extract probate, foreclosure, sheriff sale, tax lien, and tax sale leads from verified US county and city public records: case numbers, decedent and defendant names, property addresses, and estimated equity.", "version": "0.1", "x-build-id": "Z0afDZfs3hJ52wAqd" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/getascraper~probate-foreclosure-leads-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-getascraper-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/getascraper~probate-foreclosure-leads-scraper/runs": { "post": { "operationId": "runs-sync-getascraper-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/getascraper~probate-foreclosure-leads-scraper/run-sync": { "post": { "operationId": "run-sync-getascraper-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": "Which kinds of distressed-property leads to pull. Leave all selected to pull every event type available across the verified sources this Actor covers.", "items": { "type": "string", "enum": [ "probate", "foreclosure", "sheriff_sale", "tax_lien", "tax_sale" ], "enumTitles": [ "Probate", "Foreclosure", "Sheriff sale", "Tax lien", "Tax sale" ] }, "default": [ "probate", "foreclosure", "sheriff_sale", "tax_lien", "tax_sale" ] }, "states": { "title": "States", "type": "array", "description": "Two-letter US state codes to filter to (e.g. \"LA\", \"MD\"). Leave empty to include every state this Actor has a verified source for.", "default": [], "items": { "type": "string" } }, "counties": { "title": "Counties", "type": "array", "description": "County or city names to filter to (case-insensitive, e.g. \"Orleans\", \"Howard\"). Leave empty to include every county this Actor has a verified source for.", "default": [], "items": { "type": "string" } }, "dateFrom": { "title": "Date from", "type": "string", "description": "Only include records with a filing or sale date on or after this date (YYYY-MM-DD). Leave empty for no lower bound." }, "dateTo": { "title": "Date to", "type": "string", "description": "Only include records with a filing or sale date on or before this date (YYYY-MM-DD). Leave empty for no upper bound." }, "minEstimatedEquity": { "title": "Minimum estimated equity (USD)", "minimum": 0, "type": "integer", "description": "Only keep leads whose estimated property equity is at least this amount. A record with no equity estimate available is excluded once this is set above 0. Set to 0 to keep every record regardless of equity data.", "default": 0 }, "onlyOwnerOccupied": { "title": "Only owner-occupied properties", "type": "boolean", "description": "When enabled, keep only records flagged as owner-occupied by the source. Most verified sources in this Actor do not publish this flag at all, so enabling this will sharply reduce (often to zero) results until more sources with this field are added. Leave disabled unless you specifically need it.", "default": false }, "maxItems": { "title": "Max items", "minimum": 0, "type": "integer", "description": "Maximum number of lead records to return across all matching sources combined. Use 0 for no limit (every matching record from every selected source).", "default": 100 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "These government open-data portals serve public records with no login and no anti-bot wall, so no proxy is required by default. Add one only if you see rate limiting at high volume.", "default": { "useApifyProxy": false } } } }, "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 } } } } } } } } } }