{ "openapi": "3.0.1", "info": { "title": "Wildberries Reviews & Product Card Scraper (by URL)", "description": "Unofficial Wildberries scraper by product URL or ID, no login. Product card, specs, images, seller, rating, weekly price history, reviews with seller replies and Q&A. No reviewer names or IDs. No search or live price/stock.", "version": "0.1", "x-build-id": "adyExRvEPDlR5KjIt" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/kyungminlee~wildberries-product-reviews-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-kyungminlee-wildberries-product-reviews-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/kyungminlee~wildberries-product-reviews-scraper/runs": { "post": { "operationId": "runs-sync-kyungminlee-wildberries-product-reviews-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/kyungminlee~wildberries-product-reviews-scraper/run-sync": { "post": { "operationId": "run-sync-kyungminlee-wildberries-product-reviews-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": { "productUrls": { "title": "Product URLs or IDs", "type": "array", "description": "Wildberries product pages (https://www.wildberries.ru/catalog/684352087/detail.aspx, also wildberries.kz/.by/.am and global.wildberries.ru links) or numeric product IDs (nmId / артикул WB, e.g. 684352087). Each product is saved once per run. Keyword search is not supported: Wildberries protects its search with an anti-bot challenge.", "items": { "type": "string" } }, "includePriceHistory": { "title": "Include weekly price history", "type": "boolean", "description": "Add the weekly price points (RUB) that Wildberries publishes for the product, usually the last 2-3 months. This is the history as published, one point per week; it is not today's live price.", "default": true }, "includeSellerDetails": { "title": "Include seller company details", "type": "boolean", "description": "Add the seller's trademark and, for registered companies (ООО, АО, ТОО, LLC...), the company name, INN and OGRN. For sellers who are private persons (sole proprietors / ИП, self-employed) only the seller ID and shop trademark are kept, because their name is a person's name. The seller ID is always included.", "default": true }, "maxReviewsPerProduct": { "title": "Max reviews per product", "minimum": 0, "maximum": 2000, "type": "integer", "description": "Reviews to save for each product, newest first. 0 = no reviews (the product's rating and review counts are still included). Wildberries publishes at most about 1,000 newest reviews per product card, so higher values return everything available. Each review is a separate dataset item and a separate review event. Reviewer names, IDs and avatars are never collected.", "default": 20 }, "minReviewRating": { "title": "Minimum review rating", "minimum": 1, "maximum": 5, "type": "integer", "description": "Only save reviews with at least this many stars (1-5). Skipped reviews are not charged." }, "maxReviewRating": { "title": "Maximum review rating", "minimum": 1, "maximum": 5, "type": "integer", "description": "Only save reviews with at most this many stars (1-5), e.g. 2 to collect complaints only. Skipped reviews are not charged." }, "reviewsSince": { "title": "Only reviews written on or after", "type": "string", "description": "Only save reviews created on or after this date (YYYY-MM-DD, UTC). Older reviews are skipped and not charged. Handy for scheduled monitoring runs." }, "reviewsWithTextOnly": { "title": "Only reviews with text", "type": "boolean", "description": "Skip star-only reviews that have no text, pros or cons. Skipped reviews are not charged.", "default": false }, "reviewsOfThisVariantOnly": { "title": "Only reviews of this exact variant", "type": "boolean", "description": "Wildberries shows the reviews of all colour/size variants of a product card together, so by default a card's reviews are saved once, under one of its variants you entered (normally the first). Turn this on to keep only reviews written for the exact product ID you entered, separately for each variant.", "default": false }, "maxQuestionsPerProduct": { "title": "Max questions per product", "minimum": 0, "maximum": 3000, "type": "integer", "description": "Customer questions (with the seller's answers) to save for each product, newest first. 0 = no questions. Each question is a separate dataset item and a separate question event. Asker names and IDs are never collected.", "default": 0 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Not needed in most cases: the Actor reads Wildberries' public product and review files, which work from Apify's own servers. It paces requests with random jitter and backs off when Wildberries answers \"too many requests\". If you enable Apify Proxy (datacenter is enough), a new proxy session is used whenever Wildberries slows the run down.", "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 } } } } } } } } } }