# SalesWeb CivilView Sheriff Foreclosure Sales Scraper (`jungle_synthesizer/salesweb-civilview-sheriff-foreclosure-sales-scraper`) Actor Scrapes multi-county sheriff foreclosure sales from SalesWeb (Tyler CivilView). Covers all available counties across NJ, PA, OH, IL and more — returning scheduled, postponed, cancelled, and sold listings with addresses, plaintiff/defendant, and optional judgment amounts. - **URL**: https://apify.com/jungle\_synthesizer/salesweb-civilview-sheriff-foreclosure-sales-scraper.md - **Developed by:** [BowTiedRaccoon](https://apify.com/jungle_synthesizer) (community) - **Categories:** Real estate, Lead generation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing Pay per event This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## SalesWeb CivilView Sheriff Foreclosure Sales Scraper Extract multi-county sheriff foreclosure sale listings from the [SalesWeb (Tyler CivilView)](https://salesweb.civilview.com/) platform — the official sheriff-sale portal for counties across New Jersey, Pennsylvania, Ohio, Illinois, and more. All 61+ available counties are covered in a single run. Each listing includes the property address, plaintiff (lender), defendant (owner), sale date, and a link to the detail page for enrichment data (judgment amounts, parcel APN, attorney). ### What You Get | Field | Description | |-------|-------------| | `county` | Full county + state label (e.g. "Essex County, NJ") | | `state` | State abbreviation (e.g. "NJ") | | `sheriff_number` | Sheriff sale number (e.g. "F-22000326") | | `sales_date` | Scheduled sale date (MM/DD/YYYY) | | `plaintiff` | Foreclosing lender / plaintiff name | | `defendant` | Property owner / defendant name | | `property_address` | Street address | | `city` | City | | `zip` | ZIP code | | `sale_type` | Type of sale (foreclosure / tax / execution) | | `property_id` | CivilView PropertyId integer | | `detail_url` | URL to the sale detail page | | `first_seen` | ISO timestamp when record was scraped | **With `fetchDetails: true` (optional):** | Field | Description | |-------|-------------| | `upset_amount` | Approximate upset/judgment amount | | `judgment_amount` | Same as `upset_amount` (alias for schema consistency) | | `parcel_apn` | Parcel / APN number | | `attorney` | Plaintiff attorney name | | `status` | Current status (Re-Scheduled / Adjourned / etc.) | ### Use Cases - **Distressed property leads** — identify properties headed to sheriff sale before they hit the MLS - **Lender / plaintiff research** — track which lenders are most active in foreclosure proceedings per county - **Title company due diligence** — monitor all active sheriff sales in target counties - **Investor deal flow** — run weekly to catch newly scheduled, postponed, or cancelled sales - **Data aggregation** — combine all NJ or PA counties into a unified dataset for analysis ### Input | Parameter | Type | Default | Description | |-----------|------|---------|-------------| | `maxItems` | Integer | — | Maximum records to scrape (leave blank for all) | | `countyIds` | Array | `[2]` (Essex, NJ) | County IDs to scrape. Leave blank for all 61+ counties. Find IDs in the detail URL of any listing. | | `fetchDetails` | Boolean | `false` | Fetch individual sale detail pages for enriched fields (upset amount, APN, attorney, status) | #### County ID Reference (sample) | County | ID | |--------|-----| | Essex County, NJ | 2 | | Camden County, NJ | 1 | | Bergen County, NJ | 7 | | Burlington County, NJ | 3 | | Atlantic County, NJ | 25 | | Cape May County, NJ | 52 | Leave `countyIds` blank to scrape all available counties in one run. ### How It Works 1. **County discovery** — Scrapes the homepage to enumerate all available county links 2. **Listing scrape** — For each county, fetches the listing page (plain GET, server-rendered HTML, no captcha) 3. **Detail enrichment** (optional) — If `fetchDetails: true`, fetches each listing's detail page for judgment amounts, APN, and attorney info The SalesWeb platform refreshes county data every 30 minutes (9 AM–4 PM, Mon–Fri). Run weekly or daily to capture new listings and postponement changes. ### Notes - No proxy, captcha, or authentication required — the site is publicly accessible - Detail pages (`fetchDetails: true`) require the session cookie established by the listing page visit. Runs in Apify cloud handle this automatically via the session cookie jar. - Each county typically has 50–200 active listings. Essex County NJ has ~174 active at any time. # Actor input Schema ## `sp_intended_usage` (type: `string`): Please describe how you plan to use the data extracted by this crawler. ## `sp_improvement_suggestions` (type: `string`): Provide any feedback or suggestions for improvements. ## `sp_contact` (type: `string`): Provide your email address so we can get in touch with you. ## `maxItems` (type: `integer`): Maximum number of records to scrape. Leave blank for all available listings. ## `fetchDetails` (type: `boolean`): When enabled, fetches the individual sale detail page for each listing to retrieve judgment/upset amounts, parcel APN, and attorney info. ## `countyIds` (type: `array`): Limit scraping to specific county IDs (e.g. [2, 7, 25] for Essex/Bergen/Atlantic NJ). Leave blank to scrape all available counties. ## Actor input object example ```json { "sp_intended_usage": "Describe your intended use...", "sp_improvement_suggestions": "Share your suggestions here...", "sp_contact": "Share your email here...", "maxItems": 10, "fetchDetails": false, "countyIds": [ 2 ] } ```` # Actor output Schema ## `results` (type: `string`): No description # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "sp_intended_usage": "Describe your intended use...", "sp_improvement_suggestions": "Share your suggestions here...", "sp_contact": "Share your email here...", "maxItems": 10, "countyIds": [ 2 ] }; // Run the Actor and wait for it to finish const run = await client.actor("jungle_synthesizer/salesweb-civilview-sheriff-foreclosure-sales-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "sp_intended_usage": "Describe your intended use...", "sp_improvement_suggestions": "Share your suggestions here...", "sp_contact": "Share your email here...", "maxItems": 10, "countyIds": [2], } # Run the Actor and wait for it to finish run = client.actor("jungle_synthesizer/salesweb-civilview-sheriff-foreclosure-sales-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "sp_intended_usage": "Describe your intended use...", "sp_improvement_suggestions": "Share your suggestions here...", "sp_contact": "Share your email here...", "maxItems": 10, "countyIds": [ 2 ] }' | apify call jungle_synthesizer/salesweb-civilview-sheriff-foreclosure-sales-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=jungle_synthesizer/salesweb-civilview-sheriff-foreclosure-sales-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "SalesWeb CivilView Sheriff Foreclosure Sales Scraper", "description": "Scrapes multi-county sheriff foreclosure sales from SalesWeb (Tyler CivilView). Covers all available counties across NJ, PA, OH, IL and more — returning scheduled, postponed, cancelled, and sold listings with addresses, plaintiff/defendant, and optional judgment amounts.", "version": "0.1", "x-build-id": "RDor01akadb5ggIHs" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/jungle_synthesizer~salesweb-civilview-sheriff-foreclosure-sales-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-jungle_synthesizer-salesweb-civilview-sheriff-foreclosure-sales-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/jungle_synthesizer~salesweb-civilview-sheriff-foreclosure-sales-scraper/runs": { "post": { "operationId": "runs-sync-jungle_synthesizer-salesweb-civilview-sheriff-foreclosure-sales-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/jungle_synthesizer~salesweb-civilview-sheriff-foreclosure-sales-scraper/run-sync": { "post": { "operationId": "run-sync-jungle_synthesizer-salesweb-civilview-sheriff-foreclosure-sales-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", "required": [ "maxItems" ], "properties": { "sp_intended_usage": { "title": "What is the intended usage of this data?", "minLength": 1, "type": "string", "description": "Please describe how you plan to use the data extracted by this crawler." }, "sp_improvement_suggestions": { "title": "How can we improve this crawler for you?", "minLength": 1, "type": "string", "description": "Provide any feedback or suggestions for improvements." }, "sp_contact": { "title": "Contact Email", "minLength": 1, "type": "string", "description": "Provide your email address so we can get in touch with you." }, "maxItems": { "title": "Max Items", "type": "integer", "description": "Maximum number of records to scrape. Leave blank for all available listings." }, "fetchDetails": { "title": "Fetch Detail Pages", "type": "boolean", "description": "When enabled, fetches the individual sale detail page for each listing to retrieve judgment/upset amounts, parcel APN, and attorney info.", "default": false }, "countyIds": { "title": "County IDs (optional filter)", "type": "array", "description": "Limit scraping to specific county IDs (e.g. [2, 7, 25] for Essex/Bergen/Atlantic NJ). Leave blank to scrape all available counties.", "items": { "type": "string" } } } }, "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 } } } } } } } } } } ```