{
  "openapi": "3.0.1",
  "info": {
    "title": "Wildberries Reviews Scraper · Парсер отзывов Wildberries",
    "description": "Wildberries product reviews and questions by article or link: text, pros, cons, rating, date, size, color, seller answers; no buyer data. Отзывы и вопросы о товарах Wildberries по артикулу или ссылке: текст, плюсы, минусы, оценка, дата, размер, цвет; без данных покупателей.",
    "version": "0.1",
    "x-build-id": "s1CofdADgMhHLBP2n"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/theshark~wildberries-reviews-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-theshark-wildberries-reviews-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/theshark~wildberries-reviews-scraper/runs": {
      "post": {
        "operationId": "runs-sync-theshark-wildberries-reviews-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/theshark~wildberries-reviews-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-theshark-wildberries-reviews-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": {
          "articles": {
            "title": "Article numbers · Артикулы",
            "type": "array",
            "description": "Wildberries article numbers (nmId). Every number gets its own summary row with a status, so an empty result never looks like a failure. Reviews are shared between colors of one product.<br><br>Артикулы Wildberries (nmId). У каждого — своя строка-сводка со статусом, поэтому пустой результат не выглядит как сбой. Отзывы общие у цветов одного товара.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "urls": {
            "title": "Product links · Ссылки на товары",
            "type": "array",
            "description": "Links to a product on wildberries.ru. Search, category and seller pages are not collected.<br><br>Ссылки на товар на wildberries.ru. Страницы поиска, категорий и продавцов не собираются.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "max_items": {
            "title": "Maximum reviews per run · Максимум отзывов за запуск",
            "minimum": 1,
            "maximum": 50000,
            "type": "integer",
            "description": "The run stops collecting at this number. You pay per review row; summary rows are free.<br><br>На этом числе запуск останавливается. Платите за строку отзыва; строки-сводки бесплатны.",
            "default": 1000
          },
          "reviews_per_product": {
            "title": "Reviews per product · Отзывов на товар",
            "minimum": 1,
            "maximum": 1000,
            "type": "integer",
            "description": "The newest ones. The site gives at most about 1000 newest reviews per product.<br><br>Самые новые. Сайт отдаёт не больше примерно 1000 новых отзывов на товар.",
            "default": 100
          },
          "with_text_only": {
            "title": "Only reviews with text · Только отзывы с текстом",
            "type": "boolean",
            "description": "About half of the reviews are only a rating. Turn off to get those rows too.<br><br>Около половины отзывов — только оценка. Выключите, чтобы получить и такие строки.",
            "default": true
          },
          "min_rating": {
            "title": "Rating from · Оценка от",
            "minimum": 1,
            "maximum": 5,
            "type": "integer",
            "description": "Optional. Only reviews rated this or higher, 1 to 5.<br><br>Необязательно. Только отзывы с этой оценкой и выше, от 1 до 5."
          },
          "max_rating": {
            "title": "Rating up to · Оценка до",
            "minimum": 1,
            "maximum": 5,
            "type": "integer",
            "description": "Optional. Only reviews rated this or lower, 1 to 5. Set both to 1 and 2 to read complaints.<br><br>Необязательно. Только отзывы с этой оценкой и ниже, от 1 до 5. Поставьте 1 и 2, чтобы читать жалобы."
          },
          "since": {
            "title": "Not earlier than · Не раньше",
            "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
            "type": "string",
            "description": "Optional. Only reviews and questions from this day on, like 2026-11-01. The site gives about 1000 newest reviews per product anyway.<br><br>Необязательно. Только отзывы и вопросы с этого дня, например 2026-11-01. Сайт и так отдаёт около 1000 новых отзывов на товар."
          },
          "with_photo_only": {
            "title": "Only reviews with photos · Только отзывы с фото",
            "type": "boolean",
            "description": "Only reviews where the buyer added photos. The photos themselves are not given, only their count.<br><br>Только отзывы, к которым покупатель приложил фото. Сами фото не отдаются, только их число.",
            "default": false
          },
          "with_questions": {
            "title": "Questions too · И вопросы",
            "type": "boolean",
            "description": "Also the newest questions about each product, a row per question, with the seller's answer. The asker's name is cut out of the answer.<br><br>Ещё и самые новые вопросы о каждом товаре, строка на вопрос, с ответом продавца. Имя спросившего из ответа вырезано.",
            "default": false
          },
          "questions_per_product": {
            "title": "Questions per product · Вопросов на товар",
            "minimum": 1,
            "maximum": 300,
            "type": "integer",
            "description": "The newest questions per product, when questions are asked for.<br><br>Самые новые вопросы на товар, если вопросы включены.",
            "default": 30
          },
          "only_new": {
            "title": "Only new reviews and questions · Только новые отзывы и вопросы",
            "type": "boolean",
            "description": "Returns only reviews and questions newer than the ones seen by earlier runs with the same store. The first run returns the newest up to the limits and remembers the dates. The site sends the whole review file even when nothing is new, so every checked product is charged as a product check.<br><br>Отдаёт только отзывы и вопросы новее тех, что видели прошлые запуски с тем же хранилищем. Первый запуск отдаёт самые новые до лимитов и запоминает даты. Сайт присылает файл отзывов целиком, даже если нового нет, поэтому каждый проверенный товар оплачивается как проверка товара.",
            "default": false
          },
          "seen_store": {
            "title": "Store of checked products · Хранилище проверенных товаров",
            "type": "string",
            "description": "Named key-value store in your account for the option above: only product IDs and dates. Change it to keep separate lists. A product not checked for 90 days is forgotten.<br><br>Именованное хранилище в вашем аккаунте для опции выше: только номера товаров и даты. Смените имя, чтобы вести отдельные списки. Товар, который 90 дней не проверяли, забывается.",
            "default": "wildberries-seen-reviews"
          },
          "sessions": {
            "title": "Sessions at once · Сессий одновременно",
            "minimum": 1,
            "maximum": 32,
            "type": "integer",
            "description": "How many anonymous visitors work at the same time, each with its own IP.<br><br>Сколько анонимных посетителей работают одновременно, у каждого свой IP.",
            "default": 8
          },
          "proxy": {
            "title": "Your own proxies · Свои прокси",
            "type": "string",
            "description": "Optional. One per line: user:pass@host:port. Without them the run uses its own Russian proxies.<br><br>Необязательно. По одному в строке: user:pass@host:port. Без них запуск идёт через свои российские прокси."
          },
          "output_language": {
            "title": "Language of the log and status · Язык лога и статуса",
            "enum": [
              "en",
              "ru"
            ],
            "type": "string",
            "description": "Wildberries's own data stays as the site gives it.<br><br>Данные Wildberries остаются такими, как их отдаёт сайт.",
            "default": "en"
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}