{ "openapi": "3.0.1", "info": { "title": "RockAuto Scraper", "description": "Scrape RockAuto catalog parts by vehicle or catalog URL. Save brand, part number, price, core charge, and fitment, then alert when the price or core changes.", "version": "0.1", "x-build-id": "BLr2hUe8BHvGpCWIC" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/crawloop~rockauto-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-crawloop-rockauto-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/crawloop~rockauto-scraper/runs": { "post": { "operationId": "runs-sync-crawloop-rockauto-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/crawloop~rockauto-scraper/run-sync": { "post": { "operationId": "run-sync-crawloop-rockauto-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": { "startUrls": { "title": "Catalog URLs", "type": "array", "description": "RockAuto catalog URLs. A page that already lists parts is scraped as-is. A make, year, model, or category page is walked until a part list. Use a part category so a whole vehicle is not opened.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "make": { "title": "Make", "type": "string", "description": "Vehicle make, for example Toyota. Used when Catalog URLs is empty. Also requires year, model, and a part category." }, "year": { "title": "Year", "type": "string", "description": "Model year, for example 2020. Used with make, model, and a part category when Catalog URLs is empty." }, "model": { "title": "Model", "type": "string", "description": "Vehicle model, for example Camry. Used with make, year, and a part category when Catalog URLs is empty." }, "engine": { "title": "Engine", "type": "string", "description": "Optional engine label, for example 2.5L L4. When empty, the first engine on the model page is used." }, "partCategory": { "title": "Part category", "type": "string", "description": "Part name to open, for example brake pad. Required for a make / year / model search. Also filters a category page: an exact name wins, otherwise the label that contains this text." }, "includeAllEngines": { "title": "All engines", "type": "boolean", "description": "Open every engine for the model. Off uses the first engine, or the Engine field when that is set.", "default": false }, "maxItems": { "title": "Max saved parts", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Maximum parts to save. In monitor mode this caps alerts. The run still scans every part on the opened listing pages.", "default": 50 }, "maxPartTypes": { "title": "Max part types", "minimum": 1, "maximum": 10, "type": "integer", "description": "How many part-type pages to open in one run. One page is one category, such as brake pads for one engine. A direct listing URL counts as one page.", "default": 3 }, "monitorMode": { "title": "Monitor mode", "type": "boolean", "description": "The first run saves a baseline and returns parts up to Max saved parts. Later runs with the same monitor store save and charge only new parts, price changes, and core or availability changes. Pair with an Apify Schedule.", "default": false }, "monitorStoreName": { "title": "Monitor store name", "type": "string", "description": "Named key-value store for prices already seen. Use one name per watch so schedules do not overwrite each other.", "default": "rockauto-monitor" }, "resetMonitorState": { "title": "Reset monitor state", "type": "boolean", "description": "Clear the saved baseline before this run. The run then saves a new baseline.", "default": false }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Off by default. The catalog answers a normal request without a proxy. Turn a proxy on only if a run is blocked by a captcha.", "default": { "useApifyProxy": 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 }, "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 } } } } } } } } } }