{
"openapi": "3.0.1",
"info": {
"title": "Weidian Scraper 微店 - Products, Shops & Seller Contacts",
"description": "Scrape Weidian (微店) products with lifetime units sold, price, stock and the seller's WeChat ID. 70 fields per product: SKU variants with price and stock, images, buyer reviews with rating breakdowns, shop credit and fans. Shop catalogues, keyword search, or trending with no link. No login.",
"version": "0.0",
"x-build-id": "QfG3l9XIaPwRYzH2f"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/zen-studio~weidian-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-zen-studio-weidian-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~weidian-scraper/runs": {
"post": {
"operationId": "runs-sync-zen-studio-weidian-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~weidian-scraper/run-sync": {
"post": {
"operationId": "run-sync-zen-studio-weidian-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": {
"urls": {
"title": "Shop or product links 🔗",
"maxItems": 200,
"type": "array",
"description": "Weidian shop links, product links, share links or plain numeric IDs. Mix them freely.
Accepted: weidian.com/s/1291401858, weidian.com/item.html?itemID=2586205997, weidian.com/i/7251012395, shop1291401858.v.weidian.com, k.youshop10.com/A4UTJswO.
Up to 200 links per run. Leave empty to browse trending products across Weidian instead, no link required.",
"items": {
"type": "string"
}
},
"keyword": {
"title": "Keyword (optional)",
"type": "string",
"description": "Search for products inside the shops you listed above. Works in Chinese (连衣裙, 洗脸巾) and often in English for brand names.
Leave empty to get each shop's full catalogue.
Note: this searches within the shops you provide. Weidian has no public catalogue-wide product search, so a keyword on its own cannot find shops you have not listed."
},
"maxItems": {
"title": "Max products (total)",
"minimum": 1,
"maximum": 100000,
"type": "integer",
"description": "Ceiling on the whole run, across every link. Keeps a long list of shops from running away with your budget.
Whichever runs out first, this or Max products per shop, stops the run."
},
"maxItemsPerShop": {
"title": "Max products per shop",
"minimum": 1,
"maximum": 10000,
"type": "integer",
"description": "Ceiling for each individual shop. Use it to sample many shops evenly instead of exhausting the first one.
Whichever runs out first, this or Max products (total), stops the run."
},
"sortBy": {
"title": "Sort products by",
"enum": [
"composite",
"sold",
"price",
"newest"
],
"type": "string",
"description": "Order products are collected in, which decides what you get when a cap cuts a large shop short.
Sold count is the usual choice for research: the shop's proven sellers come first."
},
"includeSellerInfo": {
"title": "Include shop details",
"type": "boolean",
"description": "Add the shop behind each product: name, seller name, logo, region, credit level and score, fans, repurchase rate, buyer review tags with vote counts, shop-wide offers and the date the shop opened.
Adds very little to a run's time. Leave on unless you only want bare product rows."
},
"includeSellerContact": {
"title": "Include seller contact",
"type": "boolean",
"description": "Add the seller's WeChat ID or mobile number and their WeChat QR code, where the seller publishes them.
Coverage: a WeChat ID or number is present on roughly 39% of shops and a QR code on about 96%. The rest simply do not publish one.
These belong to individual sellers rather than companies. Turn this off if you do not need them."
},
"includeSkus": {
"title": "Include variants (SKUs)",
"type": "boolean",
"description": "Add every size, colour and style option with its own price and stock, plus the list of variant axes and any instalment plans.
Trade-off: this adds noticeably to the time a large run takes. Leave off if product-level price and stock are enough."
},
"maxReviewsPerProduct": {
"title": "Reviews per product",
"minimum": 0,
"maximum": 500,
"type": "integer",
"description": "Add buyer reviews and a full rating breakdown: how many reviews are positive, neutral or negative, how many carry buyer photos, and how many are real written reviews.
0 turns reviews off. 20 is the cheapest useful setting and covers most products completely. Higher numbers cost more, see the pricing on the Actor page.
Each review brings the buyer's words, star rating, photos, the variant they bought and the seller's reply. Products with no reviews are never charged."
}
}
},
"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
}
}
}
}
}
}
}
}
}
}