{
  "openapi": "3.0.1",
  "info": {
    "title": "Wildberries Product Scraper: Specs, Ratings, Rank | Парсер WB",
    "description": "Scrape Wildberries products by keyword, link, brand, category or article number: full specs, seller company and INN, ratings, review counts, recorded price history and search rank. Track new and changed products on a schedule. Парсер товаров Вайлдберриз для аналитики.",
    "version": "1.5",
    "x-build-id": "LAXSgsmL4Xj3GzrvA"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/getascraper~wildberries-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-getascraper-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/getascraper~wildberries-scraper/runs": {
      "post": {
        "operationId": "runs-sync-getascraper-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/getascraper~wildberries-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-getascraper-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": {
          "nmIds": {
            "title": "Product articles (NM-IDs)",
            "type": "array",
            "description": "Numeric Wildberries article numbers, for example 209928876. Use this for a known product list. A product that is also found by another source is saved once.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "startUrls": {
            "title": "Wildberries links",
            "type": "array",
            "description": "Product links, search links, or category page links from wildberries.ru. A category link is searched by its category name and narrowed to that category.",
            "default": [],
            "items": {
              "type": "object",
              "required": [
                "url"
              ],
              "properties": {
                "url": {
                  "type": "string",
                  "title": "URL of a web page",
                  "format": "uri"
                }
              }
            }
          },
          "searchQueries": {
            "title": "Search keywords",
            "type": "array",
            "description": "Russian or English keywords, for example \"платье женское\" or \"wireless headphones\". Wildberries returns at most about 300 products per keyword.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "brands": {
            "title": "Brands",
            "type": "array",
            "description": "Brand names, for example \"Nike\". Each brand is searched and only products of exactly that brand are kept. Combined with categories below, every brand and category pair is searched.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "categories": {
            "title": "Categories",
            "type": "array",
            "description": "Category names such as \"Наушники беспроводные\", or category page paths such as /catalog/elektronika/igry-i-razvlecheniya/aksessuary/garnitury/naushniki-besprovodnye. Only products of that category are kept.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "queryModifiers": {
            "title": "Keyword variations",
            "type": "array",
            "description": "Extra words added to each search keyword to reach past the 300 product limit, for example \"красный\" or \"для дома\". Each keyword is searched once plain and once per variation.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "includeLivePrice": {
            "title": "Live price and stock",
            "type": "boolean",
            "description": "Try to add the current sale price, pre-discount price, discount percent and stock for each product, when Wildberries serves them anonymously. Availability depends on Wildberries and may be empty.",
            "default": false
          },
          "includeSeller": {
            "title": "Seller details",
            "type": "boolean",
            "description": "Add the seller name, registered company name, tax number (INN), registration number, trademark and country to each product.",
            "default": false
          },
          "includeRatings": {
            "title": "Ratings and review counts",
            "type": "boolean",
            "description": "Add the product rating, total review count, reviews with photo, video or text, and the 1 to 5 star breakdown.",
            "default": false
          },
          "includePriceHistory": {
            "title": "Price history",
            "type": "boolean",
            "description": "Add the recorded price history (date and price in rubles) when Wildberries publishes one. Only some products have it. This is not a live price.",
            "default": false
          },
          "language": {
            "title": "Text language",
            "enum": [
              "ru",
              "en"
            ],
            "type": "string",
            "description": "Language of product names, descriptions, categories and specifications. English is the machine translation published by Wildberries.",
            "default": "ru"
          },
          "sellerIds": {
            "title": "Seller IDs",
            "type": "array",
            "description": "Keep only products sold by these Wildberries seller IDs, for example 4026538.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "keywords": {
            "title": "Must mention",
            "type": "array",
            "description": "Keep only products whose name, description or specifications contain at least one of these words.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "minRating": {
            "title": "Minimum rating",
            "minimum": 0,
            "maximum": 5,
            "type": "number",
            "description": "Keep products rated at least this many stars (0 to 5). Products without reviews are dropped when this is above 0.",
            "default": 0
          },
          "minFeedbacks": {
            "title": "Minimum review count",
            "minimum": 0,
            "maximum": 1000000,
            "type": "integer",
            "description": "Keep products with at least this many reviews. Set 0 to keep all.",
            "default": 0
          },
          "monitorName": {
            "title": "Monitor name",
            "type": "string",
            "description": "Turn on change tracking: name this watch (letters, numbers and dashes), then run it again on a schedule. Every product is marked NEW, UPDATED or UNCHANGED against the previous run, with rating, review count, recorded price and search rank changes. Leave empty for a normal run."
          },
          "onlyChanges": {
            "title": "Only new and changed products",
            "type": "boolean",
            "description": "With a monitor name, save only NEW and UPDATED products. Unchanged products are checked but not saved or charged.",
            "default": false
          },
          "maxItems": {
            "title": "Maximum products",
            "minimum": 0,
            "maximum": 10000,
            "type": "integer",
            "description": "Cap on saved products across all sources. Set 0 for no cap. Free plan runs are limited to 25.",
            "default": 25
          },
          "proxyConfiguration": {
            "title": "Proxy configuration",
            "type": "object",
            "description": "Optional. The Actor connects directly first. If Wildberries stops answering, it switches to your proxy, then to Apify Proxy automatically.",
            "default": {
              "useApifyProxy": false
            }
          },
          "region": {
            "title": "Delivery destination label",
            "enum": [
              "MOSCOW",
              "KRASNODAR",
              "NOVOSIBIRSK",
              "EKATERINBURGO",
              "KAZAHSTAN",
              "ST_PETERSBURG"
            ],
            "type": "string",
            "description": "Label stored on each row. Wildberries does not publish destination-specific data anonymously, so it does not change the results.",
            "default": "MOSCOW"
          },
          "sort": {
            "title": "Listing sort",
            "enum": [
              "popular",
              "rate",
              "priceup",
              "pricedown",
              "newly",
              "benefit"
            ],
            "type": "string",
            "description": "No effect at the moment: products come in the order Wildberries ranks them for the keyword.",
            "default": "popular"
          },
          "lowPrice": {
            "title": "Minimum price (RUB)",
            "minimum": 0,
            "maximum": 10000000,
            "type": "integer",
            "description": "Keep products whose live sale price is at least this many rubles. Applies only to products that return a live price (needs \"Live price and stock\" on). Set 0 to keep all.",
            "default": 0
          },
          "topPrice": {
            "title": "Maximum price (RUB)",
            "minimum": 0,
            "maximum": 10000000,
            "type": "integer",
            "description": "Keep products whose live sale price is at most this many rubles. Applies only to products that return a live price (needs \"Live price and stock\" on). Set 0 to keep all.",
            "default": 0
          },
          "discount": {
            "title": "Minimum discount (%)",
            "minimum": 0,
            "maximum": 100,
            "type": "integer",
            "description": "Keep products discounted by at least this percent off the pre-discount price. Applies only to products that return a live price (needs \"Live price and stock\" on). Set 0 to keep all.",
            "default": 0
          },
          "debugLogging": {
            "title": "Verbose run logs",
            "type": "boolean",
            "description": "Add extra detail to the run log. Leave off for normal runs.",
            "default": 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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}