{ "openapi": "3.0.1", "info": { "title": "Wildberries Scraper", "description": "Scrapes Wildberries products by keyword, category or product link: prices in roubles, rating, reviews count, brand, seller, stock, sizes and images, with optional descriptions, characteristics and reviews.", "version": "0.0", "x-build-id": "Kx9SCPee5zJ6Zj1rO" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/mina_safwat~wildberries-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-mina_safwat-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/mina_safwat~wildberries-scraper/runs": { "post": { "operationId": "runs-sync-mina_safwat-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/mina_safwat~wildberries-scraper/run-sync": { "post": { "operationId": "run-sync-mina_safwat-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": { "searchQueries": { "title": "Search keywords", "type": "array", "description": "Words to search Wildberries for, one per line, such as чайник or iphone 17. Each keyword returns products in the order Wildberries shows them for the sort chosen below. Add keywords here, links below, or both.", "default": [], "items": { "type": "string" } }, "startUrls": { "title": "Wildberries links", "type": "array", "description": "Links copied from wildberries.ru, one per line: a product (https://www.wildberries.ru/catalog/8781920/detail.aspx, or just its number 8781920), a search (https://www.wildberries.ru/catalog/0/search.aspx?search=чайник), a category (https://www.wildberries.ru/catalog/elektronika/smartfony-i-telefony/vse-smartfony), a brand (https://www.wildberries.ru/brands/apple) or a seller (https://www.wildberries.ru/seller/33172). Filters and the sort order in a search, category or brand link are kept. Product links from wildberries.kz, .by, .am, .uz and other Wildberries sites work too.", "default": [], "items": { "type": "string" } }, "maxProducts": { "title": "Max products per keyword or link", "minimum": 1, "type": "integer", "description": "Stops each keyword, search, category, brand or seller after this many products. Wildberries pages hold 100 products each. Product links always give one product each.", "default": 100 }, "sort": { "title": "Sort by", "enum": [ "popular", "rate", "priceup", "pricedown", "newly", "benefit" ], "type": "string", "description": "The order for keywords and listing links. A link that already has a sort order (…&sort=priceup) keeps its own.", "default": "popular" }, "includeDetails": { "title": "Add description and characteristics", "type": "boolean", "description": "Adds each product's description, characteristics table, vendor code, the ids of its other colour variants, and when its card was created. Slightly slower: one more request per product.", "default": false }, "includeReviews": { "title": "Add reviews", "type": "boolean", "description": "Adds the newest reviews of each product (rating, text, pros, cons, date, colour and size bought, likes and the seller's answer). Reviewers' names are not saved. Wildberries shares reviews across all colour variants of a product.", "default": false }, "maxReviewsPerProduct": { "title": "Max reviews per product", "minimum": 1, "maximum": 1000, "type": "integer", "description": "How many of the newest reviews to add to each product when reviews are on. Wildberries publishes up to about 1,000 per product.", "default": 20 }, "currency": { "title": "Currency", "enum": [ "rub", "kzt", "byn", "amd", "uzs", "kgs" ], "type": "string", "description": "The currency prices are shown in, as on the matching Wildberries country site.", "default": "rub" }, "dest": { "title": "Delivery region (dest)", "type": "integer", "description": "Wildberries' number for the delivery address, which decides stock, delivery and some prices. The default, -1257786, is Moscow. To use another address, open wildberries.ru, choose the address, and copy the dest=… number from any request the page makes.", "default": -1257786 } } }, "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 } } } } } } } } } }