# GovEase Scraper - Tax Lien & Tax Deed Auctions and Parcels (`scrapersdelight/govease-auction-scraper`) Actor

Scrape GovEase county tax sales: every tax lien, tax deed, redeemable deed and foreclosure auction with its registration deadline, deposit and contacts, plus every listed parcel - parcel number, owner and mailing address, minimum bid or face value, assessed value, map point. New-sale monitor.

- **URL**: https://apify.com/scrapersdelight/govease-auction-scraper.md
- **Developed by:** [Scrapers Delight](https://apify.com/scrapersdelight) (community)
- **Categories:** Real estate, Lead generation, Business
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

$4.00 / 1,000 per parcel or auction returneds

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
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.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## 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.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

### What does GovEase Scraper do?

**GovEase Scraper** exports the county tax sales listed on GovEase (liveauctions.govease.com), the online platform where US counties run tax lien, tax deed, redeemable deed and public-trustee foreclosure auctions. One row is either a **parcel** in a sale - parcel number, owner, minimum bid or face value, assessed value, legal description - or an **auction** - the county sale with its start date, registration deadline, deposit and payment terms and the county's contact. Built for tax lien investors, tax deed buyers, real-estate wholesalers and data teams who want every GovEase sale in a spreadsheet, a CRM or a daily alert instead of clicking through each county.

Also searched as: GovEase API, GovEase tax lien list, GovEase tax deed list, online tax sale scraper, county tax auction data.

- **Every county on GovEase in one run:** on 2026-10-16 GovEase listed 90 auctions in 10 states (CA, CO, IN, KS, MO, OK, PA, TN, TX, WA); 48 had parcels posted, 8,115 parcels in all. The whole site reads in about a minute.
- **The whole parcel list, not one page:** each sale's list comes from GovEase's own export - all 2,227 parcels of Costilla County CO's sale in one request.
- **Auction terms in every row:** start date, registration deadline, pre-bid opening, deposit requirement, bidder fee, bid increment and clock, payment handler, methods and deadline, the county contact (name, phone, email), required forms and the county's own instructions.
- **Map point and parcel boundary:** turn on parcel pages for latitude/longitude and the boundary polygon (91.7% of 1,000 parcels on 2026-10-16), the full situs address, status, current bid, time left and posted notices.
- **Sale results:** a parcel's page stays up after the sale with "Auction Sold" and the result - the winning bid on bid-up sales, the winning overbid ($ and % over face value) on lien sales. Feed earlier `sourceUrl`s back in to collect them.
- **New-sale monitor:** monitor mode delivers only auctions and parcels that earlier runs have not delivered.
- **No login, no account, no API key.** Pay only for delivered rows - no start fee.

### What data can you get from GovEase?

<table>
<tr>
<td>🆔 Parcel number (`parcelId`)</td>
<td>🔖 GovEase unique # + item id</td>
<td>🏛️ County, state, agency</td>
</tr>
<tr>
<td>🏷️ Sale type (Tax Lien, Tax Deed...)</td>
<td>💵 Minimum bid or face value</td>
<td>🏠 Situs address</td>
</tr>
<tr>
<td>👤 Owner name</td>
<td>📬 Owner mailing address</td>
<td>📊 Assessed value (land, improvements)</td>
</tr>
<tr>
<td>📅 Tax year</td>
<td>📜 Legal + property description</td>
<td>📈 Lien-to-value %, discount vs assessed</td>
</tr>
<tr>
<td>🗓️ Auction start + pre-bid opening</td>
<td>⏰ Registration deadline + status</td>
<td>💰 Deposit, bidder fee, payment terms</td>
</tr>
<tr>
<td>☎️ County contact name, phone, email</td>
<td>📝 Required forms + county instructions</td>
<td>📍 Latitude / longitude + boundary</td>
</tr>
<tr>
<td>🚦 Status, current bid, time left</td>
<td>🏆 Winning bid / overbid on sold parcels</td>
<td>📎 Parcel notices + county parcel card</td>
</tr>
</table>

Across all 8,115 parcels on 2026-10-16 the parcel number was filled on 99.8%, the amount (minimum bid or face value) on 95.3%, the owner on 93.5%, the tax year on 90.6% and the legal description on 82.9%. What else a parcel carries depends on what its county sends GovEase - see the fill table below.

### How to scrape GovEase with GovEase Scraper

1. [Create a free Apify account](https://console.apify.com/sign-up) - $5 of monthly credit, no card needed.
2. Open [GovEase Scraper](https://apify.com/scrapersdelight/govease-auction-scraper) and click **Try for free**.
3. Pick parcels, auctions or both; add states, counties, sale types or an amount range if you want fewer rows.
4. Click **Start**. Rows stream into the dataset sale by sale.
5. Open the **Storage** tab and **Export** as JSON, CSV or Excel - or schedule it daily with monitor mode on.

### ⬇️ Input

| Parameter | Type | Description |
|---|---|---|
| **🔍 What to scrape** | | |
| `scope` | Select | `parcels` (default), `auctions` or `both` (each auction row followed by its parcels) |
| `auctions` | List | Pin named sales: an auction id (`1391`), a GovEase auction or registration URL, or a county-site slug (`calosangeles`). Empty = every listed auction |
| `parcelUrls` | List | GovEase parcel page URLs (`sourceUrl` of earlier rows): reads only those pages - status, current bid, and once sold the winning bid or winning overbid |
| **🎯 Filters** (on GovEase's auction list, before any parcel list is read) | | |
| `states` | List | Two-letter codes, e.g. `CO`, `TN`, `TX` |
| `counties` | List | County names with or without "County", e.g. `Los Angeles`, `Costilla` |
| `saleTypes` | Select | Tax Lien, Tax Deed, Redeemable Tax Deed, Deed, Foreclosure, Mobile Home Delinquent Tax Sale, Mobile Home Distraint Sale |
| `upcomingOnly` | Boolean | Only auctions starting today or later. Default `false` |
| `auctionStartFrom` / `auctionStartTo` | Date | Auction start-date window (YYYY-MM-DD) |
| **✂️ Refine parcels** | | |
| `keywords` | List | Whole words or phrases in the parcel number, owner, address, legal or property description, e.g. `LLC`, `VACANT LOT` |
| `minAmount` / `maxAmount` | Integer | Minimum bid or face value range in USD |
| `withAddressOnly` | Boolean | Only parcels with a street address |
| **➕ Extra data** | | |
| `includeParcelDetails` | Boolean | Open each delivered parcel's page: map point + boundary, full situs address, status, current bid, time left, county parcel card, notices. Default `false` - same price per row |
| **🔁 Monitoring** | | |
| `monitorMode` | Boolean | Deliver only auctions and parcels not delivered by earlier runs with the same filters |
| `monitorKey` | Text | Optional name for the monitor memory |
| **📦 Output** | | |
| `maxResults` | Integer | Most rows per run. Default `100`; `0` = no cap |
| `maxParcelsPerAuction` | Integer | Most parcels from one sale; `0` = no cap |
| **⚙️ Advanced** | | |
| `maxConcurrency` | Integer | Parcel pages read at once (1-16). Default `6` |
| `proxyConfiguration` | Proxy | Not needed - GovEase answers direct requests; a refused route falls back to US residential by itself, under a per-run cap |

#### Input JSON

```json
{
  "scope": "both",
  "states": ["CO"],
  "saleTypes": ["tax-lien"],
  "maxAmount": 5000,
  "maxParcelsPerAuction": 50,
  "maxResults": 500
}
```

#### Leave the form empty for the next sales

With no filters the run walks GovEase's auction list from the soonest upcoming sale onward and stops at `maxResults`, so a capped run gives you what you can still register for and bid on.

#### Pick parcels or auctions before anything else

`parcels` is one row per property. `auctions` is one row per county sale (90 rows covers the whole site) with the registration deadline, deposit, payment rules, county contact and parcel count - the calendar view. `both` puts each sale's row ahead of its parcels.

#### Filter the sales, then refine the parcels

States, counties, sale types and the start-date window are applied to GovEase's list of sales, so a narrow run reads fewer parcel lists and finishes faster. Keywords, the amount range and the address switch are applied to each sale's parcels.

#### Collect results after a sale

GovEase removes a sale's parcel list when the sale closes, but each parcel's own page stays up with "Auction Sold" or "Auction Closed" and the end time. A sold bid-up parcel shows its winning bid (`winningBid`); a sold lien parcel shows the winning overbid over face value (`winningOverbid` in dollars, `winningOverbidPct`; "Face Value" = 0% and no dollar amount). Save the `sourceUrl`s while the sale is live, then run them through `parcelUrls` afterwards. On 2026-10-16, 29 parcel pages of Marion County IN's finished lien sale returned 27 "Auction Sold" (25 with a dollar overbid, e.g. $56,112 on a $4,183.19 face value = 1,341%) and 2 "Auction Closed".

### ⬆️ Output

A parcel row with its parcel page (`includeParcelDetails` on), from a run on 2026-10-16 (boundary shortened):

```json
{
  "recordType": "parcel",
  "auctionId": 1391,
  "itemId": 27653,
  "parcelId": "2024002096",
  "state": "CA",
  "county": "Los Angeles",
  "address": "22040 GAULT ST UNIT 50",
  "saleType": "Tax Deed",
  "amountType": "minimumBid",
  "minimumBid": 41374,
  "legalDescription": "*TR=38920 CONDOMINIUM*UNIT 50",
  "status": "Auction Scheduled",
  "timeLeft": "03d 22h",
  "latitude": 34.1986870769506,
  "longitude": -118.607376836511,
  "parcelBoundary": [[[-118.60701905, 34.19910691], [-118.6070166, 34.19828219]]],
  "auctionName": "2026B Los Angeles County Tax Deed Auction",
  "auctionStartDate": "2026-10-17T17:00:00-05:00",
  "registrationCloses": "2026-10-13T15:00:00-05:00",
  "depositRequired": true,
  "sourceUrl": "https://liveauctions.govease.com/ca/calosangeles/1391/openstandardparcel/27653/2024002096"
}
```

A tax lien parcel from the same day (the county publishes the owner's mailing address):

```json
{
  "recordType": "parcel",
  "auctionId": 1295,
  "parcelId": "R004087",
  "county": "Bent",
  "state": "CO",
  "ownerName": "ABBATE-DEVARGAS GINETTA MARIA & (JTWROS)",
  "ownerMailingAddress": "435 COTTONWOOD AVENUE LAS ANIMAS, CO 81054",
  "saleType": "Tax Lien",
  "amountType": "faceValue",
  "faceValue": 554.63,
  "taxYear": 2025,
  "legalDescription": "N 75 FT OF LOTS 1 THRU 6; BLK 70; LA",
  "propertyDescription": "Actual Value: $136,544 Tax $488.30 Interest $31.33 Penalty $0.00 Other $35.00",
  "auctionStartDate": "2026-11-05T11:00:00-06:00"
}
```

An auction row (instructions and forms shortened):

```json
{
  "recordType": "auction",
  "auctionId": 1295,
  "auctionName": "2026 Bent County Tax Lien Auction",
  "state": "CO",
  "county": "Bent",
  "saleType": "Tax Lien",
  "listingFormat": "face-value",
  "parcelCount": 419,
  "auctionStartDate": "2026-11-05T11:00:00-06:00",
  "prebiddingOpens": "2026-11-04T11:00:00-06:00",
  "registrationOpens": "2026-10-05T11:00:00-05:00",
  "registrationCloses": "2026-11-04T13:30:00-06:00",
  "registrationStatus": "open",
  "bidClockLength": "30 seconds",
  "bidIncrement": 1,
  "depositRequired": false,
  "paymentHandledBy": "Bent County Treasurer",
  "contactName": "Kathy Brown and Jennifer Godfrey",
  "contactPhone": "(719) 456-2211",
  "contactEmail": "bent.treasurer@bentcounty.gov",
  "registrationRequirements": [{ "name": "Buyer Agreement Form 2026 (Bent, CO)", "documentUrl": "https://liveauctions.govease.com/FormsDocs/COBentBuyerAgreement (7) (2).docx" }],
  "countyInstructions": "TAX LIEN AUCTION - OVERBID AUCTION\nTHERE WILL BE A 10 SECOND CLOCK RESET ON EACH PARCEL\n...",
  "parcelListCsvUrl": "https://liveauctions.govease.com/OpenAuction/CountyOpenAuctionsDownload?stateAbbr=co&countySlug=cobent&countyID=1295"
}
```

#### Fields and measured fill

Parcel fields: all 8,115 parcels on 2026-10-16 (and the 7,562 parcels of 2026-10-14 where a county field came and went with one sale). Parcel-page fields: 1,000 parcels with `includeParcelDetails` on, 2026-10-16. A county that does not send a field leaves it null - never a zero.

| Field | What it is | Fill |
|---|---|---|
| `auctionId`, `itemId`, `uniqueNumber`, `parcelId` | GovEase sale id, parcel item id, the sale's own lot number, parcel number | 100% / 100% / 100% / 99.8% |
| `state`, `county`, `saleType`, `auctionName`, `entity` | Where, what kind of sale, which sale and agency | 100% |
| `amountType`, `minimumBid`, `faceValue` | Minimum bid on bid-up sales, face value (taxes, interest, fees owed) on lien sales | 95.3% (one of the two) |
| `ownerName` | Owner (or case style on Texas sales) | 93.5% |
| `ownerMailingAddress` | Owner's mailing address, where the county publishes it | 5.3% (12.7% on 10-14) |
| `address` | Situs address from the list | 34.9% (39.9% on 10-14) |
| `taxYear` | Delinquent tax year | 90.6% |
| `assessedTotal` | Assessed value | 10.8% (18.5% on 10-14) |
| `landValue`, `improvementsValue` | Assessed land / improvements | 0% today; 6.9% / 5.2% on 10-14 (Marion County IN's sale) |
| `lienToValuePct` | Face value as % of the county's assessed value (Colorado assessed values are a fraction of market value) | 10.1% |
| `discountVsAssessedPct`, `equityMarginEstimate` | Minimum bid vs assessed value, where both exist | 0.6% |
| `legalDescription`, `propertyDescription` | Legal text; property notes (Colorado lists actual value, tax, interest and fees here) | 82.9% / 51.5% |
| `auctionStartDate`, `registrationCloses`, `depositRequired`, `bidderRegistrationFee` | Sale terms on every parcel row | 100% / 99.6% / 100% / 9.8% |
| `latitude`, `longitude`, `parcelBoundary` | Map point and boundary polygon (parcel pages) | 91.7% / 91.5% |
| `situsAddress` | Full situs address, with city and ZIP where GovEase has them (parcel pages) | 52.6% |
| `status`, `statusDetail`, `timeLeft` | "Auction Scheduled" / "Auction Sold" / "Auction Closed", the start or end line, time left | 100% / 75.3% / 75.3% |
| `currentBid`, `winningBid`, `auctionEndedAt` | Highest bid so far; the winning bid (bid-up sales) and end time once sold | while bidding / after the sale |
| `winningOverbid`, `winningOverbidPct` | Winning premium over face value on a sold lien parcel, in $ and % | after the sale: 25 / 28 of 29 Marion IN pages |
| `countyParcelUrl`, `documents`, `documentsBundleUrl` | County parcel card link; posted notices (category, file, date) and one-PDF bundle | 57.2% / 53.4% on 10-14's 1,000; 0% / 1.9% on 10-16's |
| `auctionUrl`, `registrationUrl`, `sourceUrl` | Links to the sale, its registration page and the parcel page | 100% |

Auction rows (all 90 on 2026-10-16): sale name, state, county, agency, type, start date, parcel count, bid clock, increment, payment handler, county contact name and instructions 100%; contact phone 98.9%, email 96.7%, registration window 95.6%, pre-bid opening 75.6%, payment methods 75.6%, deposit instructions 61.1%, payment deadline 47.8%, bidder fee 18.9%.

### Use cases

- 💼 **Tax lien investors** - pull every Colorado, Pennsylvania or Tennessee lien sale with face values and owners before registration closes.
- 🏚️ **Tax deed buyers and flippers** - filter deed and foreclosure sales by county and minimum bid, then map the parcels with the boundary polygons.
- 📬 **Wholesalers and direct-mail teams** - owner names and mailing addresses from lien sales for pre-sale outreach.
- 🗓️ **Funds and bidder services** - the auction calendar with registration deadlines, deposits and county contacts in one table.
- 📊 **Analysts** - collect sold prices and lien overbids with `parcelUrls` after each sale closes.
- 🤖 **Alerts** - a daily monitor run that posts only new sales and newly listed parcels to Slack or a sheet.

### How much does it cost to scrape GovEase?

Pay per result: **$0.004 per parcel or auction** ($4 per 1,000). No start fee. Parcel pages (map, status, notices) cost nothing extra. Parcels removed by your filters, rows an earlier monitor run delivered, and parcels whose page could not be read are never delivered or charged.

| Run | Rows | Price |
|---|---|---|
| Prefilled demo | 10 parcels | $0.04 |
| Default (`{}`) | 100 parcels | $0.40 |
| Every auction (calendar) | 90 auctions | $0.36 |
| 1,000 parcels with parcel pages | 1,000 | $4.00 |
| The whole site | 8,205 rows | ~$32.82 |

Measured speed (2026-10-16, direct): 10 parcels in ~12 s, 100 in ~6 s, 1,000 in ~9 s, 1,000 with parcel pages in ~3.5 min, all 90 auctions in ~43 s, the whole site in ~1 min.

### Integrations, API, scheduling & MCP

Put the actor on a [schedule](https://docs.apify.com/platform/schedules) with `monitorMode` on and each run delivers only new sales and newly posted parcels. Send rows to Google Sheets, Slack, Make, Zapier or n8n through [Apify integrations](https://apify.com/integrations), or fire a webhook when a run finishes. Call it from code with the [Python](https://apify.com/scrapersdelight/govease-auction-scraper/api/python) or [JavaScript](https://apify.com/scrapersdelight/govease-auction-scraper/api/javascript) client, or give it to an AI agent through the [Apify MCP server](https://apify.com/scrapersdelight/govease-auction-scraper/api/mcp).

### More tax sale and auction scrapers

- 🏛️ [Bid4Assets Scraper](https://apify.com/scrapersdelight/bid4assets-tax-sale-scraper) - county tax deed and sheriff sale parcels on Bid4Assets (CA, FL, LA, NV, OK, PA, WA, WI).
- 🏠 [Auction.com Scraper](https://apify.com/scrapersdelight/auction-com-scraper) - foreclosure and bank-owned homes.
- 🏙️ [Municibid Scraper](https://apify.com/scrapersdelight/municibid-scraper) - government surplus auctions and alerts.
- 🚜 [GovDeals Scraper](https://apify.com/scrapersdelight/govdeals-auction-scraper) - government surplus auction lots.
- 🔨 [HiBid Auction Scraper](https://apify.com/scrapersdelight/hibid-scraper) - lots, bids and prices across HiBid auctioneers.
- See all our actors on [our Apify profile](https://apify.com/scrapersdelight).

### Limits & empty runs

- GovEase lists only live and upcoming sales; a closed sale's parcel list disappears and its results are not published as a list. Each parcel page keeps its own outcome - see "Collect results after a sale" - so keep the `sourceUrl`s of the parcels you care about.
- No interest rate is published per parcel; Colorado sales put the tax, interest and fee amounts in `propertyDescription`.
- GovEase's export replaces non-ASCII characters (degree signs in metes-and-bounds legals, curly apostrophes) with `??`; text is delivered as GovEase exports it.
- Some auctions are county "sale postings" (Tennessee special commissioner sales) with one notice-style parcel and no amount.
- A sale with no parcels posted yet still returns its auction row (`parcelCount: 0`); a parcel run skips it.
- Filters that match nothing end with 0 rows and cost nothing.

### ❓ FAQ

#### How much does GovEase Scraper cost?

$0.004 per parcel or auction delivered, parcel pages included. There is no start fee, so a run that finds nothing costs nothing.

#### How many parcels can GovEase Scraper return?

Everything GovEase lists: 8,115 parcels in 48 sales and 90 auction rows on 2026-10-16. Set `maxResults` to `0` for no cap.

#### Can GovEase Scraper alert me to new tax sales?

Yes. Turn on `monitorMode` and schedule the actor daily; each run delivers only auctions and parcels it has not delivered before for the same filters.

#### Does GovEase Scraper return the owner's name and address?

The owner's name comes on 93.5% of parcels. The mailing address comes where the county sends it to GovEase (on 2026-10-16: Bent County CO's lien sale, two Colorado foreclosure sales and one Tennessee posting); the situs address is on 34.9% of list rows and 52.6% of parcel pages.

#### Does GovEase Scraper give the registration deadline and deposit?

Yes - every parcel row carries its sale's registration deadline, deposit requirement and bidder fee, and auction rows add the full payment terms, county contact, required forms and the county's instructions (where deposit amounts are written).

#### Can GovEase Scraper get sold prices?

Yes, parcel by parcel: a sold parcel's page keeps "Auction Sold" with the winning bid (bid-up sales) or the winning overbid in $ and % (lien sales). Save `sourceUrl`s during the sale and run them through `parcelUrls` afterwards.

#### Can I use GovEase Scraper with the Apify API or MCP?

Yes. Every input works through the API, and the actor is available to AI agents through the Apify MCP server.

#### Do I need a GovEase account to use GovEase Scraper?

No. The actor reads GovEase's public auction pages and exports as a guest - no login, no bidder account, no key.

#### Why did GovEase Scraper return no results?

No listed sale matched your filters (for example a state with no GovEase sale this season), or the matching sales have no parcels posted yet - try `scope: "auctions"` to see them. `RUN_SUMMARY` lists every sale read with its parcel count.

#### Your feedback

Found a bug or need a field? Open an issue on the [Issues tab](https://apify.com/scrapersdelight/govease-auction-scraper/issues/open) - we read every one.

# Actor input Schema

## `scope` (type: `string`):

What one row is. Every row is charged the same.

## `auctions` (type: `array`):

Pin the run to named sales: an auction id ("1391"), a GovEase auction or registration URL ("https://liveauctions.govease.com/CA/calosangeles/1391/browse") or a county-site slug ("calosangeles"). Empty = every listed auction.

## `parcelUrls` (type: `array`):

GovEase parcel page URLs (the sourceUrl of earlier rows). Reads only these pages: status, current bid and, after the sale, "Auction Sold" with the winning bid (bid-up sales) or winning overbid (lien sales). Overrides the scope above.

## `states` (type: `array`):

Two-letter codes, e.g. "CO", "TN", "TX". Parcels listed on 2026-10-14: CO 5,715 - PA 742 - IN 573 - CA 317 - TX 92 - TN 89 - MO 31 - WA 3 (KS and OK listed auctions with no parcels yet). Empty = every state.

## `counties` (type: `array`):

County names, with or without "County": "Los Angeles", "Marion", "Costilla County". Matched against the sale's name, agency and GovEase county site. Empty = every county.

## `saleTypes` (type: `array`):

GovEase's own sale types. Auctions on 2026-10-14: Deed 22, Tax Lien 20, Redeemable Tax Deed 19, Tax Deed 17, Foreclosure 7. Empty = every type.

## `upcomingOnly` (type: `boolean`):

Only auctions whose start date is today or later. Off keeps sales already running (bidding open, batches still closing) and county sale postings.

## `auctionStartFrom` (type: `string`):

YYYY-MM-DD, e.g. "2026-11-01". Filters on the auction's start date.

## `auctionStartTo` (type: `string`):

YYYY-MM-DD. With the field above, one sale season, e.g. the November Colorado lien sales.

## `keywords` (type: `array`):

Any of these words in the parcel number, owner, address, legal or property description, e.g. "LLC", "VACANT LOT", "MAIN ST". Case-insensitive.

## `minAmount` (type: `integer`):

Drop parcels whose minimum bid (bid-up sales) or face value (lien sales) is below this. Measured over 7,201 priced parcels on 2026-10-14: lowest $15.84, median $288.42, 90th percentile $7,819, highest $940,356.

## `maxAmount` (type: `integer`):

Drop parcels whose minimum bid or face value is above this, e.g. 5000 for small liens.

## `withAddressOnly` (type: `boolean`):

40% of parcels carry a situs address in GovEase's list (the rest list a legal description only, typical of Colorado lien sales).

## `includeParcelDetails` (type: `boolean`):

Adds map point + parcel boundary (71% of 98 sampled pages), full situs address with city and ZIP, status ("Auction Scheduled" / "Auction Sold"), current bid, time left, county parcel-card link and posted notices.

## `monitorMode` (type: `boolean`):

Delivers only auctions and parcels that earlier monitor runs with the same filters have not delivered. The memory lives in a named key-value store on your account.

## `monitorKey` (type: `string`):

Optional. Runs with the same name share one memory even if their filters differ, e.g. "colorado-liens". Empty = one memory per filter set.

## `maxResults` (type: `integer`):

Hard cap on rows delivered and charged. 0 = no cap (the whole site was 7,562 parcels + 85 auctions on 2026-10-14). A capped run takes the soonest upcoming sales first.

## `maxParcelsPerAuction` (type: `integer`):

Spread a capped run across sales, e.g. 25 parcels from each. 0 = no per-auction cap.

## `maxConcurrency` (type: `integer`):

Parcel pages read at once (auction lists: up to 4). GovEase answered 119 parcel pages at 4 in parallel without a refusal.

## `proxyConfiguration` (type: `object`):

Optional. GovEase answers direct requests; the Actor falls back to Apify residential (US) on its own only if GovEase refuses, under a per-run cap. Set a proxy here only to force one.

## Actor input object example

```json
{
  "scope": "parcels",
  "auctions": [],
  "states": [],
  "counties": [],
  "saleTypes": [],
  "upcomingOnly": false,
  "keywords": [],
  "withAddressOnly": false,
  "includeParcelDetails": false,
  "monitorMode": false,
  "maxResults": 10,
  "maxParcelsPerAuction": 0,
  "maxConcurrency": 6,
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}
```

# Actor output Schema

## `results` (type: `string`):

One item per parcel or auction (recordType tells which).

## `summary` (type: `string`):

Auctions read, parcels listed and delivered, filtered and already-seen rows, unreachable parcel pages, transport stats and billing.

# 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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "scope": "parcels",
    "maxResults": 10
};

// Run the Actor and wait for it to finish
const run = await client.actor("scrapersdelight/govease-auction-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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "scope": "parcels",
    "maxResults": 10,
}

# Run the Actor and wait for it to finish
run = client.actor("scrapersdelight/govease-auction-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "scope": "parcels",
  "maxResults": 10
}' |
apify call scrapersdelight/govease-auction-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,scrapersdelight/govease-auction-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/xrKUuneOgWXcqwjtW/builds/YTmS8ygH8kWml1Pgm/openapi.json
