{ "openapi": "3.0.1", "info": { "title": "Wildberries Niche Analyzer: аналитика ниш WB", "description": "Analyze any Wildberries (Вайлдберриз) keyword or category as a market: seller and brand counts, competition concentration (HHI), price min/avg/median/max, rating and review distributions, and in-stock rate. One aggregate row per niche for product research and competitor analysis.", "version": "0.2", "x-build-id": "hAqhDBpWQyxGTD4wZ" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/getascraper~wildberries-niche-analyzer/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-getascraper-wildberries-niche-analyzer", "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/getascraper~wildberries-niche-analyzer/runs": { "post": { "operationId": "runs-sync-getascraper-wildberries-niche-analyzer", "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/getascraper~wildberries-niche-analyzer/run-sync": { "post": { "operationId": "run-sync-getascraper-wildberries-niche-analyzer", "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": { "keywords": { "title": "Keywords / niches to analyze", "type": "array", "description": "One product keyword per niche, in Russian or English (e.g. \"робот пылесос\", \"wireless earbuds\"). You get ONE market-summary row per keyword. Add several to compare niches side by side in a single run. At least one keyword is required.", "default": [ "пылесос" ], "items": { "type": "string" } }, "maxProductsPerQuery": { "title": "Sample size per niche", "minimum": 20, "maximum": 300, "type": "integer", "description": "How many discovered candidate products to fetch full details for, per keyword. Wildberries' public discovery endpoint returns at most about 300 candidates per keyword no matter what you request, so values above 300 buy nothing - this only controls how many of those candidates get resolved (more = a more complete seller/brand picture, but more requests and a longer run).", "default": 300 }, "priceMinRub": { "title": "Price band: minimum (RUB) - currently unavailable", "minimum": 0, "type": "integer", "description": "Currently has no effect. Wildberries blocked the API this Actor used for live prices, and its replacement carries no price data at all, so there is nothing left to filter on. Kept only for backward compatibility with existing input presets; see the README for details." }, "priceMaxRub": { "title": "Price band: maximum (RUB) - currently unavailable", "minimum": 0, "type": "integer", "description": "Currently has no effect, for the same reason as the minimum above. Kept only for backward compatibility with existing input presets." }, "region": { "title": "Warehouse region", "enum": [ "MOSCOW", "KRASNODAR", "NOVOSIBIRSK", "EKATERINBURGO", "KAZAHSTAN", "ST_PETERSBURG" ], "type": "string", "description": "Kept for output labeling and forward compatibility. Wildberries' current discovery and product-metadata sources don't take a region parameter, so this no longer changes which products are sampled - it's written to each output row so you can still tag which region a run was meant for.", "default": "MOSCOW" }, "topN": { "title": "Top sellers/brands to list", "minimum": 1, "maximum": 50, "type": "integer", "description": "How many of the leading sellers and brands to include in each niche row (ranked by product count), so you can see who dominates the market.", "default": 5 }, "debugLogging": { "title": "Verbose debug logs", "type": "boolean", "description": "Print per-niche aggregation details to the run log. Handy for troubleshooting; leave off for normal runs.", "default": false }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Proxy is required: Wildberries returns HTTP 429 on unproxied requests. Residential (the default) is the verified-working tier for this Actor's current data sources. Wildberries' dynamic search/card API is now blocked outright on every proxy tier (see README); if that ever changes, datacenter may become viable again for lower cost.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } } }, "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 } } } } } } } } } }