{ "openapi": "3.0.1", "info": { "title": "PCauto Scraper 太平洋汽车 汽车报价: China New Car Prices, Trims & Specs", "description": "Scrape and monitor PCauto (太平洋汽车) 汽车报价 for China's new-car market: filter by brand, price, energy type, body class and equipment, then export series or trim guide prices, city dealer quotes, full spec sheets and price-change alerts as JSON, CSV or Excel. No login.", "version": "1.0", "x-build-id": "FBkA0CCxIhhLHe69J" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/getascraper~pcauto-vehicle-price-specs-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-getascraper-pcauto-vehicle-price-specs-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/getascraper~pcauto-vehicle-price-specs-scraper/runs": { "post": { "operationId": "runs-sync-getascraper-pcauto-vehicle-price-specs-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/getascraper~pcauto-vehicle-price-specs-scraper/run-sync": { "post": { "operationId": "run-sync-getascraper-pcauto-vehicle-price-specs-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": { "resultLevel": { "title": "Result level / 结果级别", "enum": [ "series", "trims" ], "type": "string", "description": "Series returns one row per car series (for example Volkswagen Passat) with price range, sales and energy types, which is the fastest option. Trims returns one row per trim level with its own guide price, lowest dealer quote and key specs.", "default": "series" }, "maxItems": { "title": "Maximum results / 最大结果数", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Maximum number of rows to save. Keep it small for a quick check and raise it to collect the whole catalog. Free plan runs are capped at 25.", "default": 10 }, "startUrls": { "title": "PCauto pages / 太平洋汽车链接", "type": "array", "description": "Optional public pages from price.pcauto.com.cn: a car series (/sg31345/), a single trim (/m142596/), a brand (/price/nb2/) or any filter page (/price/q-ps10-pe20-rl9998.html). Filters in the form are combined with filters found in a pasted filter page.", "default": [], "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "brands": { "title": "Brands / 品牌", "type": "array", "description": "Brand names to include, in Chinese (比亚迪, 特斯拉, 大众) or common English names (BYD, Tesla, Volkswagen, BMW). Leave empty for all brands.", "default": [], "items": { "type": "string" } }, "seriesNames": { "title": "Series name contains / 车系名称", "type": "array", "description": "Keep only series whose name contains one of these words, for example 秦 or Model Y. Matching runs on the full result list, so it can take a few extra requests.", "default": [], "items": { "type": "string" } }, "saleStatus": { "title": "Sale status / 在售状态", "enum": [ "all", "onSale" ], "type": "string", "description": "Include every series, or only series that are currently on sale (hides upcoming launches).", "default": "all" }, "sortBy": { "title": "Sort by / 排序", "enum": [ "popularity", "priceAsc", "priceDesc", "newest", "oldest" ], "type": "string", "description": "Order of the results. Popularity is the site default.", "default": "popularity" }, "priceMinWan": { "title": "Minimum guide price (10,000 CNY) / 最低指导价", "minimum": 0, "maximum": 10000, "type": "number", "description": "Lowest manufacturer guide price in units of 10,000 CNY (万). Example: 15 means 150,000 CNY." }, "priceMaxWan": { "title": "Maximum guide price (10,000 CNY) / 最高指导价", "minimum": 0, "maximum": 10000, "type": "number", "description": "Highest manufacturer guide price in units of 10,000 CNY (万). Example: 30 means 300,000 CNY." }, "energyTypes": { "title": "Energy type / 能源类型", "type": "array", "description": "Fuel or electrified powertrain. Several choices are combined with OR.", "items": { "type": "string", "enum": [ "bev", "phev", "erev", "fcev", "newEnergy", "gasoline", "diesel", "mildHybrid" ], "enumTitles": [ "Battery electric 纯电动", "Plug-in hybrid 插电混动", "Range extender 增程式", "Hydrogen fuel cell 氢燃料", "All new energy 新能源", "Gasoline 汽油", "Diesel 柴油", "Mild hybrid 油电混合" ] }, "default": [] }, "minElectricRangeKm": { "title": "Minimum electric range (km) / 最低纯电续航", "minimum": 0, "maximum": 2000, "type": "integer", "description": "Keep vehicles with at least this pure-electric range in km (CLTC). Applies to electric and plug-in models." }, "maxElectricRangeKm": { "title": "Maximum electric range (km) / 最高纯电续航", "minimum": 0, "maximum": 2000, "type": "integer", "description": "Keep vehicles with at most this pure-electric range in km (CLTC)." }, "bodyClasses": { "title": "Body class / 级别", "type": "array", "description": "Vehicle segment as classified by PCauto. Several choices are combined with OR.", "items": { "type": "string", "enum": [ "microCar", "smallCar", "compactCar", "midsizeCar", "midLargeCar", "largeCar", "smallSuv", "compactSuv", "midsizeSuv", "midLargeSuv", "largeSuv", "mpv", "sportsCar", "pickup", "van", "microTruck", "lightBus" ], "enumTitles": [ "Micro car 微型车", "Small car 小型车", "Compact car 紧凑型车", "Midsize car 中型车", "Mid-large car 中大型车", "Large car 大型车", "Small SUV 小型SUV", "Compact SUV 紧凑型SUV", "Midsize SUV 中型SUV", "Mid-large SUV 中大型SUV", "Large SUV 大型SUV", "MPV", "Sports car 跑车", "Pickup 皮卡", "Van 微面", "Micro truck 微卡", "Light bus 轻客" ] }, "default": [] }, "origins": { "title": "Origin / 产地", "type": "array", "description": "Whether the brand is domestic, a joint venture or imported.", "items": { "type": "string", "enum": [ "domestic", "jointVenture", "imported", "foreignOwned" ], "enumTitles": [ "Domestic brand 自主", "Joint venture 合资", "Imported 进口", "Foreign-owned 外商独资" ] }, "default": [] }, "countries": { "title": "Brand country / 国别", "type": "array", "description": "Country the brand comes from.", "items": { "type": "string", "enum": [ "china", "germany", "japan", "usa", "korea", "france", "uk", "italy", "sweden", "other" ], "enumTitles": [ "China 中国", "Germany 德国", "Japan 日本", "USA 美国", "Korea 韩国", "France 法国", "UK 英国", "Italy 意大利", "Sweden 瑞典", "Other 其他" ] }, "default": [] }, "seats": { "title": "Seats / 座位数", "type": "array", "description": "Number of seats.", "items": { "type": "string", "enum": [ "2", "4", "5", "6", "7", "8+" ], "enumTitles": [ "2 seats", "4 seats", "5 seats", "6 seats", "7 seats", "More than 7 seats" ] }, "default": [] }, "drivetrains": { "title": "Drivetrain / 驱动方式", "type": "array", "description": "Which wheels are driven.", "items": { "type": "string", "enum": [ "fwd", "rwd", "awd" ], "enumTitles": [ "Front-wheel drive 前驱", "Rear-wheel drive 后驱", "All-wheel drive 四驱" ] }, "default": [] }, "transmissions": { "title": "Transmission / 变速箱", "type": "array", "description": "Gearbox type.", "items": { "type": "string", "enum": [ "manual", "automatic", "at", "cvt", "dct", "tiptronic", "amt", "singleSpeed", "ecvt", "dht" ], "enumTitles": [ "Manual 手动", "Any automatic 自动", "Torque converter AT", "CVT 无级变速", "Dual clutch 双离合", "Tiptronic 手自一体", "AMT", "Single-speed 固定齿比", "E-CVT", "Dedicated hybrid DHT" ] }, "default": [] }, "features": { "title": "Required equipment / 配置", "type": "array", "description": "Keep only series that offer all of the selected equipment.", "items": { "type": "string", "enum": [ "adasL2", "highwayNoa", "cityNoa", "adaptiveCruise", "surroundCamera", "autoParking", "remoteParking", "airSuspension", "panoramicRoof", "electricTailgate", "seatHeating", "seatVentilation", "seatMassage", "headUpDisplay", "wirelessCharging", "ota", "carPlay", "heatPump", "externalDischarge", "rearScreen", "dolbyAtmos" ], "enumTitles": [ "Driver assistance level L2 驾驶辅助L2", "Highway navigation assist 高速导航辅助", "City navigation assist 城市导航辅助", "Adaptive cruise 自适应巡航", "360 camera 360度全景影像", "Auto parking 自动泊车入位", "Remote parking 遥控泊车", "Air suspension 空气悬挂", "Openable panoramic roof 全景天窗", "Electric tailgate 电动后备厢", "Front seat heating 座椅加热", "Front seat ventilation 座椅通风", "Front seat massage 座椅按摩", "HUD 抬头显示", "Wireless phone charging 无线充电", "OTA updates OTA升级", "Apple CarPlay", "Heat pump A/C 热泵空调", "Vehicle-to-load discharge 对外放电", "Rear entertainment screen 后排屏幕", "Dolby Atmos 杜比全景声" ] }, "default": [] }, "useCases": { "title": "Use case / 用车场景", "type": "array", "description": "PCauto's own use-case tags.", "items": { "type": "string", "enum": [ "budget", "firstCar", "family", "camping", "roadTrip", "commuting", "smartDriving", "business", "smartCabin", "womenFriendly", "rideHailing", "petFriendly", "handling" ], "enumTitles": [ "Budget runabout 经济代步", "First car 新手入门", "Family with kids 二胎家庭", "Camping 露营郊游", "Road trips 长途自驾", "Commuting 跨城通勤", "Smart driving 智驾先锋", "Business 商务接待", "Smart cabin 智慧座舱", "Women friendly 女性友好", "Ride hailing 网约营运", "Pet friendly 宠物随行", "Handling 弯道王者" ] }, "default": [] }, "cities": { "title": "Dealer price cities / 经销商报价城市", "type": "array", "description": "Chinese city names (北京, 上海, 广州, 深圳, 成都) to add the local dealer lowest price and discount for each series or trim. Leave empty to skip.", "default": [], "items": { "type": "string" } }, "includeFullSpecs": { "title": "Full specification sheet / 完整参数配置", "type": "boolean", "description": "Trim results only. Adds the key specs (dimensions, power, battery, range, consumption, warranty, colors) plus the full spec sheet grouped by section, up to several hundred items per trim.", "default": false }, "includeDiscontinued": { "title": "Include discontinued trims / 含停售车型", "type": "boolean", "description": "Trim results only. Also return trims that are no longer sold, marked as discontinued.", "default": false }, "trackChanges": { "title": "Track changes between runs / 追踪变化", "type": "boolean", "description": "Remembers the prices of each search between runs and flags new vehicles, price changes and discontinued trims, with a price history. The first run records a baseline. Use the same filters on a schedule.", "default": true }, "onlyChanges": { "title": "Only return changes / 仅返回变化", "type": "boolean", "description": "After the baseline run, save only vehicles that are new, changed price or were discontinued. Unchanged vehicles are skipped.", "default": false }, "monitorName": { "title": "Monitor name / 监控名称", "type": "string", "description": "Optional label to keep one stored history per scheduled task. Leave empty to tie the history to the exact filters used.", "default": "" }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "PCauto data is public and normally opens without a proxy, so runs connect directly. If that route keeps failing, the run switches once to Apify datacenter proxy by itself. Choose a proxy here only if you want requests to come from one.", "default": { "useApifyProxy": 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 } } } } } } } } } }