{
  "openapi": "3.0.1",
  "info": {
    "title": "Wildberries Niche Analyzer · Анализ ниши Wildberries",
    "description": "Size up a Wildberries niche by keyword, category, shop or brand: brands and sellers with shares, concentration, prices, ratings, reviews. Анализ ниши Wildberries по запросу, категории, магазину или бренду: бренды и продавцы с долями, концентрация, цены, рейтинги, отзывы.",
    "version": "0.1",
    "x-build-id": "zkHy8H4fD2ehtIaFN"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/theshark~wildberries-niche-analyzer/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-theshark-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/theshark~wildberries-niche-analyzer/runs": {
      "post": {
        "operationId": "runs-sync-theshark-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/theshark~wildberries-niche-analyzer/run-sync": {
      "post": {
        "operationId": "run-sync-theshark-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": {
          "queries": {
            "title": "Search words · Слова поиска",
            "type": "array",
            "description": "Keywords as a buyer types them on the site. Every keyword is one niche and one row.<br><br>Слова, как их набирает покупатель на сайте. Каждое слово — одна ниша и одна строка.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "urls": {
            "title": "Category, search, shop or brand links · Ссылки на категорию, поиск, магазин или бренд",
            "type": "array",
            "description": "Links on wildberries.ru to a category (/catalog/...), a search, a seller's shop with the seller ID (/seller/12345) or a brand (/brands/...). A category is analyzed as the site's own search for it; a shop or a brand — by its own product list, to size up a competitor. Filters in the link are not applied.<br><br>Ссылки на wildberries.ru: на категорию (/catalog/...), поиск, магазин продавца с номером (/seller/12345) или бренд (/brands/...). Категория разбирается как собственный поиск сайта по ней; магазин или бренд — по их собственному списку товаров, чтобы оценить конкурента. Фильтры из ссылки не применяются.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "depth_pages": {
            "title": "Search pages per niche · Страниц выдачи на нишу",
            "minimum": 1,
            "maximum": 3,
            "type": "integer",
            "description": "How many first pages of the results to analyze, 100 products each. The summary is over these products; the total product count and the number of sellers are for the whole results.<br><br>Сколько первых страниц выдачи разбирать, по 100 товаров. Сводка — по этим товарам; общее число товаров и продавцов — по всей выдаче.",
            "default": 3
          },
          "region": {
            "title": "Delivery region · Регион доставки",
            "enum": [
              "moscow",
              "saint_petersburg",
              "novosibirsk",
              "vladivostok"
            ],
            "type": "string",
            "description": "Search results, prices and stock depend on the delivery region.<br><br>Выдача, цены и наличие зависят от региона доставки.",
            "default": "moscow"
          },
          "dest": {
            "title": "Own region code · Свой код региона",
            "type": "integer",
            "description": "Optional. The site's dest code for another delivery zone; replaces the region above.<br><br>Необязательно. Код dest сайта для другой зоны доставки; заменяет регион выше."
          },
          "history_store": {
            "title": "History store · Хранилище истории",
            "type": "string",
            "description": "Named key-value store in your account with the summaries of earlier runs: the run compares every niche with the last run that used the same store. It keeps only the product count, the seller count, the median price, the number of analyzed pages and the date. A niche not checked for 90 days is forgotten.<br><br>Именованное хранилище в вашем аккаунте со сводками прошлых запусков: запуск сравнивает каждую нишу с прошлым запуском с тем же хранилищем. Там только число товаров, продавцов, медиана цены, число разобранных страниц и дата. Ниша, которую 90 дней не проверяли, забывается.",
            "default": "wildberries-niche-history"
          },
          "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}