{
  "openapi": "3.0.1",
  "info": {
    "title": "Wildberries Scraper — Prices, Stock, Composition & Reviews",
    "description": "Scrape Wildberries search results, product cards and reviews: RUB prices, discounts, stock, per-size variants, composition, category, pet attributes, price per kg and review texts, with change tracking between runs.",
    "version": "0.1",
    "x-build-id": "7MKxkm2jhJ6tX0MFZ"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/blueskyscraper~wildberries-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-blueskyscraper-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/blueskyscraper~wildberries-scraper/runs": {
      "post": {
        "operationId": "runs-sync-blueskyscraper-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/blueskyscraper~wildberries-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-blueskyscraper-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": {
          "mode": {
            "title": "🧭 What to scrape",
            "enum": [
              "search",
              "category",
              "product",
              "details",
              "reviews"
            ],
            "type": "string",
            "description": "🔍 Search: product rows for keywords, in Wildberries' own order. 🗂️ Categories: the same rows for Wildberries catalog pages (category links), in the category's own order — discovery without keywords. 📦 Product cards: one full row per product id or URL, with price, stock and per-size variants. 📇 Card details only: composition, attributes, rating and the product's variant group for long id lists — fast and cheap, no browser, but no price or stock. ⭐ Reviews: review rows for product ids.",
            "default": "search"
          },
          "searchQueries": {
            "title": "🔍 Search keywords",
            "type": "array",
            "description": "Keywords in Russian as a shopper types them, e.g. <code>сухой корм для собак</code> or <code>сублимированный корм</code>. Up to 20 keywords per run. Used by 🔍 Search.",
            "items": {
              "type": "string"
            }
          },
          "categoryUrls": {
            "title": "🗂️ Category URLs",
            "type": "array",
            "description": "Wildberries catalog links, e.g. <code>https://www.wildberries.ru/catalog/aksessuary/tovary-dlya-zhivotnyh/korm-dlya-zhivotnyh</code> (Pet food & treats for dogs). Copy the link from the site's catalog menu. Filters in the link (brand <code>fbrand=</code>, price, etc.) are applied; <code>sort=</code> in the link is used when ↕️ Sort order is left at Popular. Up to 20 links per run. Used by 🗂️ Categories.",
            "items": {
              "type": "string"
            }
          },
          "searchPages": {
            "title": "📄 Pages per keyword or category",
            "minimum": 1,
            "maximum": 100,
            "type": "integer",
            "description": "Wildberries shows about 100 products per page, for keywords and categories alike. The run stops earlier when results end (a repeated last page is detected) or 💯 Max products is reached.",
            "default": 1
          },
          "sort": {
            "title": "↕️ Sort order",
            "enum": [
              "popular",
              "rate",
              "priceup",
              "pricedown",
              "newly"
            ],
            "type": "string",
            "description": "Order of search and category results, as on the site.",
            "default": "popular"
          },
          "productIds": {
            "title": "📦 Product ids or URLs",
            "type": "array",
            "description": "Wildberries article numbers (nmId), e.g. <code>559646349</code>, or product URLs like <code>https://www.wildberries.ru/catalog/559646349/detail.aspx</code>. Used by 📦 Product cards, 📇 Card details and ⭐ Reviews.",
            "items": {
              "type": "string"
            }
          },
          "maxItems": {
            "title": "💯 Max products",
            "minimum": 1,
            "maximum": 10000,
            "type": "integer",
            "description": "Upper limit of product rows for the whole run. Reviews are limited separately.",
            "default": 100
          },
          "includeCardDetails": {
            "title": "🧾 Composition, category and pet attributes",
            "type": "boolean",
            "description": "Adds composition, category, animal (dog/cat), feed type (dry/wet/treat), life stage, animal size, purpose claims, flavor, net weight and the seller's description from the product's public card. No extra charge.",
            "default": true
          },
          "includeRating": {
            "title": "⭐ Rating in Card details mode",
            "type": "boolean",
            "description": "📇 Card details only: adds the rating, review count and the star distribution of every variant in the group (one extra request per product group).",
            "default": true
          },
          "includeReviews": {
            "title": "⭐ Add reviews to products",
            "type": "boolean",
            "description": "After each product row, writes its newest reviews as separate review rows (charged per review).",
            "default": false
          },
          "maxReviews": {
            "title": "⭐ Max reviews per product",
            "minimum": 0,
            "maximum": 1000,
            "type": "integer",
            "description": "Newest first. Wildberries serves roughly the latest 1,000 reviews of a product; older history is not available from the site.",
            "default": 20
          },
          "reviewsSince": {
            "title": "📅 Only reviews since",
            "type": "string",
            "description": "Optional date (YYYY-MM-DD). Only reviews created on or after it are returned — use it for daily incremental collection."
          },
          "outputFormat": {
            "title": "🗜️ Output format",
            "enum": [
              "full",
              "compact"
            ],
            "type": "string",
            "description": "Full: every row carries the data-contract blocks (metrics with units and absence reasons, provenance with run id, checksum and timestamps). Compact: the same data fields without those blocks and without long seller texts — several times smaller for exports of tens of thousands of rows.",
            "default": "full"
          },
          "snapshotId": {
            "title": "🏷️ Snapshot id",
            "type": "string",
            "description": "Optional label of this snapshot (e.g. the date). Written into provenance of every row so snapshots can be compared."
          },
          "panelId": {
            "title": "🏷️ Panel id / version",
            "type": "string",
            "description": "Optional id of your fixed product panel (e.g. wb-dogfood-v3). Written into provenance of every row."
          },
          "queryId": {
            "title": "🏷️ Query id / version",
            "type": "string",
            "description": "Optional id of your search profile version. Written into provenance of every row."
          },
          "previousDatasetId": {
            "title": "🔁 Previous dataset id (change tracking)",
            "type": "string",
            "description": "Dataset id of an earlier run. Each product then gets previousPrice, priceChange, stockChanged, ratingCountDelta and isNew against that snapshot. Pick the dataset of your earlier run of this Actor (or paste its ID) — the Actor gets read-only access to that one dataset. Left empty or unreadable, the run still returns all data, just without the change fields."
          },
          "requestDelaySecs": {
            "title": "⏱️ Delay between pages (seconds)",
            "minimum": 0,
            "maximum": 30,
            "type": "integer",
            "description": "Pause between pages or products. Raise it if the site starts refusing requests.",
            "default": 1
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}