{ "openapi": "3.0.1", "info": { "title": "17ZWD Wholesale Fashion Scraper 一起做网店: New Styles & Stall Data", "description": "Scrape 17ZWD 一起做网店 17货源 wholesale fashion from Hangzhou 杭州, Guangzhou and Chaoshan: daily new styles, wholesale prices, stall market, floor and number, sizes, colors, stall quality. Filter by keyword, date and price. Monitor new styles and price changes. Detail pages are slower. Pay per product.", "version": "0.2", "x-build-id": "M57mpQe6zDLK4kRTr" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/getascraper~17zwd-wholesale-fashion-catalog-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-getascraper-17zwd-wholesale-fashion-catalog-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~17zwd-wholesale-fashion-catalog-scraper/runs": { "post": { "operationId": "runs-sync-getascraper-17zwd-wholesale-fashion-catalog-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~17zwd-wholesale-fashion-catalog-scraper/run-sync": { "post": { "operationId": "run-sync-getascraper-17zwd-wholesale-fashion-catalog-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": { "mode": { "title": "What to collect", "enum": [ "newArrivals", "stallProducts", "productDetails" ], "type": "string", "description": "New arrivals searches the daily new-styles feed of a city site. Stall products lists the catalog of stalls you name. Product details reads the product pages you name.", "default": "newArrivals" }, "site": { "title": "City site", "enum": [ "hz", "gz", "cs", "baigou" ], "type": "string", "description": "Which 17ZWD city site to read. Hangzhou covers Sijiqing, Huanda and nearby markets, Guangzhou covers Shahe and Xin Jinma, Chaoshan covers Puning, Baigou covers bags. Also sets the default site for bare IDs.", "default": "hz" }, "searchQuery": { "title": "Keyword or item number", "type": "string", "description": "Words in the product title or the stall's item number (货号), for example 卫衣 or 牛仔裤. Leave empty to browse everything. In stall mode it searches inside the stall.", "default": "" }, "stallUrls": { "title": "Stall links or IDs", "type": "array", "description": "Used by the stall catalog mode. Stall page links such as https://hz.17zwd.com/shop/564147.htm, or just the number 564147.", "default": [], "items": { "type": "string" } }, "productUrls": { "title": "Product links or IDs", "type": "array", "description": "Used by the product details mode. Product page links such as https://hz.17zwd.com/item/167849425, or just the number.", "default": [], "items": { "type": "string" } }, "category": { "title": "Category", "enum": [ "any", "16", "30", "1625", "50008165", "50010850", "50000671", "50008898", "50010167", "162201", "123216004", "50012771" ], "type": "string", "description": "Product category for the new arrivals feed. Chaoshan and Guangzhou include sub-categories; Hangzhou and Baigou match the exact category only, so a keyword often works better there.", "default": "any" }, "market": { "title": "Hangzhou market", "enum": [ "any", "124", "10548", "10547", "820", "1158", "255", "10180", "10316", "125", "1162", "235", "1165", "10401", "10491", "10533", "10544", "10545", "10546", "10549", "10550", "10551" ], "type": "string", "description": "Wholesale market inside Hangzhou, such as the Sijiqing Star market. Only applies when the city site is Hangzhou.", "default": "any" }, "minPriceCny": { "title": "Minimum price (CNY)", "minimum": 0, "maximum": 99999, "type": "integer", "description": "Only products priced at or above this wholesale price in yuan." }, "maxPriceCny": { "title": "Maximum price (CNY)", "minimum": 1, "maximum": 99999, "type": "integer", "description": "Only products priced at or below this wholesale price in yuan." }, "listedDate": { "title": "Listed on date", "type": "string", "description": "Only products listed on this exact day (China time, within the last 30 days). Leave empty for today's new arrivals." }, "listedWithinDays": { "title": "Listed within the last days", "minimum": 0, "maximum": 30, "type": "integer", "description": "Collect the last N days of new arrivals, newest day first (1 = today). 0 turns this off. Ignored when an exact date is set.", "default": 0 }, "sortBy": { "title": "Sort by", "enum": [ "newest", "priceAsc", "priceDesc", "default" ], "type": "string", "description": "Order of results. Newest first suits monitoring; price orders help price comparison.", "default": "newest" }, "stallLocationContains": { "title": "Market, floor or stall contains", "type": "string", "description": "Keep only products whose stall location or stall name contains this text, for example 四季星座, 3楼 or 池尾商圈.", "default": "" }, "onlyRealShot": { "title": "Real-shot photos only", "type": "boolean", "description": "Keep only products whose photos were taken by the stall (marked as verified real shots).", "default": false }, "onlyVideo": { "title": "With video only", "type": "boolean", "description": "Keep only products that have a product video.", "default": false }, "onlyHdImages": { "title": "HD images only", "type": "boolean", "description": "Keep only products with high-resolution images.", "default": false }, "onlyFirstRelease": { "title": "First-release only", "type": "boolean", "description": "Keep only styles the stall published on 17ZWD first.", "default": false }, "onlyInStock": { "title": "In stock only", "type": "boolean", "description": "Keep only products marked as ready stock (现货).", "default": false }, "onlyDropship": { "title": "17ZWD dropshipping only", "type": "boolean", "description": "Keep only products covered by 17ZWD's own dropshipping service (17代发). Many stalls are not enrolled, so expect fewer results.", "default": false }, "onlyPresale": { "title": "Pre-sale only", "type": "boolean", "description": "Keep only pre-sale (预售) products.", "default": false }, "onlyFreeShipping": { "title": "Free shipping only", "type": "boolean", "description": "Keep only products with free shipping (包邮).", "default": false }, "onlyFlagshipStalls": { "title": "Flagship stalls only", "type": "boolean", "description": "Keep only products from flagship stalls (旗舰店).", "default": false }, "mergeSimilar": { "title": "Merge similar styles", "type": "boolean", "description": "Show one row for near-identical styles from the same stall.", "default": false }, "onlyLocalMarket": { "title": "Only this city's own stalls", "type": "boolean", "description": "Hangzhou and Baigou pages mix in promoted styles from other cities. Keep this on to return only stalls from the selected city.", "default": true }, "includeDetails": { "title": "Read each product page", "type": "boolean", "description": "Open every product page to add per-size prices, colors, sizes, material and other attributes, exact listing time, dispatch time, dropshipping and return terms, and stall quality scores. Slower.", "default": false }, "monitorName": { "title": "Monitor name", "type": "string", "description": "Give a short name (letters, numbers, dashes) to remember what was seen. Later runs with the same name mark each product as new, price changed or unchanged. Leave empty to turn monitoring off.", "default": "" }, "onlyChanges": { "title": "Return only new or changed products", "type": "boolean", "description": "When a monitor name is set, skip products that look the same as last time. Turn off to get every product with its change status.", "default": true }, "maxItems": { "title": "Maximum products", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Stop after this many products have been checked.", "default": 10 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "By default the Actor connects directly and automatically retries through Apify datacenter proxy if the site refuses a request. Choose a proxy here to use it first instead.", "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 } } } } } } } } } }