{
  "openapi": "3.0.1",
  "info": {
    "title": "Wildberries Keyword Scraper · Ключевые слова Wildberries",
    "description": "Search keywords Wildberries suggests to buyers: search box suggestions and related searches for your seed words, two levels deep. Ключевые слова, которые Wildberries подсказывает покупателям: подсказки строки поиска и связанные запросы, на две ступени вглубь.",
    "version": "0.1",
    "x-build-id": "HYv0YOCiyuBjH5dcW"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/theshark~wildberries-keyword-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-theshark-wildberries-keyword-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-keyword-scraper/runs": {
      "post": {
        "operationId": "runs-sync-theshark-wildberries-keyword-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-keyword-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-theshark-wildberries-keyword-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": [
          "queries"
        ],
        "properties": {
          "queries": {
            "title": "Seed words · Слова-затравки",
            "type": "array",
            "description": "Words or phrases as a buyer starts typing them on the site, up to 100. For every one the run collects what the site suggests.<br><br>Слова или фразы — как покупатель начинает их набирать на сайте, до 100. К каждому запуск собирает, что подсказывает сайт.",
            "items": {
              "type": "string"
            }
          },
          "depth": {
            "title": "Depth · Глубина",
            "minimum": 1,
            "maximum": 2,
            "type": "integer",
            "description": "1: keywords for your seed words. 2: also keywords for every keyword found at depth 1, one more request each: in our check 11 keywords became 94.<br><br>1 — запросы к вашим словам. 2 — ещё и к каждому запросу глубины 1, по запросу на каждый: в нашей проверке 11 запросов стали 94.",
            "default": 1
          },
          "with_related": {
            "title": "Related searches · Связанные запросы",
            "type": "boolean",
            "description": "Besides the search box suggestions, take the related searches the site shows on the search page. The site needs the product count of the search for them, so each expanded keyword costs one more search page of traffic and time.<br><br>Кроме подсказок строки поиска — связанные запросы со страницы поиска. Сайт просит их с числом товаров выдачи, поэтому каждый расширяемый запрос стоит ещё одной страницы выдачи: трафика и времени.",
            "default": true
          },
          "with_product_count": {
            "title": "Product count for every keyword · Число товаров по каждому запросу",
            "type": "boolean",
            "description": "Number of products the site finds for each keyword: one search page per keyword, so these rows have their own, higher price.<br><br>Сколько товаров сайт находит по каждому запросу: страница выдачи на запрос, поэтому у таких строк своя, более высокая цена.",
            "default": false
          },
          "region": {
            "title": "Delivery region · Регион доставки",
            "enum": [
              "moscow",
              "saint_petersburg",
              "novosibirsk",
              "vladivostok"
            ],
            "type": "string",
            "description": "Related searches and product counts are taken for this delivery region; the search box suggestions do not depend on it.<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 сайта для другой зоны доставки; заменяет регион выше."
          },
          "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}