{
  "openapi": "3.0.1",
  "info": {
    "title": "GovEase Scraper - Tax Lien & Tax Deed Auctions and Parcels",
    "description": "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.",
    "version": "0.1",
    "x-build-id": "YTmS8ygH8kWml1Pgm"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/scrapersdelight~govease-auction-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-scrapersdelight-govease-auction-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/scrapersdelight~govease-auction-scraper/runs": {
      "post": {
        "operationId": "runs-sync-scrapersdelight-govease-auction-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/scrapersdelight~govease-auction-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-scrapersdelight-govease-auction-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": {
          "scope": {
            "title": "Rows to return",
            "enum": [
              "parcels",
              "auctions",
              "both"
            ],
            "type": "string",
            "description": "What one row is. Every row is charged the same.",
            "default": "parcels"
          },
          "auctions": {
            "title": "Specific auctions",
            "type": "array",
            "description": "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.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "parcelUrls": {
            "title": "Parcel pages (lookup / results)",
            "type": "array",
            "description": "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.",
            "items": {
              "type": "string"
            }
          },
          "states": {
            "title": "States",
            "type": "array",
            "description": "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.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "counties": {
            "title": "Counties",
            "type": "array",
            "description": "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.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "saleTypes": {
            "title": "Sale types",
            "type": "array",
            "description": "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.",
            "items": {
              "type": "string",
              "enum": [
                "tax-lien",
                "tax-deed",
                "redeemable-tax-deed",
                "deed",
                "foreclosure",
                "mobile-home-delinquent-tax-sale",
                "mobile-home-distraint-sale"
              ],
              "enumTitles": [
                "Tax Lien",
                "Tax Deed",
                "Redeemable Tax Deed",
                "Deed (judicial, sheriff, commissioner, land sales)",
                "Foreclosure (public trustee)",
                "Mobile Home Delinquent Tax Sale",
                "Mobile Home Distraint Sale"
              ]
            },
            "default": []
          },
          "upcomingOnly": {
            "title": "Upcoming sales only",
            "type": "boolean",
            "description": "Only auctions whose start date is today or later. Off keeps sales already running (bidding open, batches still closing) and county sale postings.",
            "default": false
          },
          "auctionStartFrom": {
            "title": "Auction starts on or after",
            "type": "string",
            "description": "YYYY-MM-DD, e.g. \"2026-11-01\". Filters on the auction's start date."
          },
          "auctionStartTo": {
            "title": "Auction starts on or before",
            "type": "string",
            "description": "YYYY-MM-DD. With the field above, one sale season, e.g. the November Colorado lien sales."
          },
          "keywords": {
            "title": "Keywords",
            "type": "array",
            "description": "Any of these words in the parcel number, owner, address, legal or property description, e.g. \"LLC\", \"VACANT LOT\", \"MAIN ST\". Case-insensitive.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "minAmount": {
            "title": "Minimum amount (USD)",
            "minimum": 0,
            "type": "integer",
            "description": "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": {
            "title": "Maximum amount (USD)",
            "minimum": 0,
            "type": "integer",
            "description": "Drop parcels whose minimum bid or face value is above this, e.g. 5000 for small liens."
          },
          "withAddressOnly": {
            "title": "Only parcels with a street address",
            "type": "boolean",
            "description": "40% of parcels carry a situs address in GovEase's list (the rest list a legal description only, typical of Colorado lien sales).",
            "default": false
          },
          "includeParcelDetails": {
            "title": "Open each parcel's page",
            "type": "boolean",
            "description": "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.",
            "default": false
          },
          "monitorMode": {
            "title": "Only new auctions and parcels",
            "type": "boolean",
            "description": "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.",
            "default": false
          },
          "monitorKey": {
            "title": "Monitor name",
            "type": "string",
            "description": "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": {
            "title": "Max rows",
            "minimum": 0,
            "type": "integer",
            "description": "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.",
            "default": 100
          },
          "maxParcelsPerAuction": {
            "title": "Max parcels per auction",
            "minimum": 0,
            "type": "integer",
            "description": "Spread a capped run across sales, e.g. 25 parcels from each. 0 = no per-auction cap.",
            "default": 0
          },
          "maxConcurrency": {
            "title": "Parallel requests",
            "minimum": 1,
            "maximum": 16,
            "type": "integer",
            "description": "Parcel pages read at once (auction lists: up to 4). GovEase answered 119 parcel pages at 4 in parallel without a refusal.",
            "default": 6
          },
          "proxyConfiguration": {
            "title": "Proxy",
            "type": "object",
            "description": "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.",
            "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
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "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
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}