{
  "openapi": "3.0.1",
  "info": {
    "title": "PropertyRoom Scraper - Police Auction Lots & Consignors",
    "description": "From $0.90 per 1,000 rows, no start fee. Every lot on PropertyRoom, the auctioneer for US police and municipal seized property: live bid, bid count, close time, condition, photos, and the consignor's name, phone and email. By category, consignor, keyword or lot ID.",
    "version": "0.1",
    "x-build-id": "r9WWFCWaoGb9KIEQo"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/scrapersdelight~propertyroom-lot-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-scrapersdelight-propertyroom-lot-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~propertyroom-lot-scraper/runs": {
      "post": {
        "operationId": "runs-sync-scrapersdelight-propertyroom-lot-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~propertyroom-lot-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-scrapersdelight-propertyroom-lot-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": {
          "source": {
            "title": "Where to enumerate lots from",
            "enum": [
              "catalogue",
              "sitemap"
            ],
            "type": "string",
            "description": "CATALOGUE reads list pages of 40 lots that already show each lot's price, bids and close time, so filters and sorts cost nothing per lot and a capped run in closing-soonest order stops after a few pages. SITEMAP reads the full lot census in one request, then opens lot pages most-recently-active first; filters are judged on each lot page (a rejected lot is never charged), and sortBy is not applied because the sitemap carries nothing to sort on. Categories are ignored in sitemap mode.",
            "default": "catalogue"
          },
          "categories": {
            "title": "Categories",
            "type": "array",
            "description": "Category slugs or PropertyRoom URLs, OR-ed. Top level with the lot count measured on 2026-10-27: jewelry (4,219) · coins (1,469) · collectibles (1,305) · everything-else (1,293) · electronics (971) · tools-and-equipment (724) · fashion (681) · watches (466) · fine-art (214) · musical-instruments (151) · computers (125) · sunglasses-and-eyewear (107) · vehicles (36) · bikes (4) · propertyroom (1,276, the police and agency lots). Sub-category slugs work too — copy them from any /c/ URL, e.g. \"jewelry_diamond-jewelry\" or \"coins_precious-metal_silver\" — and so do /cc/ collections (\"/cc/rings\"), /shopkeeper/ consignor URLs, /s/ search URLs and /l/ lot URLs, each read as what it is. Leave empty for every lot (\"all\").",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "consignors": {
            "title": "Consignors",
            "type": "array",
            "description": "PropertyRoom consignor (\"ShopKeeper\") pages to read, OR-ed: the slug or URL of a /shopkeeper/ page (\"gc-pawn\", \"https://www.propertyroom.com/shopkeeper/cove-collectibles\") or the shop name (\"GC Pawn\"). \"property-room\" is PropertyRoom's own account, which sells for its police and agency clients. Each consignor page also carries the contact block that fills sellerName, sellerPhone and sellerEmail. Combined with Categories, both are read.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "lotIds": {
            "title": "Specific lot IDs",
            "type": "array",
            "description": "Re-check known lots and skip every list: the lot ID (the number at the end of a listing URL, e.g. \"18997469\") or the whole /l/ URL. This is how to get final prices: a lot page stays readable after the lot closes. IDs that do not exist are listed in RUN_SUMMARY.notFound and not charged. Overrides Categories and Consignors.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "listingStatus": {
            "title": "Listing status",
            "enum": [
              "any",
              "open",
              "scheduled",
              "closed"
            ],
            "type": "string",
            "description": "OPEN lots take bids now. SCHEDULED lots are announced (\"Coming Soon\") with a price and a close date but cannot be bid on yet. CLOSED lots are past their close time; PropertyRoom drops them from its browse pages, so \"closed\" reads the sitemap, which keeps only lots closed since its last daily rebuild (about 1 in 40 sitemap lots on 2026-10-27). For the final price of lots you are watching, put their IDs in Lot IDs instead.",
            "default": "any"
          },
          "auctionFormats": {
            "title": "Auction format",
            "type": "array",
            "description": "Keep only these formats. Leave empty for all four. The browse catalogue on 2026-10-27 showed Auction, Fixed Price (\"Buy Now\") and Reserve Auction lots.",
            "items": {
              "type": "string",
              "enum": [
                "Auction",
                "Reserve Auction",
                "Fixed Price",
                "Bid to be Approved Auction"
              ]
            },
            "default": []
          },
          "bidState": {
            "title": "Bidding activity",
            "enum": [
              "any",
              "noBidsYet",
              "hasBids"
            ],
            "type": "string",
            "description": "A lot with no bids still shows a price — that is its opening ask, not a bid, and bidCount tells the two apart. Fixed-price lots never carry bids.",
            "default": "any"
          },
          "minCurrentPrice": {
            "title": "Minimum current price (USD)",
            "minimum": 0,
            "type": "integer",
            "description": "Keep only lots at or above this price."
          },
          "maxCurrentPrice": {
            "title": "Maximum current price (USD)",
            "minimum": 0,
            "type": "integer",
            "description": "Keep only lots at or below this — the bargain filter. Combine with \"No bids yet\" to find lots nobody has touched."
          },
          "maxBidCount": {
            "title": "Maximum bid count",
            "minimum": 0,
            "type": "integer",
            "description": "Skip lots that already have a bidding war on them. 0 is the same as \"No bids yet\"."
          },
          "closingWithinHours": {
            "title": "Closing within N hours",
            "minimum": 1,
            "type": "integer",
            "description": "Keep only lots whose countdown is under this many hours — the \"what can I still win today\" filter. Read from PropertyRoom's own countdown, so it costs nothing to apply."
          },
          "titleContains": {
            "title": "Title contains",
            "type": "array",
            "description": "Keep only lots whose title contains one of these words (case-insensitive), e.g. [\"rolex\", \"14k\", \"macbook\"]. OR-ed. With no categories or consignors, each word is looked up through PropertyRoom's own search and the title check is applied to the hits; with categories, it filters those categories.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "sortBy": {
            "title": "Sort by",
            "enum": [
              "endingSoonest",
              "endingLatest",
              "priceLowest",
              "priceHighest",
              "mostBids",
              "newestListed",
              "asListed"
            ],
            "type": "string",
            "description": "Ending-soonest means soonest among lots that are still OPEN; closed lots follow, most recently closed first. Every sort other than Ending-soonest and As-listed reads every page of the lists you chose before ordering them (in sitemap mode no sort is applied).",
            "default": "endingSoonest"
          },
          "maxLots": {
            "title": "Maximum lots",
            "minimum": 1,
            "maximum": 20000,
            "type": "integer",
            "description": "Hard cap on rows delivered AND charged. You are charged once per delivered row and nothing else. The whole browse catalogue was 10,790 lots on 2026-10-27, so 20000 covers everything.",
            "default": 50
          },
          "fetchDetails": {
            "title": "Fetch full lot details",
            "type": "boolean",
            "description": "ON (the default): one lot-page read per delivered lot buys the description, condition, item number, category path, minimum next bid, increment, watchers, bidders, high bidder's city, reserve state, shipping options and weight — and the consignor's name, phone and email. OFF: much faster and lighter, but 25 fields come back null at the same price per row. Only worth turning off for a pure price sweep.",
            "default": true
          },
          "includeClientAgencies": {
            "title": "Also write PropertyRoom's client-agency roster",
            "type": "boolean",
            "description": "Writes a CLIENT_AGENCIES record holding the 45 law-enforcement and municipal clients PropertyRoom names on its /about-us/partners page (against the 4,300+ it claims) plus the five that publish their own auction page. IMPORTANT: this is a SITE-WIDE list and is NOT joinable to a lot — a listing never names its consigning agency. Costs two extra page reads per run.",
            "default": true
          },
          "concurrency": {
            "title": "Parallel requests",
            "minimum": 1,
            "maximum": 12,
            "type": "integer",
            "description": "Pages in flight at once.",
            "default": 8
          },
          "proxyConfiguration": {
            "title": "Proxy",
            "type": "object",
            "description": "PropertyRoom sits behind CloudFront. Measured 2026-10-27 over 8 fresh sessions each: Apify RESIDENTIAL with country US returned the page 8 of 8 times on list and lot pages; Apify's shared DATACENTER pool 3 of 8 and 2 of 8 (the rest HTTP 403). RESIDENTIAL + US is therefore the default. A request your proxy cannot get through is retried on the other exits before it counts as unreachable.",
            "default": {
              "useApifyProxy": true,
              "apifyProxyGroups": [
                "RESIDENTIAL"
              ],
              "apifyProxyCountry": "US"
            }
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}