{ "openapi": "3.0.1", "info": { "title": "8891 Scraper - Taiwan Used Cars: Prices, Mileage, Dealers", "description": "Scrape used car listings from 8891.com.tw, the biggest car marketplace in Taiwan. Get price in TWD, mileage in km, year, model year, engine, gearbox, colour, city, views, dealer badges, photos, video and post dates in English. Filter by brand, model, region, price, year, fuel, body type and more.", "version": "1.0", "x-build-id": "BBL20kYybrItI8Erz" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/normdata~auto8891-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-normdata-auto8891-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/normdata~auto8891-scraper/runs": { "post": { "operationId": "runs-sync-normdata-auto8891-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/normdata~auto8891-scraper/run-sync": { "post": { "operationId": "run-sync-normdata-auto8891-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": { "maxItems": { "title": "Maximum results", "minimum": 1, "type": "integer", "description": "Stop after this many cars in total. Leave empty for no limit. The Apify Free plan is always capped at 10." }, "brands": { "title": "Brands", "type": "array", "description": "One or more car brands. Empty = all brands.", "items": { "type": "string", "enum": [ "abarth", "acura", "alfa-romeo", "asia", "aston-martin", "audi", "bmw", "brabus", "byd", "bentley", "buick", "cmc", "cadillac", "caterham", "chevrolet", "chrysler", "citroen", "dfsk", "daihatsu", "dodge", "ferrari", "fiat", "ford", "foton", "foxtron", "gmc", "hino", "honda", "hummer", "hyundai", "iveco", "ineos", "infiniti", "isuzu", "jaguar", "jeep", "kia", "lamborghini", "land-rover", "lexus", "lincoln", "lotus", "luxgen", "mg", "mahindra", "maserati", "mazda", "mclaren", "mercedes-benz", "mini", "mitsubishi", "morgan", "nissan", "opel", "peugeot", "porsche", "proton", "renault", "rolls-royce", "saab", "scion", "skoda", "smart", "ssangyong", "subaru", "suzuki", "tesla", "tobe", "toyota", "volkswagen", "volvo", "yueloong" ], "enumTitles": [ "Abarth", "Acura (謳歌)", "Alfa Romeo (愛快羅密歐)", "Asia (亞細亞)", "Aston Martin (奧斯頓·馬丁)", "Audi (奧迪)", "BMW (寶馬)", "BRABUS", "BYD (比亞迪)", "Bentley (賓利)", "Buick (別克)", "CMC (中華汽車)", "Cadillac (凱迪拉克)", "Caterham", "Chevrolet (雪佛蘭)", "Chrysler (克萊斯勒)", "Citroen (雪鐵龍)", "DFSK (東風小康)", "Daihatsu (大發)", "Dodge (道奇)", "Ferrari (法拉利)", "Fiat (飛雅特)", "Ford (福特)", "Foton", "Foxtron", "GMC (通用)", "Hino (日野)", "Honda (本田)", "Hummer (悍馬)", "Hyundai (現代)", "IVECO (台宇)", "Ineos", "Infiniti (極致)", "Isuzu (五十鈴)", "Jaguar (捷豹)", "Jeep (吉普)", "Kia (起亞)", "Lamborghini (藍寶堅尼)", "Land Rover", "Lexus (凌志)", "Lincoln (林肯)", "Lotus (蓮花)", "Luxgen (納智捷)", "MG (名爵)", "Mahindra", "Maserati (瑪莎拉蒂)", "Mazda (馬自達)", "McLaren (麥拉倫)", "Mercedes-Benz (賓士)", "Mini (迷你)", "Mitsubishi (三菱)", "Morgan (摩根)", "Nissan (日產)", "Opel (歐寶)", "Peugeot (寶獅)", "Porsche (保時捷)", "Proton (寶騰)", "Renault (雷諾)", "Rolls-Royce (勞斯萊斯)", "Saab (紳寶)", "Scion", "Skoda", "Smart", "Ssangyong (雙龍)", "Subaru (速霸陸)", "Suzuki (鈴木)", "Tesla (特斯拉)", "Tobe (酷比)", "Toyota (豐田)", "Volkswagen (福斯)", "Volvo (富豪)", "Yueloong (裕隆)" ] } }, "models": { "title": "Models", "type": "array", "description": "Model names as 8891 writes them, like \"Corolla Altis\", \"RAV4\", \"C-Class Sedan\" or \"X5\". Each model is one search; pick its brand above for a faster search.", "items": { "type": "string" } }, "keyword": { "title": "Keyword", "type": "string", "description": "Search word, like \"GR\" or \"一手車\". Not used together with models." }, "regions": { "title": "Regions", "type": "array", "description": "Where the car is. Empty = all of Taiwan.", "items": { "type": "string", "enum": [ "1", "3", "2", "6", "4", "5", "7", "8", "10", "11", "14", "12", "13", "15", "17", "19", "20", "22", "21", "23", "24", "25" ], "enumTitles": [ "Taipei City", "New Taipei City", "Keelung City", "Taoyuan City", "Hsinchu City", "Hsinchu County", "Miaoli County", "Taichung City", "Changhua County", "Nantou County", "Yunlin County", "Chiayi City", "Chiayi County", "Tainan City", "Kaohsiung City", "Pingtung County", "Yilan County", "Hualien County", "Taitung County", "Penghu County", "Kinmen County", "Lienchiang County (Matsu)" ] } }, "minPrice": { "title": "Minimum price (TWD)", "minimum": 0, "type": "integer", "description": "In New Taiwan dollars, like 300000." }, "maxPrice": { "title": "Maximum price (TWD)", "minimum": 0, "type": "integer", "description": "In New Taiwan dollars, like 800000." }, "minYear": { "title": "Minimum year", "minimum": 1950, "maximum": 2100, "type": "integer", "description": "Year of manufacture, like 2018." }, "maxYear": { "title": "Maximum year", "minimum": 1950, "maximum": 2100, "type": "integer", "description": "Year of manufacture, like 2023." }, "maxMileageKm": { "title": "Maximum mileage (km)", "minimum": 0, "type": "integer", "description": "Like 50000. 8891 has no mileage filter, so each car is checked by the scraper." }, "bodyTypes": { "title": "Body types", "type": "array", "description": "Empty = all.", "items": { "type": "string", "enum": [ "1", "2", "3", "6", "5" ], "enumTitles": [ "Sedan / sports car", "SUV", "Truck / van", "Jeep", "Other" ] } }, "fuels": { "title": "Fuel", "type": "array", "description": "Empty = all.", "items": { "type": "string", "enum": [ "0", "1", "2", "3", "4" ], "enumTitles": [ "Gasoline", "Diesel", "Hybrid", "LPG dual fuel", "Electric" ] } }, "transmissions": { "title": "Transmission", "type": "array", "description": "Empty = all.", "items": { "type": "string", "enum": [ "0", "1", "2", "3", "4" ], "enumTitles": [ "Manual", "Automatic", "Automatic with manual mode", "Manual with automatic mode", "CVT" ] } }, "minEngineCc": { "title": "Minimum engine size (cc)", "minimum": 0, "type": "integer", "description": "Like 1600." }, "maxEngineCc": { "title": "Maximum engine size (cc)", "minimum": 0, "type": "integer", "description": "Like 2000." }, "colors": { "title": "Colours", "type": "array", "description": "Empty = all.", "items": { "type": "string", "enum": [ "0", "4", "2", "3", "1", "10", "9", "5", "8", "13", "11", "15", "12" ], "enumTitles": [ "White", "Black", "Silver", "Grey", "Red", "Blue", "Green", "Yellow", "Orange", "Brown", "Purple", "Pink", "Other" ] } }, "doors": { "title": "Doors", "type": "array", "description": "Empty = all.", "items": { "type": "string", "enum": [ "0", "1", "2", "3", "4" ], "enumTitles": [ "2 doors", "3 doors", "4 doors", "5 doors", "6 doors" ] } }, "seats": { "title": "Seats", "type": "array", "description": "Empty = all.", "items": { "type": "string", "enum": [ "2", "3", "4", "5", "6", "7", "8", "9", "10", "12", "13" ], "enumTitles": [ "2 seats", "3 seats", "4 seats", "5 seats", "6 seats", "7 seats", "8 seats", "9 seats", "10 seats", "12 seats", "More than 12 seats" ] } }, "drive": { "title": "Drive", "enum": [ "", "2", "4" ], "type": "string", "description": "Two or four wheel drive." }, "privateSellersOnly": { "title": "Private sellers only", "type": "boolean", "description": "Only cars sold by their owner, not by a dealer." }, "certifiedOnly": { "title": "Certified cars only", "type": "boolean", "description": "Only cars with an 8891 certification report (認證車)." }, "selectedDealersOnly": { "title": "8891 selected dealers only", "type": "boolean", "description": "Only cars from 8891 selected dealers (8891嚴選)." }, "inShopOnly": { "title": "Cars at the shop only", "type": "boolean", "description": "Leave out cars that are not at the dealer shop (排除不在店)." }, "withVideoOnly": { "title": "With video only", "type": "boolean", "description": "Only cars with a video." }, "newThisWeek": { "title": "New this week only", "type": "boolean", "description": "Only cars posted in the last week." }, "sort": { "title": "Sort by", "enum": [ "", "price-asc", "price-desc", "year-desc", "year-asc", "mile-asc", "mile-desc", "gas-asc", "gas-desc" ], "type": "string", "description": "Order of the results." }, "onlyNew": { "title": "Only new cars", "type": "boolean", "description": "Skip cars saved by earlier runs with the same monitor name." }, "monitorName": { "title": "Monitor name", "type": "string", "description": "Runs with the same name share their history. Use a different name for each schedule." }, "startUrls": { "title": "Links", "type": "array", "description": "Search result links from auto.8891.com.tw, like https://auto.8891.com.tw/toyota?price=300000_800000 or https://auto.8891.com.tw/usedauto?r=1. Single car pages are closed outside Taiwan.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } } } }, "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 } } } } } } } } } }