{ "openapi": "3.0.1", "info": { "title": "K Car Scraper 케이카: Korea Used Car Prices, Price Drops & Stock", "description": "Scrape K Car (케이카) certified used-car inventory in Korea by make, model, year, price, mileage, fuel and region. Get KRW, USD, EUR and JPY prices, a deal score vs the median, and a monitor that flags new cars, price drops and sold cars. No login or API key needed. Pay per car.", "version": "0.2", "x-build-id": "fA95scoR9glKqwWUk" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/getascraper~kcar-inventory-price-monitor/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-getascraper-kcar-inventory-price-monitor", "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/getascraper~kcar-inventory-price-monitor/runs": { "post": { "operationId": "runs-sync-getascraper-kcar-inventory-price-monitor", "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/getascraper~kcar-inventory-price-monitor/run-sync": { "post": { "operationId": "run-sync-getascraper-kcar-inventory-price-monitor", "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": { "listingUrls": { "title": "K Car vehicle links", "type": "array", "description": "K Car vehicle links to look up, one per line. Only the vehicle ID inside the link is used. Leave empty to search by filters instead.", "default": [], "items": { "type": "string" } }, "carIds": { "title": "K Car vehicle IDs", "type": "array", "description": "Vehicle IDs such as EC61422293, one per line. A car that has been sold is not returned.", "default": [], "items": { "type": "string" } }, "makes": { "title": "Makes", "type": "array", "description": "Car makes in English or Korean, one per line, for example Hyundai, Kia, Genesis, BMW, 현대, 기아. Leave empty for every make.", "default": [], "items": { "type": "string" } }, "models": { "title": "Models", "type": "array", "description": "Model names in English or Korean, one per line, for example Grandeur, Sonata, Carnival, 아반떼. Combine with Makes to limit the search to one brand. Leave empty for every model.", "default": [], "items": { "type": "string" } }, "keyword": { "title": "Keyword", "type": "string", "description": "Optional Korean or English search word, for example 하이브리드 or Avante. Leave empty to skip." }, "yearFrom": { "title": "Manufacture year from", "minimum": 1980, "maximum": 2035, "type": "integer", "description": "Oldest manufacture year to include, for example 2020." }, "yearTo": { "title": "Manufacture year to", "minimum": 1980, "maximum": 2035, "type": "integer", "description": "Newest manufacture year to include, for example 2024." }, "priceMinKrw": { "title": "Minimum price (KRW)", "minimum": 0, "type": "integer", "description": "Lowest asking price in Korean won, for example 10000000 for 10 million won. K Car prices move in steps of 10,000 won." }, "priceMaxKrw": { "title": "Maximum price (KRW)", "minimum": 0, "type": "integer", "description": "Highest asking price in Korean won, for example 30000000." }, "minMileageKm": { "title": "Minimum mileage (km)", "minimum": 0, "type": "integer", "description": "Fewest kilometres driven." }, "maxMileageKm": { "title": "Maximum mileage (km)", "minimum": 0, "type": "integer", "description": "Most kilometres driven, for example 60000." }, "fuelTypes": { "title": "Fuel types", "type": "array", "description": "Limit by fuel or drivetrain type. Leave empty for all.", "items": { "type": "string", "enum": [ "001", "002", "003", "006", "007", "008", "009", "013", "005", "010", "011", "012", "999" ], "enumTitles": [ "Gasoline (가솔린)", "Diesel (디젤)", "LPG (LPG)", "Gasoline hybrid (가솔린+전기)", "Diesel hybrid (디젤+전기)", "LPG hybrid (LPG+전기)", "Electric (전기)", "Hydrogen electric (수소전기)", "Gasoline + LPG (가솔린+LPG)", "Gasoline + CNG (가솔린+CNG)", "LNG (LNG)", "CNG (CNG)", "Other (기타)" ] }, "default": [] }, "transmissions": { "title": "Transmissions", "type": "array", "description": "Limit by gearbox. Leave empty for all.", "items": { "type": "string", "enum": [ "001", "002", "003", "004", "999" ], "enumTitles": [ "Automatic (오토)", "Manual (수동)", "Semi-automatic (세미오토)", "CVT (CVT)", "Other (기타)" ] }, "default": [] }, "bodyTypes": { "title": "Body types", "type": "array", "description": "Limit by body style or size class. Leave empty for all.", "items": { "type": "string", "enum": [ "001", "002", "003", "004", "005", "006", "007", "008", "009", "010", "011", "012", "099" ], "enumTitles": [ "Compact (kei) (경차)", "Subcompact (소형차)", "Compact (준중형차)", "Midsize (중형차)", "Full-size (대형차)", "Sports car (스포츠카)", "SUV (SUV)", "RV / MPV (RV)", "Light van (경승합차)", "Van (승합차)", "Truck (화물차)", "Bus (버스)", "Other (기타)" ] }, "default": [] }, "colors": { "title": "Colours", "type": "array", "description": "Limit by exterior colour family. Leave empty for all.", "items": { "type": "string", "enum": [ "001", "002", "003", "004", "005", "006", "007", "008", "009", "010", "011" ], "enumTitles": [ "White (흰색 계열)", "Grey / silver (회색 계열)", "Black (검정색 계열)", "Brown / gold (갈색 계열)", "Red / pink (빨간색 계열)", "Green (녹색 계열)", "Orange (주황색 계열)", "Blue (파란색 계열)", "Yellow (노란색 계열)", "Purple (보라색 계열)", "Other (기타)" ] }, "default": [] }, "regions": { "title": "Regions", "type": "array", "description": "Limit to cars at K Car branches in these regions. Leave empty for all of Korea.", "items": { "type": "string", "enum": [ "MEGA", "SEOUL", "INCHUN", "BUSAN", "DEGUE", "GANGJU", "JUNJU", "DEJUN", "CHEONGJU", "JEJU", "GANGWON" ], "enumTitles": [ "Home service mega center (홈서비스 메가센터)", "Seoul (서울)", "Gyeonggi / Incheon (경기/인천)", "Gyeongnam (Busan) (경남)", "Gyeongbuk (Daegu) (경북)", "Jeonnam (Gwangju) (전남)", "Jeonbuk (Jeonju) (전북)", "Chungnam (Daejeon) (충남)", "Chungbuk (Cheongju) (충북)", "Jeju (제주)", "Gangwon (강원)" ] }, "default": [] }, "noAccidentOnly": { "title": "No-accident cars only", "type": "boolean", "description": "Keep only cars that K Car lists as having no accident history.", "default": false }, "maxResults": { "title": "Maximum results", "minimum": 1, "maximum": 20000, "type": "integer", "description": "Most vehicles to save per run. K Car lists roughly 8,000 cars, so set 10000 to read the whole inventory. Free-plan runs are capped at 25.", "default": 20 }, "sortBy": { "title": "Sort by", "enum": [ "recommended", "newest", "priceLow", "priceHigh", "lowMileage" ], "type": "string", "description": "Order in which cars are read. It decides which cars you get when the result limit is smaller than the number of matches.", "default": "recommended" }, "monitorName": { "title": "Monitor name", "type": "string", "description": "Give this search a name to track it between runs, for example daily-hyundai. Each car is then marked NEW, PRICE_DROP, PRICE_RISE, UPDATED or SOLD_OR_REMOVED with its price history. Leave empty for a plain one-off run.", "default": "" }, "changesOnly": { "title": "Only changed cars", "type": "boolean", "description": "With a monitor name, skip cars whose price and details did not change. Skipped cars are not charged.", "default": false }, "addCurrencyConversion": { "title": "Add USD, EUR and JPY prices", "type": "boolean", "description": "Add the price in US dollars, euros and yen from the daily ECB exchange rate, with the rate date.", "default": false }, "addMarketComparison": { "title": "Add deal score vs market median", "type": "boolean", "description": "Compare each car with the median price of the same make, model and model year among the cars of this run. Cars in groups of fewer than 5 get no score.", "default": false }, "includeOptions": { "title": "Include equipment list", "type": "boolean", "description": "Add the full list of equipment and options (in Korean) for every car.", "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 } } } } } } } } } }