{
  "openapi": "3.0.1",
  "info": {
    "title": "Ritchie Bros Scraper — Heavy Equipment Auctions",
    "description": "Scrape auction listings and results from RitchieBros.com (RB Auction), the world's largest industrial auctioneer. Extract hammer prices, lot details, make, model, year, hours, location, and photos. Track equipment values across construction, agriculture, and transportation.",
    "version": "1.0",
    "x-build-id": "2pLeYcWJ0oPlhjGIK"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/rastriq~rbauction-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-rastriq-rbauction-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/rastriq~rbauction-scraper/runs": {
      "post": {
        "operationId": "runs-sync-rastriq-rbauction-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/rastriq~rbauction-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-rastriq-rbauction-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": {
          "keywords": {
            "title": "Search keywords",
            "type": "string",
            "description": "Search across all equipment fields — description, manufacturer, model, features.<br><br>Examples:<br><code>excavator caterpillar 320</code><br><code>wheel loader</code><br><code>dump truck 2022</code><br><br>Leave empty to get all listings matching the filters below."
          },
          "listingStatuses": {
            "title": "Listing status",
            "type": "array",
            "description": "Which listings to include:<br>• <b>New / Preview / Open</b> — currently available for bidding or purchase<br>• <b>Sold</b> — completed sales with final hammer prices<br><br>💡 Select only <b>Sold</b> for price history and market intelligence.",
            "items": {
              "type": "string",
              "enum": [
                "New",
                "Preview",
                "Open",
                "Sold"
              ]
            },
            "default": [
              "New",
              "Preview",
              "Open",
              "Sold"
            ]
          },
          "maxPages": {
            "title": "Max pages to scrape",
            "minimum": 1,
            "maximum": 50000,
            "type": "integer",
            "description": "How many pages of results to collect (50 items per page).<br><br>• <b>1 page</b> = 50 items (quick test, ~10 seconds)<br>• <b>20 pages</b> = 1,000 items<br>• <b>200 pages</b> = 10,000 items<br>• <b>500 pages</b> = 25,000 items (~45 min, ~$0.28)",
            "default": 3
          },
          "industry": {
            "title": "Industry",
            "enum": [
              "",
              "380FB0EC-CB7C-3BEA-9FDA-11A46A5176AC",
              "EBE7DB97-F10C-33C2-98FA-789F4B4C94FC",
              "67FFEC94-F445-32E1-B437-A854F8CCADCA",
              "38397D59-BE2B-3A1B-9C7E-32DA48C1BCCE",
              "45AFC681-DF36-3EA8-8056-AAD0F272CE7B",
              "1708CF51-0351-3AAB-A1A5-8BB442DBF1DD",
              "B438650B-3731-3CB1-B066-9DCADF164343",
              "8DDE489B-CC3D-35AD-83EF-52ECA3516ED6",
              "F5AB5440-BA9E-3AFD-9788-9C66C41B1A99",
              "CD19801C-3C73-3D9F-BE0C-B9D55E3CFE0F",
              "013F76DB-B8BB-3976-9200-D6A6A4EC2948",
              "0C90D306-769A-361E-B9BB-F53E3154C0E2",
              "58A68EDE-6B93-3137-B3DC-D1132BDFE405",
              "1AAA6B4E-6EEA-3F75-9109-E270BF2DCC6D"
            ],
            "type": "string",
            "description": "Filter by equipment industry. Leave on <b>All</b> to include everything.",
            "default": ""
          },
          "categoryName": {
            "title": "Category",
            "type": "string",
            "description": "Type the equipment category exactly as shown on Ritchie Bros (case doesn't matter).<br><br>Examples: <code>Excavators</code>, <code>Truck Tractors</code>, <code>Forklifts</code>, <code>Generators and Power Equipment</code>, <code>Scissor Lifts</code>, <code>Compact Track Loaders</code>, <code>Pickup Trucks</code><br><br>Leave empty for all categories."
          },
          "manufacturerName": {
            "title": "Manufacturer",
            "type": "string",
            "description": "Type the manufacturer name as it appears on Ritchie Bros.<br><br>Examples: <code>Cat</code>, <code>John Deere</code>, <code>Komatsu</code>, <code>Volvo</code>, <code>Bobcat</code>, <code>Kubota</code>, <code>Freightliner</code>, <code>Peterbilt</code><br><br>⚠️ Use <code>Cat</code> (not Caterpillar). Leave empty for all."
          },
          "modelName": {
            "title": "Model",
            "type": "string",
            "description": "Type the model name. Works best when <b>Manufacturer</b> is also set.<br><br>Examples: <code>320</code>, <code>D6</code>, <code>PC200</code>, <code>L120</code><br><br>Leave empty for all models of the selected manufacturer."
          },
          "manufactureYearRange_min": {
            "title": "Min year",
            "minimum": 1900,
            "type": "integer",
            "description": "Only include equipment manufactured in this year or later."
          },
          "manufactureYearRange_max": {
            "title": "Max year",
            "type": "integer",
            "description": "Only include equipment manufactured in this year or earlier."
          },
          "country": {
            "title": "Country / Region",
            "enum": [
              "",
              "USA",
              "CAN",
              "EUR",
              "AUO",
              "MEX",
              "MID",
              "ASI",
              "CSA",
              "AFR"
            ],
            "type": "string",
            "description": "Where the equipment is physically located.",
            "default": ""
          },
          "subRegion": {
            "title": "Sub-region",
            "enum": [
              "",
              "US-SOU",
              "US-WES",
              "US-NRE",
              "US-MDW",
              "CA-PRA",
              "CA-CEN",
              "CA-WEC",
              "CA-MAR",
              "FRA",
              "ITA",
              "GBR",
              "NLD",
              "ESP",
              "DEU",
              "BEL",
              "POL",
              "SWE",
              "AUS",
              "NZL"
            ],
            "type": "string",
            "description": "Narrow within the selected country/region above.",
            "default": ""
          },
          "buyingPlatform": {
            "title": "Platform",
            "enum": [
              "",
              "Ritchie Bros. Auctioneers",
              "GovPlanet",
              "IronPlanet",
              "Marketplace-E",
              "TruckPlanet",
              "SalvageSale"
            ],
            "type": "string",
            "description": "Which Ritchie Bros platform to search.",
            "default": ""
          },
          "buyingFormat": {
            "title": "Buying format",
            "enum": [
              "",
              "Timed Auction",
              "Live Auction",
              "Make Offer",
              "Sealed Bid",
              "Buy Now"
            ],
            "type": "string",
            "description": "How the equipment is being sold.",
            "default": ""
          },
          "fetchDetails": {
            "title": "Sold prices & inspection data",
            "type": "boolean",
            "description": "Enrich each listing with:<br>• <b>Sold price</b> — final hammer price (for sold items)<br>• <b>Estimated price</b><br>• <b>Inspection rating</b> — Very Good / Good / Fair / Poor<br>• <b>Photos</b> — up to 10 inspection photos<br>• <b>Complete serial number</b><br><br>Adds ~200ms per item. Disable for faster runs when you only need basic listing data.",
            "default": true
          },
          "fetchBidStatus": {
            "title": "Live bid status",
            "type": "boolean",
            "description": "For active auctions, adds:<br>• <b>Current bid amount</b><br>• <b>Bid count</b><br>• <b>Next required bid</b><br>• <b>Reserve status</b><br><br>Batch endpoint — fast, ~100ms per 20 items.",
            "default": false
          },
          "fetchListingDetails": {
            "title": "Seller & location details",
            "type": "boolean",
            "description": "Adds seller info, exact GPS coordinates, subcategory, asset flags, and full photo gallery.<br><br>Batch endpoint — fast, ~100ms per 20 items.",
            "default": false
          },
          "fetchBidHistory": {
            "title": "Full bid history",
            "type": "boolean",
            "description": "Complete log of every bid placed on each listing — amount, timestamp, and anonymous bidder ID.<br><br>Per-item endpoint — adds ~200ms per item. Best combined with <b>Live bid status</b>.",
            "default": false
          },
          "sortField": {
            "title": "Sort by",
            "enum": [
              "eventEndDateTime",
              "startPrice",
              "manufactureYear",
              "usageHours"
            ],
            "type": "string",
            "description": "How to order results.",
            "default": "eventEndDateTime"
          },
          "sortOrder": {
            "title": "Sort direction",
            "enum": [
              "desc",
              "asc"
            ],
            "type": "string",
            "description": "Ascending or descending order.",
            "default": "desc"
          },
          "usageHoursRange_min": {
            "title": "Min hours",
            "minimum": 0,
            "type": "integer",
            "description": "Only include equipment with at least this many machine hours."
          },
          "usageHoursRange_max": {
            "title": "Max hours",
            "type": "integer",
            "description": "Only include equipment with fewer than this many machine hours."
          },
          "usageKilometersRange_min": {
            "title": "Min km",
            "minimum": 0,
            "type": "integer",
            "description": "Minimum odometer reading (for trucks and vehicles)."
          },
          "usageKilometersRange_max": {
            "title": "Max km",
            "type": "integer",
            "description": "Maximum odometer reading (for trucks and vehicles)."
          },
          "detailConcurrency": {
            "title": "Parallel requests",
            "minimum": 1,
            "maximum": 20,
            "type": "integer",
            "description": "How many items to process in parallel. Higher = faster but more aggressive.<br>Recommended: <b>5</b>.",
            "default": 5
          },
          "delayBetweenRequests": {
            "title": "Delay between requests (ms)",
            "minimum": 0,
            "maximum": 10000,
            "type": "integer",
            "description": "Wait time between requests in milliseconds.<br>Recommended: <b>500ms</b>. Use 200-300ms for speed, 1000+ if you see errors.",
            "default": 500
          },
          "proxyConfiguration": {
            "title": "Proxy configuration",
            "type": "object",
            "description": "Optional. Only needed for very large runs (10,000+ items)."
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}