{ "openapi": "3.0.1", "info": { "title": "Compact Excavator Auction Bid Ceiling", "description": "Calculate a transparent buyer-specific maximum bid and walk-away price for one used compact-excavator auction lot.", "version": "1.0", "x-build-id": "hb5rwae9WIHWdkrgb" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/boundedtools~compact-excavator-bid-ceiling/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-boundedtools-compact-excavator-bid-ceiling", "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/boundedtools~compact-excavator-bid-ceiling/runs": { "post": { "operationId": "runs-sync-boundedtools-compact-excavator-bid-ceiling", "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/boundedtools~compact-excavator-bid-ceiling/run-sync": { "post": { "operationId": "run-sync-boundedtools-compact-excavator-bid-ceiling", "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", "required": [ "mode" ], "properties": { "mode": { "title": "Run mode", "enum": [ "free_example", "valuation" ], "type": "string", "description": "free_example uses the complete synthetic example and is not billable. valuation processes your private lot and charges one valuation event after success.", "default": "free_example" }, "lotUrl": { "title": "Auction lot URL", "maxLength": 2048, "type": "string", "description": "One HTTPS lot page. The exact host must be allowlisted and rightsConfirmed must be true. Redirects, robots rules, DNS, content type, and size are checked." }, "uploadedHtml": { "title": "Uploaded/exported lot HTML", "maxLength": 2000000, "type": "string", "description": "HTML copied or exported by the buyer. Scripts are never executed. Maximum 2 MB. Do not submit full catalogs or content you may not process." }, "sourceReference": { "title": "Source reference", "maxLength": 500, "type": "string", "description": "Optional URL, lot number, filename, or internal reference for HTML/structured inputs." }, "lotData": { "title": "Structured compact-excavator lot data", "type": "object", "description": "Canonical buyer-supplied lot facts. Do not guess missing values. Optional evidence entries are compared with the selected fact and conflicts are flagged.", "properties": { "assetType": { "title": "Asset type", "description": "Must be compact_excavator or a recognizable compact-excavator synonym.", "type": "string" }, "manufacturer": { "title": "Manufacturer", "description": "Manufacturer shown by the source.", "type": "string", "maxLength": 100 }, "model": { "title": "Model", "description": "Model shown by the source.", "type": "string", "maxLength": 100 }, "year": { "title": "Year", "description": "Four-digit model year when observed.", "type": "integer", "minimum": 1970, "maximum": 2100 }, "hours": { "title": "Hours", "description": "Observed meter hours.", "type": "number", "minimum": 0, "maximum": 100000 }, "operatingWeightKg": { "title": "Operating weight (kg)", "description": "Operating weight in kilograms.", "type": "number", "minimum": 500, "maximum": 20000 }, "engine": { "title": "Engine", "description": "Engine maker/model or source wording.", "type": "string", "maxLength": 200 }, "attachments": { "title": "Attachments", "description": "Included buckets, thumb, coupler, blade, or other attachments.", "type": "array", "items": { "type": "string", "maxLength": 200 }, "maxItems": 30 }, "cabType": { "title": "Cab or canopy", "description": "cab, canopy, or unknown.", "type": "string" }, "undercarriageCondition": { "title": "Undercarriage condition", "description": "Observed source wording; do not convert guesses into precise percentages.", "type": "string", "maxLength": 300 }, "condition": { "title": "Overall condition", "description": "excellent, good, fair, poor, damaged, or unknown.", "type": "string" }, "visibleDamage": { "title": "Visible damage", "description": "Short buyer-supplied observation, not a copied listing description.", "type": "array", "items": { "type": "string", "maxLength": 300 }, "maxItems": 30 }, "location": { "title": "Location", "description": "Lot location used for logistics context.", "type": "string", "maxLength": 300 }, "auctionDate": { "title": "Auction date", "description": "ISO date when known.", "type": "string" }, "auctionHouse": { "title": "Auction house", "description": "Auction house name.", "type": "string", "maxLength": 200 }, "statedFees": { "title": "Stated fees", "description": "Minimal source fee wording or numeric facts.", "type": "string", "maxLength": 500 }, "knownMissingFacts": { "title": "Known missing facts", "description": "Facts explicitly absent or unverified.", "type": "array", "items": { "type": "string", "maxLength": 100 }, "maxItems": 30 }, "evidence": { "title": "Fact evidence", "description": "Map of fact name to evidence item(s): value, sourceType, sourceRef, extraction, and confidence.", "type": "object" } }, "default": {} }, "buyer": { "title": "Buyer costs and required return", "type": "object", "description": "All money values use the selected currency. Negative costs are rejected; zero costs are accepted and flagged where risky.", "properties": { "currency": { "title": "Currency", "description": "Three-letter ISO-style currency code.", "type": "string", "default": "USD", "minLength": 3, "maxLength": 3 }, "auctionFee": { "title": "Auction fee", "description": "Use percent plus fixed, or progressive tiers [{upTo,percent}]. Last upTo may be null.", "type": "object" }, "transportCost": { "title": "Transport", "description": "Door-to-door or yard-to-yard transport estimate.", "type": "number", "minimum": 0 }, "loadingRemovalCost": { "title": "Loading/removal", "description": "Loading, rigging, removal, permits, or release costs.", "type": "number", "minimum": 0 }, "repairAllowance": { "title": "Repair allowance", "description": "Object with low, base, and high non-negative amounts.", "type": "object" }, "inspectionCost": { "title": "Inspection", "description": "Inspection, fluid sampling, or agent cost.", "type": "number", "minimum": 0 }, "holdingMonths": { "title": "Holding months", "description": "Expected months until resale or deployment.", "type": "number", "minimum": 0, "maximum": 120 }, "monthlyHoldingCost": { "title": "Monthly holding cost", "description": "Storage, insurance, and handling per month, excluding financing.", "type": "number", "minimum": 0 }, "annualCapitalRatePercent": { "title": "Annual capital rate (%)", "description": "Simple annual cost of capital applied for the holding period.", "type": "number", "minimum": 0, "maximum": 100 }, "marginPercentOfResale": { "title": "Required margin (%)", "description": "Required buyer margin as a percentage of expected resale value.", "type": "number", "minimum": 0, "maximum": 100 }, "minimumMarginAmount": { "title": "Minimum margin", "description": "Absolute minimum margin. The engine uses the larger of this and the percentage margin.", "type": "number", "minimum": 0 }, "riskBufferPercentOfResale": { "title": "Risk reserve (%)", "description": "Buyer-specific reserve as a percentage of resale value.", "type": "number", "minimum": 0, "maximum": 100 }, "minimumRiskBufferAmount": { "title": "Minimum risk reserve", "description": "Absolute minimum reserve. The engine uses the larger of this and the percentage reserve.", "type": "number", "minimum": 0 }, "purchaseTaxPercent": { "title": "Purchase tax (%)", "description": "Tax rate on hammer price; optionally also auction fees.", "type": "number", "minimum": 0, "maximum": 100 }, "taxAppliesToFees": { "title": "Tax applies to fees", "description": "Whether purchase tax also applies to the auction fee.", "type": "boolean" }, "expectedResaleChannel": { "title": "Resale channel", "description": "Dealer retail, wholesale, rental fleet, contractor use, or another buyer-defined channel.", "type": "string", "maxLength": 100 }, "bidIncrement": { "title": "Bid increment", "description": "Recommended bid is rounded down to this increment; walk-away is the next increment.", "type": "number", "minimum": 0.01 } }, "default": {} }, "comparables": { "title": "Comparable compact excavators", "maxItems": 100, "type": "array", "description": "Up to 100 comparable records with reference, manufacturer, model, year, hours, condition, price, priceType (sold or asking), and optional date.", "items": { "type": "object", "properties": { "reference": { "title": "Reference", "description": "Stable buyer-defined comparable reference.", "type": "string" }, "manufacturer": { "title": "Manufacturer", "description": "Comparable manufacturer.", "type": "string" }, "model": { "title": "Model", "description": "Comparable model.", "type": "string" }, "year": { "title": "Year", "description": "Comparable model year.", "type": "integer" }, "hours": { "title": "Hours", "description": "Comparable meter hours.", "type": "number" }, "condition": { "title": "Condition", "description": "Comparable condition category.", "type": "string" }, "price": { "title": "Price", "description": "Comparable sold or asking price.", "type": "number" }, "priceType": { "title": "Price type", "description": "Whether price is an observed sold price or asking price.", "type": "string", "enum": [ "sold", "asking" ] }, "date": { "title": "Date", "description": "Comparable sale/listing date when known.", "type": "string" }, "source": { "title": "Source", "description": "Minimal source label; do not copy full listing content.", "type": "string" } } }, "default": [] }, "comparablesCsv": { "title": "Comparable CSV", "maxLength": 1000000, "type": "string", "description": "Alternative CSV with headers reference,manufacturer,model,year,hours,condition,price,priceType,date,source. Maximum 1 MB." }, "resaleEstimate": { "title": "Buyer-supplied resale range", "type": "object", "description": "Optional object {low,base,high,basis}. Use when comparable records are unavailable. The output labels this as a buyer assumption.", "properties": { "low": { "title": "Low resale", "description": "Conservative resale value.", "type": "number", "minimum": 0 }, "base": { "title": "Base resale", "description": "Expected resale value.", "type": "number", "minimum": 0 }, "high": { "title": "High resale", "description": "Aggressive resale value.", "type": "number", "minimum": 0 }, "basis": { "title": "Basis", "description": "Short description of how the buyer formed this range.", "type": "string", "maxLength": 500 } }, "default": {} }, "sourcePolicy": { "title": "URL acquisition policy", "type": "object", "description": "Set enabled and rightsConfirmed true and list the exact allowed host. The adapter remains fail-closed.", "properties": { "enabled": { "title": "Enable URL fetch", "description": "Enable one-page URL acquisition.", "type": "boolean", "default": false }, "rightsConfirmed": { "title": "Rights confirmed", "description": "Buyer confirms the page may be fetched for this use.", "type": "boolean", "default": false }, "allowedHosts": { "title": "Allowed hosts", "description": "Exact lowercase hostnames; wildcards are not accepted.", "type": "array", "items": { "type": "string" }, "maxItems": 10 }, "userAgent": { "title": "User agent", "description": "Transparent user agent token used for the single permitted request.", "type": "string", "maxLength": 200 } }, "default": {} } } }, "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 } } } } } } } } } }