{ "openapi": "3.0.1", "info": { "title": "Taobao Judicial Auction Scraper: Ali Auction 阿里拍卖 司法拍卖", "description": "Extract China judicial & asset auction data from Taobao Ali Auction (阿里拍卖 司法拍卖): foreclosed property (法拍房), vehicles, machinery, equity, with appraisal price, deposit, bid rules, auction window, court and legal notice. Export JSON, CSV, Excel.", "version": "0.0", "x-build-id": "k2SZSCRvibW8sDm0c" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/zen-studio~taobao-judicial-auction-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-zen-studio-taobao-judicial-auction-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/zen-studio~taobao-judicial-auction-scraper/runs": { "post": { "operationId": "runs-sync-zen-studio-taobao-judicial-auction-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/zen-studio~taobao-judicial-auction-scraper/run-sync": { "post": { "operationId": "run-sync-zen-studio-taobao-judicial-auction-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": { "searchKeyword": { "title": "关键词 Keyword", "type": "string", "description": "Enter a free-text search keyword.

Examples:
• 厂房 factory building
• 写字楼 office building
• 小汽车 passenger car

Optional if a 类目 Category is selected instead." }, "category": { "title": "类目 Category", "enum": [ "206058503", "206060601", "206385702", "206057102", "206060202", "206065802", "206053405", "206134704", "206135305", "206165202", "206059902", "206137604", "206067001", "206067301", "206066601", "206058504", "206144002", "206067201", "206067101", "206060901", "206058004", "206140304", "206140005", "206049905", "206054502", "206051702", "206051902", "206143105", "206067601", "206060701", "206148802", "206080001", "206147503", "206072501", "206071001", "206148603", "206143404", "206068701", "206068002", "206308001", "206051502", "206067701", "206057705", "206220804", "206170701", "206072601", "206068801", "206054503", "206061001", "206224905", "206061201", "206139805", "206170901", "206068901", "206067901", "206059002", "206068301", "206308201", "206150001", "206148202", "206141205", "206337901", "206060801", "206479511", "206370901", "206071201", "206137605", "206143604", "206072201", "206067802", "206074002", "206072401", "206147403", "206146703", "206167303", "206072701", "206068601", "206067401", "206391101", "206068201", "206215504", "206068401", "206142704", "206149902", "206146802", "206372301", "206098102", "206068501", "206072301", "206144306", "206308002", "206069101", "206068101", "206146502", "206069302", "206107401", "206061101", "206228901", "206059302", "206144507", "206059003", "206136705", "206137706", "206307801", "206144104", "206307901", "206215205", "206069401", "206068001", "206137005", "206134002", "206071003", "206054604", "206134505", "206338001", "206146002", "206052603", "206143205", "206074003", "206149502", "206138506", "206372201", "206145605", "206308401", "206136908", "206069301", "206141505", "206367601", "206145606", "206097705", "206147702", "206068802", "206057702", "206138204", "206148602", "206141106", "206139507", "206308101", "206136406", "206190602", "206224704", "206144702", "206069501", "206146904", "206133804", "206137507", "206107102", "206069601", "206106802", "206479712", "206135907" ], "type": "string", "description": "Restrict results to one asset category, such as real estate, vehicles, or machinery." }, "auctionChannel": { "title": "Auction channel", "enum": [ "judicial", "asset", "all" ], "type": "string", "description": "Ali Auction lists two kinds of sale side by side. Judicial auction (司法拍卖) is court-ordered disposal, this is what people mean by 法拍房. Asset trading (阿里资产) is non-court disposal such as state-owned or bulk developer stock (国资房 / 特价房), and also covers 自行处置 (self-disposal, where the debtor sells directly rather than the court running the auction). Defaults to judicial only, which excludes 自行处置.", "default": "judicial" }, "province": { "title": "省份 Province", "enum": [ "110000", "120000", "130000", "140000", "150000", "210000", "220000", "230000", "310000", "320000", "330000", "340000", "350000", "360000", "370000", "410000", "420000", "430000", "440000", "450000", "460000", "500000", "510000", "520000", "530000", "540000", "610000", "620000", "630000", "640000", "650000", "710000", "810000", "820000", "990000" ], "type": "string", "description": "Restrict results to one province or municipality.

Combine with 城市 City for a narrower region, or use alone for the whole province. A region filter requires a keyword or category to also be set." }, "city": { "title": "城市 City", "enum": [ "110100", "120100", "130100", "130200", "130300", "130400", "130500", "130600", "130700", "130800", "130900", "131000", "131100", "140100", "140200", "140300", "140400", "140500", "140600", "140700", "140800", "140900", "141000", "141100", "150100", "150200", "150300", "150400", "150500", "150600", "150700", "150800", "150900", "152200", "152500", "152900", "210100", "210200", "210300", "210400", "210500", "210600", "210700", "210800", "210900", "211000", "211100", "211200", "211300", "211400", "220100", "220200", "220300", "220400", "220500", "220600", "220700", "220800", "222400", "230100", "230200", "230300", "230400", "230500", "230600", "230700", "230800", "230900", "231000", "231100", "231200", "232700", "310100", "320100", "320200", "320300", "320400", "320500", "320600", "320700", "320800", "320900", "321000", "321100", "321200", "321300", "330100", "330200", "330300", "330400", "330500", "330600", "330700", "330800", "330900", "331000", "331100", "340100", "340200", "340300", "340400", "340500", "340600", "340700", "340800", "341000", "341100", "341200", "341300", "341500", "341600", "341700", "341800", "350100", "350200", "350300", "350400", "350500", "350600", "350700", "350800", "350900", "360100", "360200", "360300", "360400", "360500", "360600", "360700", "360800", "360900", "361000", "361100", "370100", "370200", "370300", "370400", "370500", "370600", "370700", "370800", "370900", "371000", "371100", "371200", "371300", "371400", "371500", "371600", "371700", "410100", "410200", "410300", "410400", "410500", "410600", "410700", "410800", "410881", "410900", "411000", "411100", "411200", "411300", "411400", "411500", "411600", "411700", "420100", "420200", "420300", "420500", "420600", "420700", "420800", "420900", "421000", "421100", "421200", "421300", "422800", "429004", "429005", "429006", "429021", "430100", "430200", "430300", "430400", "430500", "430600", "430700", "430800", "430900", "431000", "431100", "431200", "431300", "433100", "440100", "440200", "440300", "440400", "440500", "440600", "440700", "440800", "440900", "441200", "441300", "441400", "441500", "441600", "441700", "441800", "441900", "442000", "442101", "445100", "445200", "445300", "450100", "450200", "450300", "450400", "450500", "450600", "450700", "450800", "450900", "451000", "451100", "451200", "451300", "451400", "460100", "460200", "460300", "469001", "469002", "469003", "469005", "469006", "469007", "469025", "469026", "469027", "469028", "469030", "469031", "469033", "469034", "469035", "469036", "469037", "469038", "469039", "500100", "510100", "510300", "510400", "510500", "510600", "510700", "510800", "510900", "511000", "511100", "511300", "511400", "511500", "511600", "511700", "511800", "511900", "512000", "513200", "513300", "513400", "520100", "520200", "520300", "520400", "522200", "522300", "522400", "522600", "522700", "530100", "530300", "530400", "530500", "530600", "530700", "530800", "530900", "532300", "532500", "532600", "532800", "532900", "533100", "533300", "533400", "540100", "542100", "542200", "542300", "542400", "542500", "542600", "610100", "610200", "610300", "610400", "610500", "610600", "610700", "610800", "610900", "611000", "620100", "620200", "620300", "620400", "620500", "620600", "620700", "620800", "620900", "621000", "621100", "621200", "622900", "623000", "630100", "632100", "632200", "632300", "632500", "632600", "632700", "632800", "640100", "640200", "640300", "640400", "640500", "650100", "650200", "652100", "652200", "652300", "652700", "652800", "652900", "653000", "653100", "653200", "654000", "654200", "654300", "659001", "659002", "659003", "659004", "659005", "659006", "659007", "659008", "659009", "659010", "659011", "710100", "710200", "710300", "710400", "710500", "710600", "710700", "710800", "710900", "711100", "711200", "711300", "711400", "711500", "711700", "711900", "712100", "712400", "712500", "712600", "712700", "712800", "810100", "810200", "810300", "820100", "820200", "990100" ], "type": "string", "description": "Restrict results to one city.

Leave blank to search the whole province, or the whole country if no province is set either." }, "status": { "title": "状态 Status", "enum": [ "ongoing", "upcoming", "ended", "suspended", "withdrawn" ], "type": "string", "description": "Filter by auction status." }, "disposalRound": { "title": "拍卖轮次 Disposal round", "enum": [ "first", "second", "sale", "other" ], "type": "string", "description": "Filter by which disposal round the auction is in." }, "assetSource": { "title": "资产来源 Asset source", "enum": [ "state_owned", "ordinary", "criminal", "public", "litigation", "financial", "bankruptcy", "collective", "self_disposal" ], "type": "string", "description": "Filter by the asset's disposal source, such as bankruptcy, criminal case, or litigation." }, "serviceTags": { "title": "服务标签 Service tags", "type": "array", "description": "Only return listings that carry one or more of the selected service tags (loanable, no-reserve, financing available, and so on).", "items": { "type": "string", "enum": [ "loanable", "no_reserve", "self_operated", "authenticated", "financing", "assured_pay", "mailable", "triple_refund", "seven_day_returns", "author_authorized" ], "enumTitles": [ "Loan available", "No reserve price", "Self-operated by platform", "Authenticated listing", "Financing available", "Assured payment", "Mailable item", "Triple refund if counterfeit 假一赔三", "7-day no-reason returns 七天无理由退换", "Author authorized 作者授权" ] } }, "priceMin": { "title": "最低价 Min price (¥)", "minimum": 0, "type": "integer", "description": "Optional minimum current price in Chinese yuan (CNY).

Leave blank for no lower price filter." }, "priceMax": { "title": "最高价 Max price (¥)", "minimum": 0, "type": "integer", "description": "Optional maximum current price in Chinese yuan (CNY).

Leave blank for no upper price filter." }, "areaMin": { "title": "最小面积 Min area (m²)", "minimum": 0, "type": "integer", "description": "Optional minimum floor/land area in square meters. Applies to real estate listings.

Leave blank for no lower area filter." }, "areaMax": { "title": "最大面积 Max area (m²)", "minimum": 0, "type": "integer", "description": "Optional maximum floor/land area in square meters. Applies to real estate listings.

Leave blank for no upper area filter." }, "startingWithin": { "title": "Starting within", "enum": [ "3_days", "7_days", "30_days" ], "type": "string", "description": "Only auctions whose bidding opens in the next N days. Looks forward from the moment the run starts." }, "endingWithin": { "title": "Ending within", "enum": [ "1_day", "3_days", "7_days" ], "type": "string", "description": "Only auctions whose bidding closes in the next N days. Use it to pick up results and final prices as lots finish." }, "sort": { "title": "排序 Sort", "enum": [ "default", "auction_time", "price_desc", "price_asc", "bids_desc", "bids_asc", "newest", "sales" ], "type": "string", "description": "Choose how matching auctions are ordered.", "default": "default" }, "enrichDetail": { "title": "拍卖详情 Detail enrichment", "type": "boolean", "description": "Add full auction detail to each listing: court, appraisal price, deposit, bid increment rules, and legal notices.

Enabled by default because this is the main value of the Actor. Turn off for cheaper listing-only rows.", "default": true }, "maxItems": { "title": "结果数量 Max results", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Set the maximum number of auction listing rows to return.", "default": 20 }, "maxPages": { "title": "最大页数 Max pages", "minimum": 1, "type": "integer", "description": "Optional cap on the number of search result pages to fetch. Leave blank to be limited only by 结果数量 Max results." } } }, "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 } } } } } } } } } }