{ "openapi": "3.0.1", "info": { "title": "CarParts.com Scraper", "description": "Scrapes CarParts.com product listings by search query or URL. Returns each part as a flat row with price, brand, part number, vehicle fitment, and specs.", "version": "1.0", "x-build-id": "H50Dhh3a1eyowyVoy" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/parseforge~carparts-com-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-parseforge-carparts-com-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/parseforge~carparts-com-scraper/runs": { "post": { "operationId": "runs-sync-parseforge-carparts-com-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/parseforge~carparts-com-scraper/run-sync": { "post": { "operationId": "run-sync-parseforge-carparts-com-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": { "searchQuery": { "title": "Part name or keyword", "type": "string", "description": "Search term to find auto parts (e.g. 'brake pads', 'oil filter', 'alternator'). If provided, startUrl is ignored." }, "startUrl": { "title": "CarParts.com page URL", "type": "string", "description": "CarParts.com search or category URL (e.g. https://www.carparts.com/search?q=brake+pads). If provided, searchQuery is ignored." }, "maxItems": { "title": "Maximum parts", "minimum": 1, "maximum": 1000000, "type": "integer", "description": "Maximum number of parts to collect per run." }, "year": { "title": "Vehicle Year", "type": "string", "description": "Filter by vehicle year (e.g. '2020'). Optional — combine with make and model for fitment-specific results." }, "make": { "title": "Vehicle Make", "type": "string", "description": "Filter by vehicle make (e.g. 'Toyota', 'Ford', 'Honda')." }, "model": { "title": "Vehicle Model", "type": "string", "description": "Filter by vehicle model (e.g. 'Camry', 'F-150', 'Civic')." }, "part": { "title": "Part Type", "type": "string", "description": "Filter by part type facet (e.g. 'Brake Pad Set', 'Oil Filter', 'Alternator'). 80+ options available." }, "brand": { "title": "Brand", "type": "string", "description": "Filter by brand (e.g. 'Bosch', 'ACDelco', 'Monroe'). 88+ brands available." }, "price_min": { "title": "Min Price ($)", "minimum": 0, "type": "number", "description": "Minimum price filter in USD." }, "price_max": { "title": "Max Price ($)", "minimum": 0, "type": "number", "description": "Maximum price filter in USD." }, "includeFitment": { "title": "🚗 Include vehicle fitment list", "type": "boolean", "description": "Adds the full list of vehicles each part fits (year, make, model, trim, engine) with the fitment note for each one, plus the total count. Read from the same search response, so it costs no extra request. Charged only for a row that receives it.", "default": false }, "includeCrossReference": { "title": "🔁 Include OE and interchange part numbers", "type": "boolean", "description": "Adds the OE numbers the part replaces, the interchange part numbers from other brands, and Partslink numbers when published. No extra request. Charged only for a row that receives it.", "default": false }, "includeSpecifications": { "title": "📋 Include full specifications", "type": "boolean", "description": "Adds every remaining specification the listing publishes (product fit, recommended use, color or finish, material, condition, components, returns policy and the category path). No extra request. Charged only for a row that receives it.", "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 }, "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 } } } } } } } } } }