{
  "openapi": "3.0.1",
  "info": {
    "title": "Foreclosure & Tax Deed Auction Leads: Sheriff Sale Scraper",
    "description": "Motivated-seller leads from county foreclosure, sheriff sale and tax deed auctions in 17 states: case number, parcel, address, judgment, opening bid, assessed value and sale results. Florida, Ohio, Indiana, Texas, Pennsylvania, Colorado and more. No login. From $8 per 1,000 leads.",
    "version": "0.0",
    "x-build-id": "jkSsojMLcVGb6ouYQ"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/epicscrapers~distressed-property-leads-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-epicscrapers-distressed-property-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/epicscrapers~distressed-property-leads-scraper/runs": {
      "post": {
        "operationId": "runs-sync-epicscrapers-distressed-property-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/epicscrapers~distressed-property-leads-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-epicscrapers-distressed-property-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": {
          "counties": {
            "title": "Counties",
            "type": "array",
            "description": "Counties to search, as \"County, ST\": \"Miami-Dade, FL\", \"Franklin County, Ohio\", \"St. Joseph, IN\", \"Plaquemines Parish, LA\". The state can be left out when it's set under States or the name is unique. You can also paste a RealAuction portal address (\"hillsborough.realtaxdeed.com\" or its URL) to search only that portal. Leave empty to search every county in the selected states.",
            "items": {
              "type": "string"
            }
          },
          "states": {
            "title": "States",
            "type": "array",
            "description": "Search every covered county in these states. Used when Counties is empty; leave both empty to search all states. Coverage: Florida (foreclosure and tax deed, most counties), Ohio (sheriff sales, all 88 counties), Indiana (sheriff and tax sales, most counties), Texas (tax foreclosure sales), Pennsylvania (sheriff sales), Colorado (foreclosure, treasurer's deed and tax lien sales), plus some counties in LA, MI, TN, WA, CA, ID, AZ, NJ and NY.",
            "items": {
              "type": "string",
              "enum": [
                "FL",
                "OH",
                "IN",
                "TX",
                "PA",
                "CO",
                "LA",
                "MI",
                "TN",
                "WA",
                "CA",
                "ID",
                "AZ",
                "NJ",
                "NY",
                "AL",
                "IA"
              ],
              "enumTitles": [
                "Florida",
                "Ohio",
                "Indiana",
                "Texas",
                "Pennsylvania",
                "Colorado",
                "Louisiana",
                "Michigan",
                "Tennessee",
                "Washington",
                "California",
                "Idaho",
                "Arizona",
                "New Jersey",
                "New York",
                "Alabama",
                "Iowa"
              ]
            },
            "default": []
          },
          "auctionTypes": {
            "title": "Auction types",
            "type": "array",
            "description": "Foreclosure: court-ordered foreclosure and sheriff sales, with case number, judgment amount, opening bid and assessed value; Indiana and Louisiana rows also have the plaintiff and defendant. Tax deed, tax sale and tax lien: properties with delinquent property taxes, with opening or minimum bid and (where published) the owner.",
            "items": {
              "type": "string",
              "enum": [
                "foreclosure",
                "taxSale",
                "taxDeed",
                "taxLien",
                "taxCertificate",
                "adjudicated",
                "blighted",
                "redemption"
              ],
              "enumTitles": [
                "Foreclosure (sheriff sale)",
                "Tax sale",
                "Tax deed sale",
                "Tax lien sale",
                "Tax certificate sale",
                "Adjudicated property sale",
                "Blighted property sale",
                "Redemption"
              ]
            },
            "default": [
              "foreclosure",
              "taxSale",
              "taxDeed",
              "taxLien"
            ]
          },
          "dateFrom": {
            "title": "Auctions from",
            "pattern": "^(\\d{4}-(0[1-9]|1[0-2])-(0[1-9]|[12]\\d|3[01]))?$",
            "type": "string",
            "description": "First auction date to include (YYYY-MM-DD). Defaults to today. Use a past date to get past sales with their result (sold to plaintiff or third party, winning bid where published, cancelled, redeemed)."
          },
          "dateTo": {
            "title": "Auctions until",
            "pattern": "^(\\d{4}-(0[1-9]|1[0-2])-(0[1-9]|[12]\\d|3[01]))?$",
            "type": "string",
            "description": "Last auction date to include (YYYY-MM-DD). Leave empty for every scheduled auction; RealAuction counties (FL, OH, TX, PA and others) are then read up to the end of the second month after Auctions from, which covers what counties have posted."
          },
          "skipCancelled": {
            "title": "Skip cancelled and redeemed sales",
            "type": "boolean",
            "description": "Leave out properties no longer for sale: cancelled, redeemed (the owner paid), withdrawn or stopped by bankruptcy.",
            "default": false
          },
          "maxResults": {
            "title": "Max results",
            "minimum": 0,
            "type": "integer",
            "description": "Maximum properties saved, earliest auctions first. Set to 0 for no limit.",
            "default": 1000
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}