{
  "openapi": "3.0.1",
  "info": {
    "title": "Auction.com Scraper — Foreclosure & REO Listings",
    "description": "[💰 $0.95 / 1K] Extract foreclosure, bank-owned and private-seller auction listings from Auction.com. Opening bids, sale dates, valuations, occupancy, photos and disclosure documents, with GPS coordinates on every row. Filter by state, city, sale type or property type, or paste a search URL.",
    "version": "1.0",
    "x-build-id": "BA5fbEVVGyxiX4X6a"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/solidcode~auction-com-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-solidcode-auction-com-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/solidcode~auction-com-scraper/runs": {
      "post": {
        "operationId": "runs-sync-solidcode-auction-com-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/solidcode~auction-com-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-solidcode-auction-com-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": {
          "searchUrls": {
            "title": "Search URLs",
            "type": "array",
            "description": "Auction.com search result URLs. Set your filters on Auction.com, then paste the address bar URL from your browser — for example https://www.auction.com/residential/IL/Chicago_ct/active_lt. State, city, county, ZIP code, sale type, property type, listing status, occupancy, opening-bid range, square footage, bedrooms, bathrooms and year built are all read from the URL and applied. Sort order and the map/nearby settings are not: those parts of a URL are ignored, and the run log names every setting it could not apply. A pasted URL replaces the filters below for that search, and you can paste several URLs to run several searches in one go.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "state": {
            "title": "State",
            "enum": [
              "",
              "AL",
              "AK",
              "AZ",
              "AR",
              "CA",
              "CO",
              "CT",
              "DE",
              "DC",
              "FL",
              "GA",
              "HI",
              "ID",
              "IL",
              "IN",
              "IA",
              "KS",
              "KY",
              "LA",
              "ME",
              "MD",
              "MA",
              "MI",
              "MN",
              "MS",
              "MO",
              "MT",
              "NE",
              "NV",
              "NH",
              "NJ",
              "NM",
              "NY",
              "NC",
              "ND",
              "OH",
              "OK",
              "OR",
              "PA",
              "RI",
              "SC",
              "SD",
              "TN",
              "TX",
              "UT",
              "VT",
              "VA",
              "WA",
              "WV",
              "WI",
              "WY",
              "PR",
              "VI"
            ],
            "type": "string",
            "description": "Only return listings in this state. Covers all 50 states plus DC, Puerto Rico and the U.S. Virgin Islands.",
            "default": ""
          },
          "city": {
            "title": "City",
            "type": "string",
            "description": "Only return listings in this city, e.g. \"Chicago\" or \"Los Angeles\". Matched exactly against the city on the listing (capitalisation does not matter), so set State too when a city name exists in more than one state."
          },
          "zipCode": {
            "title": "ZIP code",
            "type": "string",
            "description": "Only return listings in this 5-digit ZIP code, e.g. \"60620\"."
          },
          "county": {
            "title": "County",
            "type": "string",
            "description": "Only return listings in this county. Enter the name without the word \"County\", e.g. \"Cook\" or \"Los Angeles\". Set State too — county names repeat across states."
          },
          "saleType": {
            "title": "Sale type",
            "enum": [
              "",
              "FORECLOSURE",
              "BANK_OWNED",
              "PRIVATE_SELLER"
            ],
            "type": "string",
            "description": "Only return one kind of sale. Foreclosure covers trustee and sheriff sales; bank owned covers lender-owned (REO) property.",
            "default": ""
          },
          "propertyType": {
            "title": "Property type",
            "enum": [
              "",
              "SINGLE_FAMILY",
              "CONDOS_AND_TOWNHOUSES",
              "MULTI_FAMILY",
              "LAND"
            ],
            "type": "string",
            "description": "Only return one category of property.",
            "default": ""
          },
          "listingStatus": {
            "title": "Listing status",
            "enum": [
              "",
              "ACTIVE",
              "PENDING",
              "SOLD",
              "INACTIVE",
              "CANCELED"
            ],
            "type": "string",
            "description": "Only return listings at this stage. Choose Active for auctions open right now; the default returns current and past listings together.",
            "default": ""
          },
          "occupancy": {
            "title": "Occupancy",
            "enum": [
              "",
              "VACANT",
              "OCCUPIED",
              "UNKNOWN"
            ],
            "type": "string",
            "description": "Only return listings with this occupancy status. Vacant property can usually be accessed sooner after closing.",
            "default": ""
          },
          "minOpeningBid": {
            "title": "Minimum opening bid (USD)",
            "minimum": 0,
            "type": "integer",
            "description": "Only return listings whose opening bid is at least this amount. Auction.com does not publish an opening bid for every listing, so some matching listings arrive with an empty opening bid."
          },
          "maxOpeningBid": {
            "title": "Maximum opening bid (USD)",
            "minimum": 0,
            "type": "integer",
            "description": "Only return listings whose opening bid is at most this amount."
          },
          "minBedrooms": {
            "title": "Minimum bedrooms",
            "minimum": 0,
            "maximum": 20,
            "type": "integer",
            "description": "Only return listings with at least this many bedrooms. Listings where Auction.com has no bedroom count are excluded when this is set."
          },
          "minBathrooms": {
            "title": "Minimum bathrooms",
            "minimum": 0,
            "maximum": 20,
            "type": "number",
            "description": "Only return listings with at least this many bathrooms."
          },
          "maxItems": {
            "title": "Max results",
            "minimum": 0,
            "type": "integer",
            "description": "Maximum listings per search URL (0 = collect everything each search returns). Auction.com pages through at most 3,000,000 listings per search, so use several narrower searches to collect more.",
            "default": 100
          },
          "concurrency": {
            "title": "Concurrency",
            "minimum": 1,
            "maximum": 10,
            "type": "integer",
            "description": "How many requests to run in parallel. Lower this if you see failures.",
            "default": 8
          },
          "proxyConfiguration": {
            "title": "Proxy configuration",
            "type": "object",
            "description": "Proxy settings for the run.",
            "default": {
              "useApifyProxy": true
            }
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}