{
"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": "jZiEdPMMnmrdTIhrr"
},
"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": {
"data_freshness": {
"title": "📡 Data source",
"enum": [
"preloaded",
"preloaded_sold",
"live"
],
"type": "string",
"description": "Choose Preloaded for instant access to pre-built monthly snapshots at a lower cost.
Active listings: current equipment for sale (~20K items).
Sold auctions: historical auction results with final prices (~1.7M items).
Choose Live to scrape the marketplace in real time.",
"default": "preloaded"
},
"runPreset": {
"title": "⚙️ Run preset",
"enum": [
"active_inventory",
"price_history",
"full_market",
"quick_test",
"custom"
],
"type": "string",
"description": "Pre-configured run modes that set optimal defaults for common use cases. Select a preset and the actor will override listing statuses, enrichment toggles, and max pages automatically.
You can still adjust individual fields after selecting a preset — manual values take priority where explicitly set.
Choose Custom to configure everything manually.",
"default": "active_inventory"
},
"maxItems": {
"title": "Max items",
"minimum": 0,
"type": "integer",
"description": "Maximum number of items to return. Set to 0 for no limit (returns all matching items).
Only applies to preloaded mode. In live mode, use Max pages instead.",
"default": 0
},
"directCategoryUrls": {
"title": "Direct category URLs",
"type": "string",
"description": "Paste one or more category URLs from the Ritchie Bros network, one per line. The actor translates each URL into the correct Category or Equipment subtype filter.
Default quick test: https://www.rbauction.com/cp/mini-excavator-6-6t
This default returns open mini excavator listings and should finish in under 1 minute with Max pages = 1."
},
"listingStatuses": {
"title": "Listing status (multi-select)",
"uniqueItems": true,
"type": "array",
"description": "Select one or more statuses:
Open - currently available for bidding or purchase.
New / Preview - upcoming or not fully open yet.
Sold - completed listings with historical sale data when available.
Tip: for active inventory ingestion, select Open. For market history, select Sold.",
"items": {
"type": "string",
"enum": [
"New",
"Preview",
"Open",
"Sold"
],
"enumTitles": [
"New",
"Preview",
"Open - active listings",
"Sold - historical results"
]
},
"default": [
"Open"
]
},
"maxPages": {
"title": "Max pages to scrape",
"minimum": 1,
"maximum": 50000,
"type": "integer",
"description": "How many pages of results to collect. Each page contains up to 50 items.
- 1 page = up to 50 items, useful for testing.
- 20 pages = up to 1,000 items.
- 200 pages = up to 10,000 items.
Only applies to live mode.",
"default": 1
},
"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": "Broad RB Auction industry. Leave on All to include every industry.",
"default": ""
},
"categories": {
"title": "Category",
"type": "array",
"description": "Optional top-level equipment category.",
"items": {
"type": "string",
"enum": [
"D2AA983E-3607-39DA-8D99-A9FD3A744D09",
"3682691A-11AF-3203-97D8-88FE34EA37B1",
"6999874F-2AEB-38FE-AF9B-1B486F00C3E5",
"232F7156-ADC8-3F44-9EB0-502BD28279CE",
"02DE24EB-6A74-3E90-BBA8-C411E4EB8A6C",
"5F735B1E-F302-3BE3-9A6D-1C66E7FE4A19",
"D415DCED-AB33-3BFE-8B40-AE7795AA5B9B",
"D39607F9-F43A-3CE7-A1FF-865A39B7A85B",
"A6DF7336-429C-303B-8FD1-3CAE4D5C7238",
"BE868F29-D499-3ED3-8161-3A1EE8DCBD7E",
"5ABA834F-00BA-3F64-B334-A2519D9F42E3",
"1274183D-73F6-3A02-A5BF-6438335BE68C",
"7EE89DF8-44A0-31F6-95D1-C4CEF7DE6945",
"95121C84-F1D9-31F1-AC86-B8EADBFBC4CA",
"63EA0E70-70AD-34DD-B6AA-FA5AD82C3625",
"2FC8B475-C69D-3E62-88BF-5A3AEF2C9388",
"2474884D-72BD-3E5D-825B-CC9F59B5CE0D",
"CB4AFC8B-4495-3F66-9F2F-DA67B4AEE627",
"8A57ED93-16EF-3EE5-A6B0-9A4B8CC88494",
"8830B4D9-109E-3FE2-B18E-AC1EE2ABF8D6",
"81F79D6B-BAC1-3195-BC82-2FB6E3D5D798",
"F07112BB-5A43-32CE-867B-FADFC06EDF2B",
"987B4CCA-4EAB-3DB6-B5E9-B1DD2E45FD29",
"13CF9E8E-7117-3BA7-8999-0F2A8C48814F",
"1AC6C221-1DDF-37A1-94E8-6F0229D8EE73",
"8EA543DC-59B0-3C91-9C0B-133E9BF889E4",
"9FA30BAF-34D5-35C0-B3E2-79E3B0F8F6F0",
"5BF65427-BC3C-366A-9091-BA60FA8EE09F",
"7424FA32-5AD0-356E-80B0-997B0EC4507E",
"54090D8D-5652-3489-B60E-E9099838A6C2",
"8D977AA1-59E6-3E6F-B2CB-D8178ACDF04B",
"B138F2FA-CA86-3119-BCF8-67F67ABB7D8A",
"D3B4F998-284D-3B22-B339-EAF5A08D97E3",
"80BAC5C0-7688-3DF1-B89F-C5B2A928393B",
"2EA229C4-C693-3421-988E-D684C6706E62",
"A55F83B5-86D5-3A61-9847-F245993A9968",
"2BE5E5A9-A14A-3D59-AE8C-676DE94C7AFD",
"95625AAE-4F6E-3114-8A95-4898E252DFAC",
"BEA47F18-A473-3222-80BD-9B88CFAE16AF",
"81761CF8-D235-3D25-8FBA-AC10224F2295",
"F2A266CD-68D1-37E2-B2A4-9D6802569EF2",
"6281326D-17AD-3051-A078-A028561ADD44",
"ADA782FD-372F-3FE7-A4C7-3AD5B4523415",
"28A905F6-1B74-3F14-9F7F-5B5186CAFA53",
"D3CF0EE7-B43C-31D5-B71E-4B01645C3CB0",
"7CDF578A-240B-3739-AF58-C979FE0252E5",
"7E195DFF-0141-33CB-9705-134B033D3A99",
"CCE55AE7-CA7D-3E4E-9DE9-1CFA84A5B63E",
"D15E37A5-E5F4-35E7-81E8-B152038B5F14",
"CE390DC9-0244-3D04-BB50-DB91CE40E201",
"C456802B-2C46-39E8-9D90-62979861064F",
"CCE80A72-BC34-31D7-A3C3-8CCCF592D45A",
"E58BF5D1-BE29-340E-8B4C-5A796BC377F4",
"3A335A2C-8E35-3FBD-A06E-D00D53CC6F80",
"0A1073D5-17C5-3D2F-9745-7EE2EDF46654"
],
"enumTitles": [
"Skid Steer Attachments",
"Parts",
"Truck Tractors",
"Tools",
"Excavator Attachments",
"Excavators",
"Shop, Warehouse and Consumer",
"Landscaping Equipment",
"Van Trailers",
"Containers",
"Portable Structures",
"Scissor Lifts",
"Pickup Trucks",
"Industrial and Construction Supplies",
"Forklifts",
"Generators and Power Equipment",
"Compact Track Loaders",
"Construction and Machinery Trailers",
"Field Gear",
"Van Trucks",
"Miscellaneous Attachments",
"Heating and Cooling Equipment",
"Construction Materials",
"Truck Parts and Attachments",
"Demolition and Recycling Attachments",
"Wheel Loaders",
"Air Compressors and Treatment Equipment",
"Livestock Equipment",
"Product and Fuel Tanks",
"Agricultural Tractors",
"Light Towers",
"Telehandlers",
"Flatbed Trucks",
"Refrigerated Trailers",
"Dump Trucks",
"Light Compaction Equipment",
"Utility Trailers",
"Service and Utility Trucks",
"Articulating Boom Lifts",
"Concrete Equipment",
"Grain Handling Equipment",
"Medical Supplies",
"Electrical Distribution Equipment",
"Skid Steer Loaders",
"Water Pumps",
"Vans",
"Waste and Recycling Equipment",
"Telescopic Boom Lifts",
"Welding Machines and Equipment",
"Flatbed Trailers",
"Vertical Mast Lifts",
"Dozers",
"Utility Vehicles",
"Dump Trailers",
"Traffic Control Devices"
]
},
"default": []
},
"assetTypes": {
"title": "Equipment subtype",
"type": "array",
"description": "Optional specific equipment subtype.",
"items": {
"type": "string",
"enum": [
"0B1DF7DE-DE24-37C8-82A7-FEA05F3AEFB6",
"52216A2B-3C44-37F1-B53D-91F1072CECE1",
"2EBC2C02-AECF-3AD0-B470-A32796D35DCD",
"F8FBCB41-B7A6-3092-B91B-7A05818C5B2D",
"3B0E28D7-BB65-318C-9DA4-C5D520F10088",
"875CBA64-22E4-38EE-BD9D-E42EFE377CDC",
"D271AA3E-B6E8-3985-873D-DEDC8BB43818",
"94D3CEF1-39ED-354E-9159-709F02D94FD3",
"3FD30DBD-610E-3312-B3EE-E0A0ECB06C2A",
"B632A682-32AD-3DFF-A66E-589BE7F9A88A",
"0BBD31DB-3E9D-38D7-9918-754891C7399C",
"0C9E9568-6CF9-3F56-965C-6C4B5DA40C35",
"12667E60-A9EA-3DF0-81A3-C2B0A1569C90",
"F47BBDF1-36E4-3C66-A2A8-56F98081EC2F",
"99BC2AE9-CDA7-3C89-AFB1-3B72C58F26E4",
"463A795A-9FDA-3FAF-95E5-E73B6F5F7FF3",
"05854342-6BD2-34C0-B865-078BE478B920",
"DA80612F-AA44-3849-B7F9-380FBAFC3CF7",
"2FEF2FD1-1003-3F2D-B0DA-AD26E36C615D",
"0AD9213B-B234-30FB-928A-D4941D7663CB",
"53A81814-CBC4-35D2-B930-919C6C53B2B4",
"F3AA750F-30ED-325E-9E9B-DFDA180690FB",
"F02E3532-3C48-3FBA-836E-7BDB2D73B7EC",
"DE7BE132-17DD-357D-B15F-D878F7A5D4CB",
"BBD53A02-30E7-30FD-B4D2-1E4C5F03D12F",
"C5C665CF-8EDD-3D2E-A9AA-764B154FD047",
"BD893232-707F-3069-82F4-D2831A735D30",
"63B5DBEB-C013-3A29-91C2-AAAFFF47D8F4",
"2ACE5635-046D-3A5A-A283-7520008AEFDF",
"0F600A39-5A51-33B8-B69C-96479F4D9CD0",
"7718E34F-20FF-327E-B64D-68C3281CD9FE",
"17E699F4-C7B4-3274-A71F-3A8EB21C993D",
"66E03EE4-B712-339D-9110-769912A05FAB",
"E21E228A-50F5-3466-B8A4-7A71C06A9A2F",
"0BFC425D-F35E-3C24-9DD0-0E08B16C6E0D",
"E75A31B2-06A2-3BAC-B649-1F7A5E084A9B",
"1A7F82F8-9214-38A1-A3EB-3114C1245ED8",
"DA433B62-D98E-3CFD-8A00-5692B89475B9",
"BC42D61E-988D-370B-A2FE-B0870092F531",
"54211AFB-6E0F-383D-B202-647DF556813E",
"318E834B-43CF-39F4-A0EF-FBAF7FEB23D0",
"F608A096-0750-3A89-BB27-E75F32B7D395",
"F22A3EA6-7E26-3E8C-BF90-FBC94A6D68AE",
"3547D5EE-6D48-3DD7-868D-A05876B9F431",
"28A01AEB-7D5F-3872-ADF4-B1D1AD12EE00",
"9D9DE63F-A70E-3B5E-8B1C-B6025718D6AD",
"2593A11F-0EB7-3F51-A5CF-989E0EC425E0",
"1800B62C-1228-3FF0-A932-88A1BC0A45E4",
"AF0CEC4D-4DF0-3AA3-974E-54C795D6218E",
"83CE5315-391B-33A8-8648-CEC4D43E4694",
"284716CA-31DD-3CF2-AB3A-C97790C9750C",
"C81BC55A-91EB-364F-B40D-FCA264CD8DF7",
"0CC7E2FB-D39D-3C3E-9385-6618C423877C",
"4F09AEEC-834A-3F04-BCC5-75647DC852AE",
"1C702E00-0DA0-3C74-B3F8-E2854718AD68",
"5A975182-7AE5-324C-AC18-634E9F53F186",
"CBD33A97-4120-3B7A-B7B1-81899BBA48F5",
"EE038B59-A39D-3845-86C0-4B2603738395",
"2C2B065D-A294-3F13-9D52-7260659DF9BD",
"6F516585-A12C-38A4-BDF9-342E9BFF39E4",
"6D77D176-2A2A-3A19-AF91-6883319BE820",
"7C43DBE5-F546-3A6E-9BC7-2C4A69527083",
"4EAF8BC9-9CF4-3D14-84F6-CD86BB494A4D",
"06608990-A591-3316-B467-5FB502976B8A",
"9596782B-8958-3DCF-858D-A9F61FBA6EC5",
"9EB59B10-2A0B-3760-82FB-21517451C93E",
"A1B89913-C372-34CD-AB12-3AC18C4EE9D1",
"6A96057D-A397-38B0-974B-23A1B4783069",
"E34F634B-0730-323A-92CF-265E906D485C",
"501F1461-B277-3A96-99EB-C3103869CE09",
"DE215792-57E1-3CC1-A345-217DB84DA885",
"AB7E3379-D78E-39FE-858E-D052C8AF33F4",
"7A140EBA-811C-3F05-B5B8-0C78102A5BB3",
"DE3AC83F-0368-3DB9-BF20-D62D463F8E63",
"B4ECC387-3F77-3654-AD0D-37ECCDE7F3A5"
],
"enumTitles": [
"Mini Excavator: <6.6t",
"T/A Sleeper Truck Tractor",
"Van Trailer",
"Scissor Lift",
"Storage Container",
"Pickup",
"Excavator Bucket",
"T/A Day Cab Truck Tractor",
"Compact Track Loader",
"Generator Set",
"Tracked Excavator",
"Van Truck",
"Skid Steer Forks",
"Skid Steer Bucket",
"Wheel Loader",
"Air Compressor",
"Light Tower",
"Telehandler",
"Forklift",
"S/A Day Cab Truck Tractor",
"Refrigerated Trailer",
"Flatbed Truck",
"Hydraulic Breaker",
"Equipment Trailer",
"Fuel Tank",
"Storage Building",
"Articulating Boom Lift",
"Pressure Washer",
"Fencing",
"Skid Steer Loader",
"Lawn Mower",
"Tires: Equipment",
"Telescopic Boom Lift",
"Skid Steer Auger",
"Space Heater",
"Workbench",
"Skid Steer Brush Cutter",
"Flatbed Trailer",
"Vertical Mast Lift",
"Cargo Van",
"Crawler Dozer",
"Vibratory Plate Compactor",
"Utility Vehicle",
"Skid Steer Mulcher",
"Skid Steer Grapple",
"Shed",
"Water Pump",
"SUV",
"Livestock Panel",
"4WD Tractor",
"Golf Cart",
"Carport",
"Electric Forklift",
"Backhoe Loader",
"Driveway Gate",
"Misc. Excavator Attachment",
"Excavator Ripper",
"Excavator Thumb",
"Excavator Rake",
"Excavator Grapple",
"Excavator Coupler",
"Excavator Auger",
"Excavator Compaction Wheel",
"Vacuum Excavator Truck",
"Wheel Excavator",
"Excavator Screening Bucket",
"Excavator Crusher Bucket",
"Excavator Chuck Blade",
"Highway Wheeled Excavator",
"Excavator Long Reach Attachment",
"Demolition Excavator",
"Excavator Counterweight",
"Track Excavator: <70t",
"Winch Assist Tethering Excavator",
"Excavator Manual Thumb"
]
},
"default": []
},
"keywords": {
"title": "Search keywords (optional)",
"type": "string",
"description": "Optional broad free-text search across listing fields."
},
"categoryName": {
"title": "Category name (advanced)",
"type": "string",
"description": "Advanced fallback for category names not available in the selector."
},
"manufacturerName": {
"title": "Manufacturer",
"type": "string",
"description": "Manufacturer name as it appears on Ritchie Bros. Examples: Cat, John Deere, Komatsu, Volvo, Bobcat, Kubota."
},
"modelName": {
"title": "Model",
"type": "string",
"description": "Type the model name. Works best when Manufacturer is also set."
},
"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."
},
"buyingPlatform": {
"title": "Platform",
"enum": [
"",
"Ritchie Bros. Auctioneers",
"GovPlanet",
"IronPlanet",
"Marketplace-E",
"TruckPlanet",
"SalvageSale"
],
"type": "string",
"description": "Optional marketplace filter.",
"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": ""
},
"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": ""
},
"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."
},
"usageKilometersRange_max": {
"title": "Max km",
"type": "integer",
"description": "Maximum odometer reading."
},
"fetchDetails": {
"title": "Sold prices & inspection data",
"type": "boolean",
"description": "Adds sold price, inspection rating, extra photos, and serial number.
Disable for faster runs.",
"default": false
},
"fetchBidStatus": {
"title": "Live bid status",
"type": "boolean",
"description": "For active auctions: current bid amount, bid count, next required bid, reserve status.",
"default": false
},
"fetchListingDetails": {
"title": "Seller & location details",
"type": "boolean",
"description": "Adds seller info, exact location, subcategory, asset flags, and full photo gallery.",
"default": false
},
"fetchBidHistory": {
"title": "Full bid history",
"type": "boolean",
"description": "Complete log of every bid placed on each listing.",
"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"
},
"proxyConfiguration": {
"title": "Proxy configuration",
"type": "object",
"description": "Proxy for web endpoints. If empty, Apify datacenter proxy is used automatically."
},
"forceRestart": {
"title": "Force restart (ignore checkpoint)",
"type": "boolean",
"description": "If true, ignores any saved checkpoint and restarts from scratch.",
"default": true
},
"detailConcurrency": {
"title": "Parallel requests",
"minimum": 1,
"maximum": 20,
"type": "integer",
"description": "How many items to process in parallel.",
"default": 5
},
"delayBetweenRequests": {
"title": "Delay between requests (ms)",
"minimum": 0,
"maximum": 10000,
"type": "integer",
"description": "Wait time between requests in milliseconds.",
"default": 500
},
"outputSchema": {
"title": "Output schema",
"enum": [
"english",
"ftp28"
],
"type": "string",
"description": "Select 'ftp28' to output canonical Spanish field names for FTP-28 pipeline integration.",
"default": "english"
},
"_admin_snapshot": {
"title": "Admin: Full active snapshot",
"type": "boolean",
"description": "INTERNAL. Triggers full snapshot of active listings (New+Preview+Open) to Named Dataset. Requires IS_AUTHOR_RUN=1 env var. Output tab will be empty — data goes to Storage > Datasets > rbauction-scraper-YYYY-MM.",
"default": false
},
"_admin_snapshot_sold": {
"title": "Admin: Full sold snapshot",
"type": "boolean",
"description": "INTERNAL. Triggers full snapshot of sold auction results (~1.7M items) to Named Dataset. Requires IS_AUTHOR_RUN=1 env var. Use timeout=43200 (12h) and memory=1024MB.",
"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
}
}
},
"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
}
}
}
}
}
}
}
}
}
}