{ "openapi": "3.0.1", "info": { "title": "Wildberries Scraper — Products & Reviews | Парсер Вайлдберриз", "description": "Scrape Wildberries products, prices, reviews and card details as clean JSON. Russian marketplace (wildberries.ru): search by keyword or pull product IDs, region-pinned pricing, price history, specs, seller details, newest reviews. Парсер Вайлдберриз: товары, цены, история цен, отзывы.", "version": "0.1", "x-build-id": "tgkb1Z8kWYmUUHdU1" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/actorforgehq~wildberries-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-actorforgehq-wildberries-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/actorforgehq~wildberries-scraper/runs": { "post": { "operationId": "runs-sync-actorforgehq-wildberries-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/actorforgehq~wildberries-scraper/run-sync": { "post": { "operationId": "run-sync-actorforgehq-wildberries-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": { "queries": { "title": "Search queries", "type": "array", "description": "Wildberries search phrases, e.g. \"headphones\". Each is resolved to a catalog of products. Russian phrases match the catalogue best, since that is the language Wildberries indexes.", "items": { "type": "string" } }, "productIds": { "title": "Product IDs (nmId)", "type": "array", "description": "Specific Wildberries product ids to fetch full cards for. Use this when you already know the articles you track; it skips search entirely and is the cheapest way to refresh a fixed basket.", "items": { "type": "string" } }, "includeDetails": { "title": "Include product details", "type": "boolean", "description": "Also fetch each product's description, specification list, category, seller's legal details and Wildberries' own price history. Three small requests per product go to Wildberries' static card storage, which needs no anti-bot token. Part of the product event, no separate charge.", "default": false }, "includeReviews": { "title": "Include reviews", "type": "boolean", "description": "Also fetch product reviews. Reviews are written as separate dataset rows and billed as a separate event, so runs that leave this off never pay for review capacity.", "default": false }, "maxReviewsPerProduct": { "title": "Max reviews per product", "minimum": 1, "type": "integer", "description": "How many of the most recent reviews to keep per product when \"Include reviews\" is on. Wildberries returns at most 1000 reviews per product in total, newest first.", "default": 20 }, "dest": { "title": "Destination (region code)", "type": "string", "description": "Wildberries geo `dest` code affecting price and availability. Leave empty for the default region (Moscow). Pin one region per run so a price time series stays comparable." }, "maxItems": { "title": "Max items", "minimum": 1, "type": "integer", "description": "Hard cap on scraped products, applied per search query and to the list of article numbers. Reviews are not counted against it — use Max reviews per product to cap those.", "default": 100 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Optional. Wildberries is fetched from the container's own address by default, which is free and fastest. Turn a proxy on only if you need a specific region: the whole run then goes through one sticky session, because the Wildberries anti-bot token is bound to the exit address.", "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 } } } } } } } } } }