{ "openapi": "3.0.1", "info": { "title": "Ovoko / RRR.lt European OEM Used Auto Parts & Price Scraper", "description": "Extract used OEM auto parts, live EUR prices, dismantler SKUs, and donor vehicle specs (VIN, engine code, mileage, year, kW) from Ovoko (ovoko.fr, ovoko.de, ovoko.es, ovoko.it, ovoko.pl, ovoko.co.uk) and RRR.lt by OEM part number. Built-in delta monitoring for daily price and stock tracking.", "version": "1.0", "x-build-id": "xAHVJkgPKYw2CxSnj" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/js_j~ovoko-oem-auto-parts-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-js_j-ovoko-oem-auto-parts-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/js_j~ovoko-oem-auto-parts-scraper/runs": { "post": { "operationId": "runs-sync-js_j-ovoko-oem-auto-parts-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/js_j~ovoko-oem-auto-parts-scraper/run-sync": { "post": { "operationId": "run-sync-js_j-ovoko-oem-auto-parts-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": { "oemCodes": { "title": "OEM Part Numbers or Search Queries", "type": "array", "description": "Enter OEM part codes (e.g., 9826650680, 03L903017E, 561119603R) or part keywords. The scraper will query each code automatically.", "items": { "type": "string" } }, "startUrls": { "title": "Direct Search, Category, or Part URLs (Optional)", "type": "array", "description": "Paste direct URLs from ovoko.fr, rrr.lt, ovoko.de, etc. if you want to scrape a specific car model or category filter.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "marketplaceDomain": { "title": "Regional Marketplace Domain", "enum": [ "ovoko.fr", "rrr.lt", "ovoko.de", "ovoko.es", "ovoko.it", "ovoko.pl", "ovoko.co.uk" ], "type": "string", "description": "Select which regional Ovoko/RRR storefront to query.", "default": "ovoko.fr" }, "exactOemMatch": { "title": "Exact OEM Code Match Only", "type": "boolean", "description": "When enabled (exact=1), filters out fuzzy keyword matches and returns only exact part code matches.", "default": true }, "maxItemsPerQuery": { "title": "Max Parts per OEM Query", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Maximum number of parts to extract per OEM code or start URL.", "default": 40 }, "scrapeFullPartDetails": { "title": "Deep Enrich (Open Each Part Page for VIN & Full Donor Specs)", "type": "boolean", "description": "If enabled, visits each individual part page to extract full Donor VIN, Engine Code, Gearbox Code, Paint Code, and High-Res Photo gallery.", "default": false }, "onlyNewOrPriceChanged": { "title": "Delta Monitor Mode (Only New Parts or Price Drops)", "type": "boolean", "description": "Saves part IDs and prices across runs in KeyValueStore. Only outputs and charges for brand-new listings or parts whose price changed since the last run.", "default": false }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Apify Proxy settings. Datacenter proxies work for light runs; switch to Residential if scraping thousands of pages.", "default": { "useApifyProxy": true } } } }, "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 } } } } } } } } } }