{ "openapi": "3.0.1", "info": { "title": "RitchieSpecs Catalog Scraper", "description": "New actor improved.\nExtract categories, model lists, and full machine specifications from the public RitchieSpecs API.", "version": "0.3", "x-build-id": "NmhqB0D0Lbhb5e15M" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/rastriq~ritchiespecs-catalog-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-rastriq-ritchiespecs-catalog-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~ritchiespecs-catalog-scraper/runs": { "post": { "operationId": "runs-sync-rastriq-ritchiespecs-catalog-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~ritchiespecs-catalog-scraper/run-sync": { "post": { "operationId": "run-sync-rastriq-ritchiespecs-catalog-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", "live" ], "type": "string", "description": "Choose how to get data:

📦 Preloaded — downloads from our pre-scraped monthly snapshot. Instant results, lower cost. Updated on the 1st of each month.

🔄 Live — scrapes RitchieSpecs in real time. Fresh data but slower and more expensive (one API call per model).

Both modes return the same output schema with a _data_freshness field so you know the source.", "default": "preloaded" }, "equipmentTypes": { "title": "🏗️ Equipment types", "uniqueItems": true, "type": "array", "description": "Select one or more equipment types to extract. Each chip is a specific machine category.

Leave empty and use Category groups below to select entire sectors at once.

💡 Tip: Leave both fields empty to get all equipment types — perfect for bulk exports.", "items": { "type": "string", "enum": [ "2wd-tractor", "4wd-tractor", "air-drill", "baler", "combine", "cultivator", "disc", "harrow", "mfwd-tractor", "sprayer", "swather", "utility-tractor", "asphalt-paver", "cold-planer", "pneumatic-roller", "static-smooth-drum-roller", "vibratory-compactor", "vibratory-smooth-drum-roller", "articulated-dump-truck", "compactor", "crawler-loader", "crawler-pipe-layer", "crawler-tractor", "elevating-motor-scraper", "hydraulic-excavator", "integrated-tool-carrier", "loader-backhoe", "midi-excavator", "mini-excavator", "mobile-excavator", "motor-grader", "motor-scraper", "multi-terrain-loader", "rock-truck", "shovel", "skid-steer-loader", "wheel-dozer", "wheel-loader", "feller-buncher", "forwarder", "harvester", "log-loader", "skidder", "all-terrain-crane", "boom-lift", "crawler-crane", "forklift", "hydraulic-truck-crane", "material-handler", "rough-terrain-crane", "scissor-lift", "telescopic-forklift", "cab-and-chassis", "dump-truck", "truck-tractor" ], "enumTitles": [ "🌾 2WD Tractor", "🌾 4WD Tractor", "🌾 Air Drill", "🌾 Baler", "🌾 Combine", "🌾 Cultivator", "🌾 Disc", "🌾 Harrow", "🌾 MFWD Tractor", "🌾 Sprayer", "🌾 Swather", "🌾 Utility Tractor", "🛣️ Asphalt Paver", "🛣️ Cold Planer", "🛣️ Pneumatic Roller", "🛣️ Static Smooth Drum Roller", "🛣️ Vibratory Compactor", "🛣️ Vibratory Smooth Drum Roller", "🏗️ Articulated Dump Truck", "🏗️ Compactor", "🏗️ Crawler Loader", "🏗️ Crawler Pipe Layer", "🏗️ Crawler Tractor", "🏗️ Elevating Motor Scraper", "🏗️ Hydraulic Excavator", "🏗️ Integrated Tool Carrier", "🏗️ Loader Backhoe", "🏗️ Midi Excavator", "🏗️ Mini Excavator", "🏗️ Mobile Excavator", "🏗️ Motor Grader", "🏗️ Motor Scraper", "🏗️ Multi Terrain Loader", "🏗️ Rock Truck", "🏗️ Shovel", "🏗️ Skid Steer Loader", "🏗️ Wheel Dozer", "🏗️ Wheel Loader", "🌲 Feller Buncher", "🌲 Forwarder", "🌲 Harvester", "🌲 Log Loader", "🌲 Skidder", "🏗️ All Terrain Crane", "🏗️ Boom Lift", "🏗️ Crawler Crane", "🏗️ Forklift", "🏗️ Hydraulic Truck Crane", "🏗️ Material Handler", "🏗️ Rough Terrain Crane", "🏗️ Scissor Lift", "🏗️ Telescopic Forklift", "🚛 Cab and Chassis", "🚛 Dump Truck", "🚛 Truck Tractor" ] }, "default": [] }, "categoryGroups": { "title": "📂 Category groups", "uniqueItems": true, "type": "array", "description": "Select entire equipment sectors instead of individual types. All equipment within each selected group will be included.

Combine with 🏗️ Equipment types above — results are merged automatically.", "items": { "type": "string", "enum": [ "agriculture", "asphalt-aggregate-concrete", "construction", "forestry", "lifting-material-handling", "transportation" ], "enumTitles": [ "🌾 Agriculture", "🛣️ Asphalt / Aggregate / Concrete", "🏗️ Construction & Mining", "🌲 Forestry", "🏗️ Lifting & Material Handling", "🚛 Transportation" ] }, "default": [] }, "manufacturerFilter": { "title": "🏭 Manufacturer filter", "type": "array", "description": "Filter results to specific brands. Enter manufacturer slugs exactly as they appear on RitchieSpecs.

Examples:
• caterpillar
• komatsu
• john-deere
• volvo
• liebherr

Leave empty to include all manufacturers.

💡 Tip: Run once without this filter, then check the manufacturerSlug field in the output to see all available slugs.", "default": [], "items": { "type": "string" } }, "maxModelsPerCategory": { "title": "🔢 Max models per category", "minimum": 0, "type": "integer", "description": "Safety cap on how many models to return per equipment type.

Recommended values:
• 10–25 — quick test run
• 100–500 — category deep-dive
• 0 or empty — return ALL models (bulk export)

💡 Tip: In Preloaded mode, leaving this at 0 is fast and cheap — you're reading from a pre-built database.", "default": 25 }, "includeDetails": { "title": "📊 Include full specs", "type": "boolean", "description": "When enabled, each model includes full specification data: engine, dimensions, drawings, similar models, and marketplace URLs.

In 📦 Preloaded mode: full specs are always available at no extra cost (the snapshot already contains them).

In 🔄 Live mode: ⚠️ adds one extra API request per model. Disable for a fast inventory-only crawl.", "default": true }, "locale": { "title": "🌐 Locale", "type": "string", "description": "Controls the language and measurement units in the specification data.

Known values:
• en_us — English (imperial + metric)", "default": "en_us" }, "maxConcurrency": { "title": "⚡ Max concurrency", "minimum": 1, "maximum": 32, "type": "integer", "description": "Number of parallel requests within each category. Only applies to 🔄 Live mode.

Recommended values:
• 3–5 — conservative
• 8–12 — balanced (default)
• 15–32 — aggressive, use with ⏱️ Request delay enabled", "default": 8 }, "requestDelayMs": { "title": "⏱️ Request delay", "minimum": 0, "maximum": 10000, "type": "integer", "description": "Milliseconds to wait before each API request. Only applies to 🔄 Live mode.

Recommended values:
• 0 ms — fastest (default)
• 200–500 ms — polite crawling
• 1000–2000 ms — if experiencing rate limits", "default": 0 } } }, "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 } } } } } } } } } }