{
"openapi": "3.0.1",
"info": {
"title": "Wildberries Scraper - Products, Prices & Sellers",
"description": "Scrape Wildberries (wildberries.ru) by keyword or product URL: price, discount, stock, delivery time, rating, reviews, search position, full description, characteristics, weekly price history and seller details. No API key. Independent tool, not affiliated with Wildberries.",
"version": "0.1",
"x-build-id": "jFlDQSghhfvpnrSBa"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/scrapesage~wildberries-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-scrapesage-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/scrapesage~wildberries-scraper/runs": {
"post": {
"operationId": "runs-sync-scrapesage-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/scrapesage~wildberries-scraper/run-sync": {
"post": {
"operationId": "run-sync-scrapesage-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 terms",
"type": "array",
"description": "Product search terms, one per line, in Russian or English (e.g. ноутбук or laptop). Each term returns products in Wildberries' own search order, with their position. Leave this and Product URLs empty and the run returns a small free sample.",
"items": {
"type": "string"
}
},
"searchQueriesFromFile": {
"title": "Import search terms from a file",
"type": "string",
"description": "Bulk-load search terms. Either paste the whole list (one per line), or give a single link to a public .txt/.csv, a Google Sheet/Drive link, or an Apify key-value-store record. A file that cannot be read says so and charges nothing."
},
"productUrls": {
"title": "Product URLs or article numbers",
"type": "array",
"description": "Specific products to scrape: a product link (https://www.wildberries.ru/catalog/169684889/detail.aspx) or just its article number (169684889), one per line. Handy for price and stock monitoring of a fixed list.",
"items": {
"type": "string"
}
},
"productUrlsFromFile": {
"title": "Import product URLs from a file",
"type": "string",
"description": "Bulk-load product links or article numbers: paste the list (one per line) or give a single link to a public .txt/.csv, a Google Sheet/Drive link, or an Apify key-value-store record. A file that cannot be read says so and charges nothing."
},
"sort": {
"title": "Sort search results by",
"enum": [
"popular",
"rate",
"priceup",
"pricedown",
"newly"
],
"type": "string",
"description": "The order Wildberries returns search results in. Applies to search terms.",
"default": "popular"
},
"minPrice": {
"title": "Minimum price",
"minimum": 0,
"type": "integer",
"description": "Only products whose current price is at least this much, in the chosen currency. Applies to search terms. Leave empty for no lower limit."
},
"maxPrice": {
"title": "Maximum price",
"minimum": 0,
"type": "integer",
"description": "Only products whose current price is at most this much, in the chosen currency. Applies to search terms. Leave empty for no upper limit."
},
"currency": {
"title": "Currency",
"enum": [
"rub",
"usd",
"eur",
"kzt",
"byn"
],
"type": "string",
"description": "Currency for prices (and for the minimum / maximum price filter). Wildberries converts the prices itself. The weekly price history is always in rubles.",
"default": "rub"
},
"maxItemsPerQuery": {
"title": "Max products per search term",
"minimum": 1,
"maximum": 10000,
"type": "integer",
"description": "How many products to collect for each search term (100 per result page).",
"default": 100
},
"maxItems": {
"title": "Max products (total)",
"minimum": 1,
"type": "integer",
"description": "Overall cap across all search terms and product URLs. When several search terms share it, each gets a fair share. You are only charged for products actually saved.",
"default": 1000
},
"includeDetails": {
"title": "Include full product and seller details",
"type": "boolean",
"description": "Adds the full description, characteristics, category, seller article code, listing date, weekly price history, and seller details (seller type, trademark, registration date, items sold, reviews; legal name, tax id, address and email for companies). Same price per product. Untick for the leanest, fastest export.",
"default": true
},
"outputFields": {
"title": "Output fields (leave empty for all)",
"type": "array",
"description": "Pick the fields you want and every record is trimmed to exactly those - handy for lean CSV/Sheets exports.",
"items": {
"type": "string",
"enum": [
"type",
"id",
"title",
"url",
"brand",
"brandId",
"price",
"salePrice",
"discountPct",
"currency",
"rating",
"reviewCount",
"reviewRewardPoints",
"inStock",
"stockQuantity",
"deliveryHours",
"estimatedDeliveryDate",
"supplier",
"supplierId",
"supplierRating",
"image",
"images",
"imageCount",
"colors",
"sizes",
"isNew",
"position",
"query",
"searchResultsTotal",
"imtId",
"subjectId",
"subjectParentId",
"category",
"parentCategory",
"vendorCode",
"description",
"characteristics",
"packageContents",
"colorName",
"variantIds",
"hasVideo",
"listedAt",
"cardUpdatedAt",
"priceHistory",
"sellerType",
"sellerTrademark",
"sellerLegalName",
"sellerTaxId",
"sellerRegistrationNumber",
"sellerLegalAddress",
"sellerEmail",
"sellerRegisteredAt",
"sellerSalesCount",
"sellerReviewCount",
"detailsFetched",
"scrapedAt"
],
"enumTitles": [
"Record type (type)",
"Article number (id)",
"Title (title)",
"URL (url)",
"Brand (brand)",
"Brand id (brandId)",
"List price (price)",
"Current price (salePrice)",
"Discount % (discountPct)",
"Currency (currency)",
"Rating (rating)",
"Review count (reviewCount)",
"Points for a review (reviewRewardPoints)",
"In stock (inStock)",
"Units in stock (stockQuantity)",
"Delivery time, hours (deliveryHours)",
"Estimated delivery date (estimatedDeliveryDate)",
"Seller (supplier)",
"Seller id (supplierId)",
"Seller rating (supplierRating)",
"Main image (image)",
"All images (images)",
"Image count (imageCount)",
"Colors (colors)",
"Sizes (sizes)",
"New arrival (isNew)",
"Search position (position)",
"Search term (query)",
"Search results total (searchResultsTotal)",
"Product group id (imtId)",
"Subject id (subjectId)",
"Parent subject id (subjectParentId)",
"Category (category)",
"Parent category (parentCategory)",
"Seller article code (vendorCode)",
"Description (description)",
"Characteristics (characteristics)",
"Package contents (packageContents)",
"Color name (colorName)",
"Color variant ids (variantIds)",
"Has video (hasVideo)",
"Listed at (listedAt)",
"Card updated at (cardUpdatedAt)",
"Weekly price history, RUB (priceHistory)",
"Seller type (sellerType)",
"Seller trademark (sellerTrademark)",
"Seller legal name (sellerLegalName)",
"Seller tax id (sellerTaxId)",
"Seller registration number (sellerRegistrationNumber)",
"Seller legal address (sellerLegalAddress)",
"Seller email (sellerEmail)",
"Seller registered at (sellerRegisteredAt)",
"Seller items sold (sellerSalesCount)",
"Seller review count (sellerReviewCount)",
"Details fetched (detailsFetched)",
"Scraped at (scrapedAt)"
]
}
},
"dest": {
"title": "Delivery region code (advanced)",
"type": "string",
"description": "Wildberries delivery-region id used for prices, stock and delivery time. Default -1257786 (Moscow). Leave as-is unless you need another region."
},
"proxyConfiguration": {
"title": "Proxy",
"type": "object",
"description": "Leave on the default: the Actor picks the right Apify Proxy lane by itself (datacenter first, residential only as a fallback). A specific proxy you choose here is used as-is.",
"default": {
"useApifyProxy": true
}
}
}
},
"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
}
}
}
}
}
}
}
}
}
}