{
  "openapi": "3.0.1",
  "info": {
    "title": "IronPlanet Scraper - Heavy Equipment Lots & Serials",
    "description": "From $1.30 per 1,000 rows, no start fee. Every IronPlanet and Marketplace-E lot: year, make, model, meter reading, price and whether it is a bid or an ask, IronClad flag, inspection location with coordinates, sale date, features, serial or VIN. 17,178 counted; GovPlanet and Ritchie Bros excluded.",
    "version": "0.1",
    "x-build-id": "7ndVD37n2CrFrhfmZ"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/scrapersdelight~ironplanet-lot-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-scrapersdelight-ironplanet-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~ironplanet-lot-scraper/runs": {
      "post": {
        "operationId": "runs-sync-scrapersdelight-ironplanet-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~ironplanet-lot-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-scrapersdelight-ironplanet-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": {
          "marketplaces": {
            "title": "Marketplaces",
            "type": "array",
            "description": "Which ironplanet.com marketplaces to collect. IronPlanet = the weekly online auctions; Marketplace-E = the Buy Now / Make Offer marketplace on the same site. The sibling RB Global marketplaces syndicated into the same search index (GovPlanet, Ritchie Bros. Auctioneers, TruckPlanet, SalvageSale) are hard-excluded and are not offered here - they are separate sites with their own catalogues.",
            "items": {
              "type": "string",
              "enum": [
                "IronPlanet",
                "Marketplace-E"
              ]
            },
            "default": [
              "IronPlanet",
              "Marketplace-E"
            ]
          },
          "make": {
            "title": "Make",
            "type": "string",
            "description": "Manufacturer filter, applied server-side by IronPlanet's own Make facet. Use the site's spelling, e.g. Cat, John Deere, Komatsu, Volvo, JLG, Genie, Link-Belt. Leave empty for every make."
          },
          "location": {
            "title": "Location",
            "type": "string",
            "description": "Location filter in IronPlanet's own code, applied server-side: USA-TX, USA-CA, USA-FL, CAN-AB, CAN-ON and so on. Leave empty for every location."
          },
          "yearBand": {
            "title": "Model year band",
            "enum": [
              "2020-2024",
              "2015-2019",
              "2010-2014",
              "2000-2009",
              "before-2000"
            ],
            "type": "string",
            "description": "Model-year band, applied server-side. These five bands are the ones IronPlanet publishes; a free-form year range is not supported by the site."
          },
          "priceBand": {
            "title": "Price band (USD)",
            "enum": [
              "under-1000",
              "1000-4999",
              "5000-9999",
              "10000-49999",
              "50000-99999",
              "100000-499999",
              "500000-plus"
            ],
            "type": "string",
            "description": "US-dollar price band, applied server-side. Bands are IronPlanet's own; items priced in CAD, EUR or GBP are not matched by this filter."
          },
          "buyingFormat": {
            "title": "Buying format",
            "enum": [
              "online-auction",
              "buy-now"
            ],
            "type": "string",
            "description": "Restrict to one buying format, applied server-side. Leave empty for both."
          },
          "ironCladOnly": {
            "title": "IronClad Assurance only",
            "type": "boolean",
            "description": "Keep only lots carrying IronPlanet's IronClad Assurance inspection guarantee. Applied server-side. Measured on the live catalogue: 2,750 of 4,328 IronPlanet lots carry it.",
            "default": false
          },
          "keyword": {
            "title": "Keyword",
            "type": "string",
            "description": "Free-text search, applied server-side by IronPlanet's own search box. Narrows the result set before it is fetched, so it costs nothing extra."
          },
          "sort": {
            "title": "Result order",
            "enum": [
              "sale-date-asc",
              "sale-date-desc",
              "price-asc",
              "price-desc"
            ],
            "type": "string",
            "description": "Order IronPlanet returns results in. These four are the only orderings the site sorts deterministically - its default relevance order is unstable between requests, so a deep sweep under it both repeats and silently skips lots. One of these is always applied.",
            "default": "sale-date-asc"
          },
          "pageConcurrency": {
            "title": "Result-page concurrency",
            "minimum": 1,
            "maximum": 4,
            "type": "integer",
            "description": "How many 60-lot result pages to fetch at once. All of them ride one pinned proxy session, because IronPlanet holds the ordered result set per session - capped at 4, which is the highest rate measured returning every row with no duplicates.",
            "default": 3
          },
          "includeDetails": {
            "title": "Fetch item pages for serial numbers and exact meters",
            "type": "boolean",
            "description": "Fetch each lot's item page to add the serial number / VIN, the exact meter reading, the watcher count, the auction close timestamp, the full city-and-state inspection location, the bid increment and the category breadcrumb. These are not on the search tile. Item pages are ~430 KB each, so a run with this on is roughly 50x the bytes of one without - the row price is the same either way. Off by default.",
            "default": false
          },
          "maxItems": {
            "title": "Maximum lots",
            "minimum": 1,
            "maximum": 50000,
            "type": "integer",
            "description": "Stop after this many delivered rows. You are charged per delivered row, so this is your budget cap. 0 is not accepted - use a large number for the whole catalogue (about 4,300 IronPlanet lots and 12,800 Marketplace-E lots as measured on 2026-09-18).",
            "default": 200
          },
          "maxPages": {
            "title": "Maximum pages per marketplace",
            "minimum": 0,
            "maximum": 1000,
            "type": "integer",
            "description": "Optional hard stop on how many 60-lot result pages to fetch per marketplace, regardless of the row cap. 0 means no page limit.",
            "default": 0
          },
          "detailConcurrency": {
            "title": "Item-page concurrency",
            "minimum": 1,
            "maximum": 10,
            "type": "integer",
            "description": "How many item pages to fetch at once when 'Fetch item pages' is on. Higher is faster but leans harder on the proxy pool.",
            "default": 5
          },
          "monitorMode": {
            "title": "Monitor mode",
            "type": "boolean",
            "description": "Emit only lots that are new since the previous run, or whose price has changed, tagged with changeType. State is kept in a named key-value store so it survives between runs. The first run seeds the state and emits everything it sees.",
            "default": false
          },
          "proxyConfiguration": {
            "title": "Proxy",
            "type": "object",
            "description": "Apify proxy settings. ironplanet.com sits behind an AWS WAF and this Actor needs a proxy to reach it reliably, so the datacenter pool is pinned here as a default rather than a prefill - an empty input still gets it. The last rung of the Actor's fallback ladder additionally uses the UNBLOCKER group when your account has it.",
            "default": {
              "useApifyProxy": true,
              "apifyProxyGroups": [
                "BUYPROXIES94952"
              ]
            }
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}