{
  "openapi": "3.0.1",
  "info": {
    "title": "Wildberries Scraper",
    "description": "Scrape Wildberries.ru - Russia's largest online marketplace. Search by keyword, browse by category, or fetch full product details (price, rating, description, characteristics, images) by article number or product URL.",
    "version": "1.0",
    "x-build-id": "4GzTeG4jg2xjOiA00"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/crawlerbros~wildberries-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-crawlerbros-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/crawlerbros~wildberries-scraper/runs": {
      "post": {
        "operationId": "runs-sync-crawlerbros-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/crawlerbros~wildberries-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-crawlerbros-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",
        "required": [
          "mode",
          "proxyConfiguration"
        ],
        "properties": {
          "mode": {
            "title": "Mode",
            "enum": [
              "search",
              "byCategory",
              "productDetails",
              "reviews"
            ],
            "type": "string",
            "description": "What to fetch.",
            "default": "search"
          },
          "searchQuery": {
            "title": "Search query (mode=search)",
            "type": "string",
            "description": "Free-text keyword search, e.g. `iphone`, `кроссовки nike`."
          },
          "category": {
            "title": "Category (mode=byCategory)",
            "enum": [
              "женские блузки и рубашки",
              "женские брюки",
              "женская верхняя одежда",
              "детская обувь",
              "обувь для девочек",
              "обувь для мальчиков",
              "детское белье",
              "детские блузки и рубашки",
              "детские брюки и шорты",
              "мужские брюки",
              "мужская верхняя одежда",
              "мужские джемперы и кардиганы",
              "аксессуары для туалета",
              "держатели для дома",
              "корзинки для дома",
              "средства для бритья",
              "средства для ванны и душа",
              "средства для макияжа",
              "аксессуары для волос",
              "аксессуары для одежды",
              "ноутбуки",
              "спортивные кроссовки",
              "игрушки антистресс",
              "игрушки для малышей",
              "бизиборды игровые центры",
              "кровати",
              "шкафы",
              "диваны",
              "женские платья и сарафаны",
              "женские футболки и топы",
              "мужские джинсы",
              "автомобильные шины",
              "автомобили",
              "художественная литература",
              "проза книги",
              "подвески и шармы",
              "колье цепи шнурки",
              "грунты для растений",
              "семена овощей",
              "рыбий жир омега",
              "витамин D",
              "блокноты канцтовары",
              "ежедневники записные книжки",
              "товары для кошек",
              "корм и лакомства для животных",
              "техника для приготовления блюд",
              "техника для приготовления напитков"
            ],
            "type": "string",
            "description": "Pick a popular category, or use `categoryCustom` below for any other category (in Russian, as it appears on wildberries.ru).",
            "default": "женские платья и сарафаны"
          },
          "categoryCustom": {
            "title": "Custom category (mode=byCategory, overrides dropdown)",
            "type": "string",
            "description": "Any other category name, in Russian, not covered by the dropdown above (e.g. `детские велосипеды`)."
          },
          "productIds": {
            "title": "Article IDs / product URLs (mode=productDetails / reviews)",
            "type": "array",
            "description": "Wildberries article numbers (nmId, e.g. `863160611`) or full product URLs (e.g. `https://www.wildberries.ru/catalog/863160611/detail.aspx`).",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "sortBy": {
            "title": "Sort order (mode=search / byCategory)",
            "enum": [
              "",
              "popular",
              "newly",
              "rate",
              "priceup",
              "pricedown"
            ],
            "type": "string",
            "description": "How Wildberries should order results.",
            "default": ""
          },
          "minPrice": {
            "title": "Min price (RUB)",
            "minimum": 0,
            "maximum": 100000000,
            "type": "integer",
            "description": "Drop products cheaper than this (in Russian rubles)."
          },
          "maxPrice": {
            "title": "Max price (RUB)",
            "minimum": 0,
            "maximum": 100000000,
            "type": "integer",
            "description": "Drop products more expensive than this (in Russian rubles)."
          },
          "minRating": {
            "title": "Min rating",
            "minimum": 0,
            "maximum": 5,
            "type": "integer",
            "description": "Drop products with a customer rating below this (0-5). In mode=reviews, filters individual reviews by their star rating instead."
          },
          "inStockOnly": {
            "title": "In stock only",
            "type": "boolean",
            "description": "Only emit products that currently have stock available.",
            "default": false
          },
          "brand": {
            "title": "Brand contains",
            "type": "string",
            "description": "Only emit products whose brand name contains this text (case-insensitive)."
          },
          "includeImages": {
            "title": "Include image URLs",
            "type": "boolean",
            "description": "Resolve and attach product image URLs. Adds a small number of extra CDN lookups per product.",
            "default": true
          },
          "includeReviews": {
            "title": "Include rating breakdown (mode=productDetails)",
            "type": "boolean",
            "description": "Attach the real aggregate review data (average rating, per-star distribution, review counts) to each product-details record. Adds one extra lookup per product.",
            "default": true
          },
          "includeSellerInfo": {
            "title": "Include seller/shop info (mode=productDetails)",
            "type": "boolean",
            "description": "Attach the seller's registered shop name, legal name, and address to each product-details record. Adds one extra lookup per unique seller.",
            "default": true
          },
          "maxItems": {
            "title": "Max items",
            "minimum": 1,
            "maximum": 2000,
            "type": "integer",
            "description": "Hard cap on emitted records.",
            "default": 50
          },
          "proxyConfiguration": {
            "title": "Proxy configuration",
            "type": "object",
            "description": "search.wb.ru is reachable without a proxy under normal conditions; the free Apify AUTO group (datacenter, zero extra cost) is wired in as an automatic fallback for the rare sustained-429 edge burst so a single blocked run can't return zero results.",
            "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
                  }
                }
              },
              "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}