{
  "openapi": "3.0.1",
  "info": {
    "title": "MaxSold Scraper — Estate Auction Lots, Bids & Alerts",
    "description": "Scrape MaxSold estate & downsizing auctions — items, current bids, photos & pickup info — by state or auction. No login or API key. Schedule it as a new-lot monitor with Slack, email & webhook alerts. $3 per 1,000 items.",
    "version": "0.1",
    "x-build-id": "uSfxpflF3tK8XoZ9p"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/scrapersdelight~maxsold-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-scrapersdelight-maxsold-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~maxsold-scraper/runs": {
      "post": {
        "operationId": "runs-sync-scrapersdelight-maxsold-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~maxsold-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-scrapersdelight-maxsold-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": {
          "searchType": {
            "title": "Search type",
            "enum": [
              "discover",
              "auctions",
              "keywords"
            ],
            "type": "string",
            "description": "How to find lots. 'Discover by state / province' opens every auction MaxSold lists in the states you give (or in the whole country when States is empty). 'Specific auction IDs' opens the auctions you list. 'Keyword lot search' runs MaxSold's own lot search across all auctions (set Search queries).",
            "default": "discover"
          },
          "states": {
            "title": "States / provinces",
            "type": "array",
            "description": "US states or Canadian provinces, e.g. new-york, california, texas, ontario, british-columbia (names, the maxsold.com/usa/<state> spelling or two-letter codes all work). Auctions are matched on the sale's own state. Leave empty for the whole country. In keyword search, narrows the matching lots to these states.",
            "items": {
              "type": "string"
            }
          },
          "auctionIds": {
            "title": "Auction IDs",
            "type": "array",
            "description": "Specific MaxSold auction IDs (the number in maxsold.com/auction/<ID>/bidgallery) or full auction URLs. Used when Search type = Specific auction IDs. Closed auctions work too (final bids).",
            "items": {
              "type": "string"
            }
          },
          "searchQueries": {
            "title": "Search queries",
            "type": "array",
            "description": "Keywords for MaxSold's lot search across every auction, e.g. furniture, jewelry, tools, lamp. Each query is paged separately; a lot found by two queries is returned once. MaxSold's search matches by meaning, so try a few phrasings (\"wrist watch\" finds lots that \"watches\" does not). Giving queries with Search type = Discover runs a keyword search.",
            "items": {
              "type": "string"
            }
          },
          "country": {
            "title": "Country",
            "enum": [
              "usa",
              "canada",
              "all"
            ],
            "type": "string",
            "description": "Which MaxSold country to search when States is empty (discover and keyword search). MaxSold runs most of its auctions in Canada.",
            "default": "usa"
          },
          "lotStatus": {
            "title": "Lot status",
            "enum": [
              "open",
              "closed"
            ],
            "type": "string",
            "description": "'Open' = live auctions with current bids. 'Closed' = sold lots with their final bids: discover returns the auctions that closed in about the last 90 days; keyword search returns MaxSold's top 500 sold matches across its whole history.",
            "default": "open"
          },
          "sortBy": {
            "title": "Keyword search order",
            "enum": [
              "relevance",
              "closing_soonest",
              "closing_latest"
            ],
            "type": "string",
            "description": "Order of keyword-search results: best match first, or by lot closing time.",
            "default": "relevance"
          },
          "scrapeItems": {
            "title": "Scrape item lots",
            "type": "boolean",
            "description": "Output one row per ITEM lot (title, current bid, lot #, photos, pickup) by opening each auction. Turn OFF to output one row per AUCTION instead (discover and auction-ID modes).",
            "default": true
          },
          "includeBidHistory": {
            "title": "Include bid history",
            "type": "boolean",
            "description": "Add each lot's anonymous bid history (time, amount, proxy-bid flag - no bidder names) as bid_history. Opens each lot that has bids, so larger runs take longer.",
            "default": false
          },
          "maxAuctions": {
            "title": "Max auctions per run",
            "minimum": 0,
            "type": "integer",
            "description": "Cap on how many auctions to open this run (0 = unlimited). Auctions are opened closing-soonest first.",
            "default": 20
          },
          "maxItems": {
            "title": "Max items per run",
            "minimum": 0,
            "type": "integer",
            "description": "Cap on rows returned this run (0 = unlimited). In monitor mode it caps the new lots returned per run.",
            "default": 100
          },
          "monitorMode": {
            "title": "Monitor mode (new-lot watcher)",
            "type": "boolean",
            "description": "Recurring watcher: remember the lots returned for this search and output/alert ONLY lots not returned before. Pair with an Apify Schedule.",
            "default": false
          },
          "alertOnNewLot": {
            "title": "Alert on new lots",
            "type": "boolean",
            "description": "In monitor mode, deliver an alert for each newly-listed lot via the channels below.",
            "default": true
          },
          "webhookUrl": {
            "title": "Webhook URL",
            "type": "string",
            "description": "POST endpoint for new-lot alert payloads (Make / Zapier / n8n / custom)."
          },
          "slackWebhookUrl": {
            "title": "Slack webhook URL",
            "type": "string",
            "description": "Slack incoming-webhook URL for formatted new-lot cards."
          },
          "emailRecipients": {
            "title": "Email recipients",
            "type": "array",
            "description": "Email addresses for the new-lot digest (sent via apify/send-mail).",
            "items": {
              "type": "string"
            }
          },
          "proxyConfiguration": {
            "title": "Proxy",
            "type": "object",
            "description": "Optional. MaxSold's data answers direct requests, so no proxy is needed; if a request is refused the actor retries through a residential proxy on its own. A proxy you set here is tried first.",
            "default": {
              "useApifyProxy": false
            }
          },
          "requestConcurrency": {
            "title": "Request concurrency",
            "minimum": 1,
            "maximum": 10,
            "type": "integer",
            "description": "Max parallel requests (auctions opened at once, and lots at once for bid history / keyword search).",
            "default": 4
          },
          "diagnose": {
            "title": "Diagnostic mode (dev)",
            "type": "boolean",
            "description": "Dev only. Dumps raw sale-list + auction JSON to the key-value store (DEBUG_BROWSE / DEBUG_AUCTION) and logs the parsed shapes, then exits.",
            "default": 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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}