{ "openapi": "3.0.1", "info": { "title": "Automotive Parts Search & Price Intelligence", "description": "Compare fixed-price automotive parts across 9 eBay marketplaces. Search by OEM, MPN, EAN or description, normalize prices and known shipping to one currency, deduplicate offers, and rank best price and best value. No customer eBay credentials required.", "version": "1.3", "x-build-id": "JGazx702FTLXDfbAm" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/jarek090~automotive-parts-price-intelligence/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-jarek090-automotive-parts-price-intelligence", "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/jarek090~automotive-parts-price-intelligence/runs": { "post": { "operationId": "runs-sync-jarek090-automotive-parts-price-intelligence", "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/jarek090~automotive-parts-price-intelligence/run-sync": { "post": { "operationId": "run-sync-jarek090-automotive-parts-price-intelligence", "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": { "query": { "title": "Part description / search query", "type": "string", "description": "Free-text description, for example Porsche 718 GTS brake disc." }, "partNumber": { "title": "OEM / MPN / EAN", "type": "string", "description": "Exact manufacturer or OEM part number. It is normalized into spaced, dashed and compact search variants." }, "vehicleMake": { "title": "Vehicle make", "type": "string", "description": "Optional make used to improve ranking and query expansion." }, "vehicleModel": { "title": "Vehicle model", "type": "string", "description": "Optional model or generation used to improve ranking and query expansion." }, "vehicleYear": { "title": "Vehicle year", "minimum": 1900, "maximum": 2100, "type": "integer", "description": "Optional model year used as a search hint." }, "condition": { "title": "Condition", "enum": [ "ALL", "NEW", "USED" ], "type": "string", "description": "Filter or preference for new or used items.", "default": "ALL" }, "ebayMarketplaces": { "title": "eBay regional marketplaces", "uniqueItems": true, "type": "array", "description": "eBay Browse marketplaces to search. Nine default production markets are enabled; additional official Browse markets can be selected per run.", "items": { "type": "string", "enum": [ "EBAY_US", "EBAY_CA", "EBAY_AU", "EBAY_GB", "EBAY_DE", "EBAY_PL", "EBAY_IT", "EBAY_FR", "EBAY_ES", "EBAY_AT", "EBAY_BE", "EBAY_CH", "EBAY_IE", "EBAY_NL", "EBAY_HK", "EBAY_SG" ], "enumTitles": [ "United States", "Canada", "Australia", "United Kingdom", "Germany", "Poland", "Italy", "France", "Spain", "Austria", "Belgium", "Switzerland", "Ireland", "Netherlands", "Hong Kong", "Singapore" ] }, "default": [ "EBAY_US", "EBAY_CA", "EBAY_AU", "EBAY_GB", "EBAY_DE", "EBAY_PL", "EBAY_IT", "EBAY_FR", "EBAY_ES" ] }, "destinationCountry": { "title": "Destination country", "type": "string", "description": "Two-letter destination country used as shipping context where eBay supports destination-aware estimates.", "default": "PL" }, "destinationPostalCode": { "title": "Destination postal / ZIP code", "type": "string", "description": "Optional postal code. When supplied with destination country, eBay can return more accurate calculated shipping information." }, "targetCurrency": { "title": "Target currency", "enum": [ "PLN", "EUR", "USD", "CAD", "AUD", "GBP", "JPY", "BRL", "MXN" ], "type": "string", "description": "Currency for normalized comparison using ECB reference rates when available.", "default": "PLN" }, "maxResultsPerMarket": { "title": "Max results per market", "minimum": 1, "maximum": 50, "type": "integer", "description": "Maximum number of normalized offers retained per regional market.", "default": 20 }, "deduplicate": { "title": "Deduplicate repeated offers", "type": "boolean", "description": "Remove repeated item IDs and near-identical records before ranking.", "default": 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 } } }, "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 } } } } } } } } } }